ModTheSpire SpirePatch深度详解30秒为杀戮尖塔写出第一个Prefix/Postfix补丁【免费下载链接】ModTheSpireExternal mod loader for Slay The Spire项目地址: https://gitcode.com/gh_mirrors/mo/ModTheSpireModTheSpire是《杀戮尖塔》Slay the Spire的外部 MOD 加载器而SpirePatch是其中最强的补丁注入注解——只需几行代码就能在游戏的任意方法执行前后插入自定义逻辑完全无需修改原版游戏文件。本文带你彻底搞懂 SpirePatch并在 30 秒内写出你的第一个 Prefix / Postfix 补丁。一、为什么每个 MOD 都需要 SpirePatchModTheSpire 的核心理念是游戏原文件一个字节都不动所有修改都在内存中通过字节码补丁完成相关实现见 Patcher.java。在这个体系里补丁注解就是 MOD 开发者的万金油工具SpirePatch类级注解声明我要给哪个类的哪个方法打补丁SpirePrefixPatch方法级注解标记一个方法在原方法执行前运行SpirePostfixPatch方法级注解标记一个方法在原方法执行后运行三个注解的定义都非常精简可以亲自查看源码感受它的设计SpirePatch.javaSpirePrefixPatch.javaSpirePostfixPatch.java启动时Patcher 会扫描 MOD 中所有带补丁注解的类按 Patcher.java 中的逻辑识别出 Prefix 和 Postfix 方法再把它们织入目标方法。 除了这两个还有SpirePatch2支持更复杂的定位器 Locator当你需要按第 N 个匹配位置精确插入代码时它就派上用场了源码见 SpirePatch2.java。二、30 秒上手写出第一个补丁第 1 步准备开发环境需要JDK 8和Maven仓库自带 Maven 包装器 mvnw也可以直接用它。如果要在本地研究 ModTheSpire 源码先克隆仓库git clone https://gitcode.com/gh_mirrors/mo/ModTheSpire第 2 步准备 MOD 描述文件每个 MOD 的 JAR 内都需要一份ModTheSpire.json用来声明 MOD 的 ID、名称、版本和作者等信息字段定义可以参考 ModInfo.java{ modid: myfirstpatch, name: 我的第一个补丁, version: 1.0.0, author_list: [You], description: 一个 SpirePatch 入门示例 }第 3 步写补丁类核心就这一个文件假设你想在玩家选择奖励卡片的方法执行前、后各打印一条日志补丁类就是这样import com.evacipated.cardcrawl.modthespire.lib.*; public class RewardExample { SpirePatch( clz AbstractDungeon.class, // 目标类 method getRewardCard // 目标方法 ) public static class HookRewardCard { SpirePrefixPatch public static void Prefix() { System.out.println(奖励卡片即将生成); } SpirePostfixPatch public static void Postfix() { System.out.println(奖励卡片已生成完毕); } } }就这么简单——一个类级SpirePatch锁定目标两个方法分别标注SpirePrefixPatch和SpirePostfixPatch补丁就完成了。✅第 4 步打包并放入 mods 目录mvnw package把生成的 JAR 放进游戏的mods目录目录结构说明见 README.md运行 MTS.cmdWindows或 MTS.shLinux在启动器中勾选你的 MOD点击 Play打开控制台就能看到你插入的日志输出了。三、SpirePatch 属性速查表SpirePatch支持以下属性日常开发基本只用前 4 个属性作用常用场景clz目标类Class 类型首选编译器能帮你查错cls目标类字符串不想引用某个类时用method目标方法名必填paramtypez目标方法参数类型数组同名方法重载时区分paramtypes参数类型字符串形式与paramtypez二选一requiredModId依赖的其他 MOD ID给别人的 MOD 打补丁时必填optional补丁目标缺失时是否跳过兼容性处理两个小技巧同名注解可以叠加SpirePatch标记了Repeatable(SpirePatches.class)见 SpirePatches.java一个类上可以同时写多个SpirePatch。补丁方法里可以拿到参数Prefix/Postfix 方法的实参会自动绑定到原方法的对应参数需要修改原方法的局部变量时参数声明成ByRefT类型即可封装类见 ByRef.java。四、新手最容易踩的 3 个坑 ⚠️补丁方法必须是 static非静态补丁方法会在启动时直接抛出NonStaticPatchMethodException报错文案在 NonStaticPatchMethodException.java。参数类型要对得上原方法有参数而你的 Prefix/Postfix 方法参数签名不匹配时会报参数类型缺失MissingParamTypesException.java按报错提示补齐参数即可。别用反射猜方法名method属性填错一个字母补丁就会静默失败建议直接复制反编译工具里的签名或优先用paramtypez精确锁定重载。 补丁加载的完整链路Loader读取 mods 目录 →Patcher扫描注解生成PatchInfoPatchInfo.java→ 用 Javassist 织入字节码。遇到加载问题按这条链排查效率最高。五、写在最后一个SpirePatch 一个SpirePrefixPatch就能完成方法执行前插入逻辑的最小闭环30 秒完全可以做到想深入细节lib 目录 下还有SpireField、SpireReturn等 10 多个补丁注解等你探索每次版本变化记录都写在 CHANGELOG.md 里升级 MOD 时看一眼能少走很多弯路。从会装 MOD到会写 MOD只差一个 SpirePatch 的距离。现在就动手让你的第一个杀戮尖塔补丁跑起来吧【免费下载链接】ModTheSpireExternal mod loader for Slay The Spire项目地址: https://gitcode.com/gh_mirrors/mo/ModTheSpire创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
让 chardet4cj 检测得更快：置信度阈值与提前终止的性能优化策略 让 chardet4cj 检测得更快：置信度阈值与提前终止的性能优化策略 【免费下载链接】chardet4cj 一个用于检测常用文本编码的库 项目地址: https://gitcode.com/Cangjie-TPC/chardet4cj
chardet4cj 是一个字符编码高效识别检测库，支持 UTF-8、UTF-16… · 2026/9/27 0:58:28
指纹芯片选型实战指南：从参数陷阱到生物信任构建 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:17:59
Echo Loop长难句意群划分指南：AI如何把一句英语切块，让精听难度骤降 Echo Loop长难句意群划分指南：AI如何把一句英语切块，让精听难度骤降 【免费下载链接】Echo-Loop Echo Loop 是一款科学、高效的 AI 英语听说训练 App，通过精听、跟读、盲听、复述和间隔复习，自动驱动学习者把每一段音频真正练懂、… · 2026/9/27 0:59:16
cannbot-knowledge安装与使用10大常见问题：新手必看FAQ排查清单 cannbot-knowledge安装与使用10大常见问题：新手必看FAQ排查清单 【免费下载链接】cannbot-knowledge cannbot算子开发知识库插件依赖的知识库本体仓，给cannbot提供统一的知识底座。 项目地址: https://gitcode.com/cann/cannbot-knowledge
cannbo… · 2026/9/27 0:59:16
绑定网站域名怎么做才不踩坑？老手教你怎么选 绑定网站域名怎么做才不踩坑？老手教你怎么选 模板网站千篇一律，客户看腻了，转化率更是惨不忍睹。你是不是也头疼，明明代码没问题，但域名绑定这一环总出岔子？别急，今天不聊虚的，直接拆解 绑定网站域名怎么做 的完整链路，重点讲讲 怎么选… · 2026/9/27 0:59:10
一次讲透Java多态：方法重写、重载、接口与抽象类 1. 四个概念为何总被放进同一道Java面试题我在给团队做代码评审和面试复盘时，发现一个很有意思的现象：很多候选人单独问“方法重写是什么”“接口和抽象类有什么区别”都能答出几句，但一旦把方法重写、重载、接口、抽象类这四样东西放到同一个… · 2026/9/27 0:58:57
避开建站坑：5步对比评测网站建设类公司排名 避开建站坑：5步对比评测网站建设类公司排名 找建站公司最怕什么？不是功能不够多，而是报价不透明，最后被高价收割。很多老板在前期对比评测时只看价格，忽略了技术底子和售后响应，结果网站上线慢、排名差、维护费像无底洞。… · 2026/9/27 0:58:57
3招解决wordpress登录两次难题，看懂建站报价避坑指南 3招解决wordpress登录两次难题，看懂建站报价避坑指南 网站被黑挂马不知道怎么办？别慌，先检查你的WordPress后台。很多站长发现，明明输对账号密码，却被迫重复登录两次，甚至直接跳转首页。这不仅是体验问题，更是安全漏洞的警报。很多… · 2026/9/27 0:58:44
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
