资源
资源集合
文档站提供的全部资源一览:可下载的开发资源与文档页面,附用途说明与跳转
本页汇总文档站提供的全部资源:可下载的开发资源与文档页面。每个资源都标明用途,并给出对应的详细文档跳转,方便按需取用。
可下载资源
| 资源文件 | 用途 | 对应文档 |
|---|---|---|
| mod-api-3.2.jar | 模组 API 编译依赖(mod-api 3.2,独立 Maven 模块,仅含 com.seecmd.mod.api.* 及其子包)。模组编译期唯一需要引用的宿主产物,运行期由游戏宿主提供 | 教程 · 序章 / API 参考 |
| mods-template.zip | 模组起步模板工程(内含 mod-api-3.2.jar、gson、build.bat、pom.xml、README.md 与可直接运行的示例入口 ExampleMod),解压即用,一键构建 | 教程 · 序章 / 快速上手 |
两个文件由文档站直接提供下载(与本页同域)。模板 zip 已内置
mod-apijar,解压后无需任何安装步骤即可构建第一个模组。
文档页面
| 页面 | 内容 | 适用读者 |
|---|---|---|
| 快速上手 | 从零开始:创建项目 → 编写最小模组 → 打包 → 加载到游戏 | 想尽快跑通第一个模组的开发者 |
| 教程目录 | 7 篇任务式教程:环境 → 第一个模组 → HUD → 打击特效 → 判定等级 → 音符类型 → 游戏模式,每篇含完整代码与检查点 | 第一次写模组的开发者 |
| 开发指南 | 分 12 篇的主题参考:环境搭建 → 生命周期 → 注册内容 → 事件 → 资源 → 渲染 → 能力接口 → 打包发布 | 需要系统性查阅机制的第三方开发者 |
| API 参考 | com.seecmd.mod.api 总览(版本策略、迁移对照、常见报错);每个类型一页,逐方法签名、行为与示例 | 写代码时查阅签名的开发者 |
| 架构设计 | 模组系统的分层结构与核心抽象(面向开发者的公开版) | 想理解模组系统工作原理的开发者 |
| 资源制作指南 | 音符皮肤(图片 / 字符)等自定义资源的制作方法,多数无需编程 | 不想写代码、只做资源内容的玩家 |
| THS 简易语言 | 用简单脚本做出游戏模组,无需 Java 基础 | 零基础入门用户 |
| 制谱器使用指南 | Theseus Chart Editor 全流程操作:三种编辑模式、快捷键总表、多标签页与常见问题 | 想制作谱面的制谱人 |
| 制谱器开发文档 | 谱面 JSON 结构规范(notes / _extra.json / extensions)+ 编辑器插件系统 API 与示例 | 手写谱面或为模组配套编辑器插件的开发者 |
mod-migration-1.0.md(仓库内文档) | 从 0.7.x 旧 API 迁移到 1.0 的逐项对照表与改写示例 | 已有 0.7.x 模组、需要迁移到 1.0 的开发者 |
推荐路径
- 会写 Java:下载
mods-template模板 → 按 教程 · 序章 解压配置 → 双击build.bat→ 把 jar 放入游戏mods/。 - 不会写 Java:直接看 THS 简易语言,用脚本就能做出滤镜 / HUD / 特效。
- 只想做资源:看 资源制作指南,放好文件即可被游戏识别。
版本说明
当前 API 版本为 3.2;com.seecmd.mod.api.* 的公共签名在当前 major 线内只增不破,破坏性变更随 3.0 发生——旋转 pivot 模式枚举与 setLaneZ/setFakeTrackZ 等 2D 几何残留参数删除,逐项对照见 API 参考 · 2.x → 3.0 迁移对照。2.0 的破坏性变更(NoteTypeDefinition 旗标 → 语义标记子接口)见更新日志;1.0 是对 0.7.x 的破坏性重制,旧 0.7.x 模组需按 mod-migration-1.0.md 逐项改写后重新编译;版本更新时,本页将同步更新下载链接与文档跳转。