ModTheSpire5分钟装好《杀戮尖塔》模组加载器并跑通首次启动【免费下载链接】ModTheSpireExternal mod loader for Slay The Spire项目地址: https://gitcode.com/gh_mirrors/mo/ModTheSpireModTheSpire下称 MTS是《杀戮尖塔》的外部模组加载器模组以 JAR 形式放进 mods 文件夹由它在启动游戏时统一加载和注入游戏本体文件一个字节都不会被改动。本文带你完成安装、加载第一个模组并告诉你出问题后该去哪里看。它解决什么问题适合谁它的做法是接管游戏启动流程扫描 mods 目录里每个 JAR用 Javassist 在运行时改写需要的游戏类再拉起游戏本体 desktop-1.0.jar。因为原始 jar 始终干净把 mods 文件夹删掉就能完全恢复原样。适合想加新角色、新卡牌、新遗物但不想手动改游戏文件的玩家如果你只是调调数值参数直接改游戏配置可能更省事。安装前检查这几项MTS 是个 Java 程序环境要求不高项目最低推荐系统Win7 / macOS 10.12 / Ubuntu 14Win10 / 较新的 LinuxJavaJava 8Java 11游戏能定位到 desktop-1.0.jar 的安装v2.0磁盘约 500MB1GB一个容易踩坑的细节MTS 必须在能找到游戏 jar的目录里运行。Steam 版会自动搜索安装位置非 Steam 版则要求 MTS 文件就放在 desktop-1.0.jar 旁边macOS 在 SlayTheSpire.app/Contents/Resources/ 内。这段查找逻辑见源码 Loader.java。安装步骤从零到能启动克隆项目源码git clone https://gitcode.com/gh_mirrors/mo/ModTheSpire在项目根目录构建发行版 jar自带 mvnw 包装器无需单独装 Maven./mvnw clean package把生成的 ModTheSpire.jar 复制到游戏安装目录与 desktop-1.0.jar 同级。把启动脚本复制到同一目录Windows 拷 MTS.cmdLinux/macOS 拷 MTS.sh 并给它加执行权限chmod x。脚本本质上只是一句java -jar ModTheSpire.jar指向内置的 JRE。在同级目录新建 mods 文件夹。模组 jar 直接放在它的根目录下不要套子目录。首次启动勾选第一个模组并 Play双击 MTS.cmd或执行 ./MTS.sh弹出模组选择窗口。布局很简单左侧列表mods 里每个模组占一行勾选状态就是本次是否加载行的先后顺序即加载顺序可以用上下按钮调整。右侧信息区显示选中模组的作者、版本、依赖列表和描述。底部 Play 按钮确认无误后点它进游戏。把第一个简单模组的 jar 丢进 mods回到窗口勾选它点 Play。看到游戏主菜单就算跑通了。此后 MTS 会把你勾选的组合存到同目录的 ModTheSpire.cfg 里下次直接沿用。每个模组 jar 内的 manifest 带一段 mts_modinfo JSONmodid、name、version、dependencies 等字段都从这里解析具体见 ModInfo.java。如果 modid 缺失或和别的模组重复MTS 会直接抛 MissingModIDException 或 DuplicateModIDException——这是模组不显示在列表里最常见的原因先看报错文本再怀疑文件放错位置。两个值得了解的机制补丁如何生效模组不复制游戏类而是用 SpirePatch 系列注解把方法挂钩到游戏原方法的前、后或替换掉。MTS 自己也用这套机制挂了个崩溃保护在游戏 ExceptionHandler.handleException 前插一段 Prefix 来留存异常现场见 CatchCrash.java。崩溃报告出现未捕获异常时MTS 会写出包含调用栈和当前加载模组列表的日志文件求助时直接把这个文件发出去即可。实战场景多模组跑不起来怎么办装了几个模组后最常见的情况是单独能用、合用就崩按这个顺序查先看选择窗口里的顺序框架类模组如 BaseMod放最前纯内容模组放后面。看依赖modid 被写进别的模组 dependencies 字段说明它是硬依赖列表里没有对应条目就得先补装。二分定位只勾一半模组 Play崩了就在那一半里继续对半拆几轮就能锁定肇事者。比对版本模组 jar 里的 MTS_Version 字段声明了要求的加载器版本太旧就先升级 ModTheSpire.jar 本身。 如果两个模组互斥交换它们的加载顺序试一次错误栈里反复出现同一个游戏类名基本可以确定是两者抢同一个注入点。启动闪退速查表症状常见原因处理方法窗口一闪而过Java 版本过旧或未走系统 PATH用 Java 8 直接跑 jar或改用发行版内置 JRE提示找不到 desktop-1.0.jarMTS 文件没和游戏 jar 同目录把 ModTheSpire.jar 与 MTS 脚本一起挪到游戏目录列表里不显示模组缺 modid / 重复 modid / 没放 mods 根目录对照日志报错逐条排查某模组一进游戏就崩依赖缺失或 MTS 版本过低二分定位后按第 2、4 步处理❓ 想看更细的输出启动时加 --debug补丁每一步都会打印出来。常用启动参数以下参数都追加在 java 命令后面即可对应读取逻辑同样在 Loader.java参数作用--skip-launcher跳过选择窗口按上次保存的状态直接进游戏--mods id1,id2只加载指定 modid 的模组隐含跳过选择窗口--debug输出补丁过程的详细日志--out-jar生成打完补丁的游戏 jar适合分发--allow-beta允许连接游戏测试服--profile 名称使用指定的保存档组合这些开关也能以同名键值写进 ModTheSpire.cfg长期使用更方便。写在最后整个流程其实就四步jar 丢进 mods、勾选、Play、出问题看日志。想自己动手写模组的话核心 API 是 lib/ 目录下的 SpirePatch、SpireField、SpireInitializer 注解各版本的更新内容可以在 CHANGELOG.md 里查。【免费下载链接】ModTheSpireExternal mod loader for Slay The Spire项目地址: https://gitcode.com/gh_mirrors/mo/ModTheSpire创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考