选择基础库
如果你要制作一个人物mod,选择一个基础库可以减少你的patch数量并减轻你的工作。同时也可以提高和其他mod的兼容性。
目前(工坊未开放之前)常用的基础库有BaseLib和RitsuLib两个。
可前往对应分类查看。
对比
以下表格为这些基础库目前为止(2026.05.07)支持的功能表格。
| 功能 | BaseLib | RitsuLib | 说明 |
|---|---|---|---|
| 配置选项 | ✅ | ✅ | RitsuLib功能丰富且支持镜像BaseLib配置 |
| 自动注册 | ✅ | ✅ | - |
| 自定义素材路径 | ✅ | ✅ | - |
| 可使用原版素材(placeholder) | ✅ | ✅ | - |
| dynamicvar的提示文本 | ✅ | ✅ | - |
| 添加人物 | ✅ | ✅ | - |
| 关键词注册 | ✅ | ✅ | - |
| 血条覆盖层(中毒灾厄) | ✅ | ✅ | - |
| 不挂载脚本场景转换 | ✅ | ✅ | - |
| 人物非spine动画兼容 | ✅ | ✅ | - |
| 新牌堆 | ✅ | ✅ | ritsulib更完善 |
| 缺少资源时占位警告 | ✅ | ✅ | - |
| 卡牌支持AnyPlayer | ✅ | ✅ | - |
| customenum | ✅ | ❌ | baselib支持对任意enum扩展; ritsulib不支持,但统一管理(例如关键词) |
| 一代本地化符号 | ✅ | ❌ | - |
| FMOD音频 | ❌ | ✅ | baselib使用godot原生音频播放; ritsulib支持fmod |
| 诊断调试工具 | 🚧 | ✅ | 导出卡牌图片、patch dump等 |
| 时间线注册 | ❌ | ✅ | 游戏时间线小故事 |
| 事件管线 | ❌ | ✅ | 订阅事件,触发时调用 |
| 手牌发光管理 | ❌ | ✅ | - |
| 快捷键绑定 | ❌ | ✅ | - |
| 能力额外数字展示 | ❌ | ✅ | - |
| 动画状态机 | ❌ | ✅ | baselib可接受原版动画名, 但不能自定义 |
| 网络 | custommessage | 侧载网络管理 | - |
| 内容物ID | 命名空间第一段大写, 例如 TEST-TEST_CARD |
modid与分类, 例如 TEST_CARD_TEST_CARD |
- |
| patch | 原始harmony |
原始harmony以及封装patch系统 |
- |
| 非原生玩法内容 | 有 | 无 | - |
重要说明
如果你不添加任何游戏内容,不需要基础库也可以。但是如果你制作人物mod等,最好使用一个基础库减少工作量并提高兼容性。
目前baselib的教程已相对完善,但是baselib开发相对缓慢(
并且添加了非原版内容)。ritsulib的教程正在编写中。