Theseus 模组文档
资源

资源集合

文档站提供的全部资源一览:可下载的开发资源与文档页面,附用途说明与跳转


本页汇总文档站提供的全部资源:可下载的开发资源与文档页面。每个资源都标明用途,并给出对应的详细文档跳转,方便按需取用。

可下载资源

资源文件用途对应文档
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-api jar,解压后无需任何安装步骤即可构建第一个模组。

文档页面

页面内容适用读者
快速上手从零开始:创建项目 → 编写最小模组 → 打包 → 加载到游戏想尽快跑通第一个模组的开发者
教程目录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 的开发者

推荐路径

版本说明

当前 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 逐项改写后重新编译;版本更新时,本页将同步更新下载链接与文档跳转。