Repository navigation
Releases
支持26.1+的新版本了!(*^▽^*)
V2.2.0 — 许可证更换,Fabric / NeoForge 26.2 与 26.3 支持
补齐了 26.2 / 26.3 的三个版本档,Paper 历史档的适用性核对改成机器生成。
平台版本档从 58 到 61(Fabric 26.2、NeoForge 26.2、NeoForge 26.3)。
完整技术明细见 mcp-server/CHANGELOG.md。
✨ 本次亮点
- Fabric 26.2 完整档。
11 条规则、脚手架(构建已验证)、26.2 文档语料一起补齐。 - NeoForge 26.2 / 26.3 两档。
规则、脚手架、Gradle wrapper 都有了;26.3 的 datagen 与 GUI 文档按新版本细化。 - Paper 历史档的适用性核对可机读了。
5 档生成applicability.json,00-applicability.md由脚本重写,成员是否存在、类是否缺失、枚举常量都逐条核。
📜 许可证变更
- 为了维护MC社区的环境,我们更改了许可证(见到倒卖的请及时反馈)
- 代码:PolyForm Noncommercial 1.0.0 + 仓库作者附加的 Copyleft 条款。
- 允许非商业目的使用、修改、分发;分发要带
Required Notice、维护者行与仓库链接。 - 衍生作品必须整体按同一许可发布,并附完整对应源码。通过网络提供服务也算分发,需要在服务里给出源码获取入口。
- 不得追加更严条款,也不得改挂闭源或其它非商业许可。
data/语料与THIRD_PARTY_NOTICES.md里记录的 MIT / Apache-2.0 / CC0 / CC BY-SA 部分不受影响,仍按原条款。- 用本软件做出来的模组文件不算衍生作品。
- 贡献者条款同步落地:提交即授权,著作权不转移;贡献会被登记到
THIRD_PARTY_NOTICES.md的贡献者一节,并保留贡献者把自己那部分用于任何项目的永久许可。 mcp-server/package.json的license字段从MIT改为SEE LICENSE IN LICENSE。
🧩 平台与版本支持
Fabric
- 新增
fabric/26.2:11 条规则、scaffold(构建已验证)、knowledge,外加data/fabric_26.2的文档与 reference 语料。 - 新增
data/fabric_porting/26.3.md:Fabric 26.3 的博客级迁移摘要。上游 docs 的 26.3 移植 PR 仍是 Open,versions/26.3不存在,所以这页只能当「改了什么」的清单,不能当类签名出处。里面记了被删的 Fabric API(如CompostingChanceRegistry、FuelRegistry)和官方模板的真值。
NeoForge
- 新增
neoforge/26.2与neoforge/26.3:各 11 条规则、脚手架、gradlew/gradlew.bat/settings.gradle与示例 mod。 - 26.3 的 datagen 与 GUI 规则按新版本文档细化;26.2 的脚手架尚未完成构建验证,
pack.meta.json里buildVerified为 false。
服务端(Paper)
- 5 个历史档(1.12.2 / 1.16.5 / 1.20.1 / 1.21.1 / 1.21.4)各生成一份
applicability.json,记录 26.3 规则中的指针在本版是否还能解析:签名指针、成员仍在、类缺失、成员缺失、无法判定分别计数。 00-applicability.md改为脚本生成,行号与判定结果跟着数据走;1.12.2 的成员状态和计数做了修正。
🛠️ 工具链与文档
- 更正了两种发行形态的数据面说明:npm 包自带一份小数据(
mdk-checksums.json、各 pin 表、loader-api 摘要等 7 项),GitHub Release 的mcp-server-*.zip只打dist/与元数据,平台语料两种包都不含,要从mc-skill-data-full-*.zip取。
🔐 稳定性
- 新增
assert-scaffold-pin-claims:文档里写的 Gradle / loader / MC 版本必须与scaffold/gradle.properties的实际值一致,防止示例和脚手架对不上。 - 抽了一个共享的
javac定位器,反编译与自检脚本用同一套 JDK 探测。
⚠️ 升级注意
- 之前按 MIT 使用的人如果拿它做商业项目,换版后不再被允许;已经在用的旧版本不受影响。作者禁止任何商业行为,如要做商业项目,请继续使用 V2.1.0 及之前的版本。
- 衍生作品必须同许可开源并提供源码;只发二进制或混淆产物不合规。
- Fabric 26.3 目前只有迁移摘要,没有规则树也没有 docs 正文。
data/现在 83,477 个文件、2.38 GiB;npm 包只带其中很小一部分,平台语料仍要单独下载。- 运行环境:Node.js >= 22.5,22.5–22.12 与 23.0–23.3 跑检索类工具需要
--experimental-sqlite。
完整技术明细见 mcp-server/CHANGELOG.md。
Full Changelog: V2.1.0...V2.2.0
MC-AI-Coding-Assistant-Tool是全部的文件;
MC-AI-Coding-Assistant-Tool_base是骨干文件;
data是各个平台的映射文件(必要,下载后可以删除你不需要的部分)
剩下的为有关知识库
新版本!ヽ( ̄▽ ̄)ノ
V2.1.0 — Paper/Spigot 服务端上线,编排技能与工具链更新
V2.0.0 之后的第一次更新。这次把服务端(Paper / Spigot)做成了独立的一条支持线,补了 12 个编排技能,并把游玩自测扩展到了服务端和多客户端。
工具总数从 V2.0.0 的 86 个增至 89 个,工作流模板从 49 个增至 61 个。
完整技术明细见 mcp-server/CHANGELOG.md。
✨ 本次亮点
- 现在可以写 Paper / Spigot 插件了。
新增服务端语料 13 档、规则树 6 档、插件骨架生成器和服端自测驱动;Paper 与 Spigot 各自跑通了起服、命令、断言、证据。 - 12 个编排技能上线。
需求拷问、规格、拆片、评审、复盘、交接、路由、人工步骤向导、带出处调查、术语表、重讲、设计原型。 - 游玩自测补上服务端和多客户端。
两边共用同一套证据,多客户端可以一起判绿;客户端动作在服务端会被判红,不会悄悄跳过。 - 新增第 9 个宿主:dsh(DeepSeek Harness)。
另带一个原生插件dsh-mc-skill,按当前工程自动定档,只挂该档技能并注入底座规则。
🖥️ 服务端面:Paper / Spigot(新能力)
Paper / Spigot 插件和模组是两套东西:跑 runServer,入口是 plugin.yml 和 onEnable,写 Bukkit API,不碰 net.minecraft.*。所以它单独开了一条线,没有塞进原来的 8 个平台。
- Spigot 8 档:1.12.2 / 1.16.5 / 1.19.4 / 1.20.1 / 1.20.6 / 1.21.1 / 1.21.4 / 1.21.8,从真实构件
javap抽取。 - Paper 5 档:1.12.2 / 1.16.5 / 1.20.1 / 1.21.1 / 1.21.4,从官方 javadoc 抽取。
- 规则:
paper/26.3/rules是 10 条正文(事件、命令、物品栏 GUI、权限、调度器、plugin.yml 与配置、PDC、Adventure、陷阱);其余 5 档各一份00-applicability.md,只核对这 10 条在该版是否成立。 - 新增
generate_paper_plugin:生成插件工程骨架。 - 新增
generate_playtest_server_driver:生成服端自测驱动,支持wait/mark/stop/touch/waitfile/cmd/assert。
真机读数:
- Paper 1.21.4 / 1.21.1 / 1.20.1 / 1.16.5 各 8/8 步,1.12.2 为 5/5(该版不认
--nogui,控制台命令那条不适用)。 - 纯 Spigot 1.21.8 / 1.20.6 / 1.19.4 各 8/8。
还抓到一条真实差异:ItemMeta#setDamageType 只在 paper-api 上存在,纯 Spigot 服调用会 NoSuchMethodError。
🧭 编排技能(新能力)
- 技能:
mc-grill、mc-spec、mc-breakdown、mc-review、mc-retro、mc-handoff、mc-router、mc-wizard、mc-research、mc-glossary、mc-waitwhat、mc-prototype。 - 每个技能都有三种取法:
common_skill/<name>/SKILL.md源稿、get_workflow_template、mcskill://skill/<name>。 - 新增两个交付相关文件:
REPORT-FORMAT.md(交付表单)与DELIVERY_LOG.md(每轮底稿)。
🧪 游玩自测
- 服务端驱动与客户端驱动共用同一套证据:
state.json/exit-code.txt/qa.log/rounds.jsonl。 - 新增
inspect_playtest_multi:多客户端联合判读,逐个检查退出码、状态、日志和会合标记。 - 作业规则补充「进场 pin、出场 lease」:判绿前确认锚点没被动过。
- 新增文档:
doc/playtest-loops.md、doc/playtest-ladder.md、doc/playtest-dimensions.md。
🧩 平台与版本支持
Rift
- 新增
rift/1.13原生档。 rift/1.13.2首次真构建通过,客户端能启动。- 但 1.13.2 上 21 个 hook 全部 target not found,listener 不会派发,
ClientTickable#clientTick()实际不会被调用。官方只支持 1.13,1.13.2 属于能启动但功能不完整。
Fabric
- Datagen 新增 Yarn 骨架,并兼容 Mojmap 与 Yarn 两套映射。
- 配套文档:
mcp-server/docs/yarn-to-mojmap-datagen.md。
LiteLoader
- 三档
api-surface.md改为直接读构件:1.12.2 = 73 类 / 249 签名,1.10.2 = 72 / 230,1.8.9 = 70 / 209。 - MCP 可读性判定改为比例判据,1.10.2 从误判的
mcp修正为mixed-or-obfuscated。
其余
- Forge 16 档、NeoForge 10 档、Quilt 10 档、ModLoader 3 档、基岩扁平,档位不变,改动在纠错与工具链。
🛠️ 工具链与 CLI
- 新增 3 个工具:
generate_paper_plugin、generate_playtest_server_driver、inspect_playtest_multi。 generate_*仍然只吐文本,写盘需要显式确认。- 失败分两态:
generation_failed(版本或平台不支持)与write_blocked(缺确认或沙箱拒绝),两者不要混读。
🔐 安全与稳定性
- 反编译的 remap 缓存键加入 MC 版本与构件内容身份,避免同名同版本的不同构建复用错误字节。
- 服端探针不代接受 EULA,只写授权沙箱;构件下载核对 sha256 与字节数。
- 生成器写盘仍是默认 dry-run。
📚 知识库内容纠错
Forge
- 修正 1.7.10 至 1.12.2 六档的 API 索引:成员原先全部挂到最后一个类,表现为非空类只有一个、方法清单为空。重建后
query_api能正常返回方法
LiteLoader
- 修正 1.10.2 的映射层误判。
Paper / Spigot
- 修正 Paper 1.12.2 语料的空壳问题
⚠️ 升级注意
- 运行环境要求:Node.js >= 22.5。22.5–22.12 与 23.0–23.3 跑检索类工具需要
--experimental-sqlite。 - npm 包只包含
mcp-server/代码;data/知识资产需从 GitHub Release 下载或自备,并用MC_SKILL_DATA指向。 - 服务端规则不走
activate_platform_pack session,用search_docs platform=paper|paper-api|spigot配合paper/<ver>/rules/。 - 服端驱动遇到客户端动作(
move/goto/break/gui/jump/look/shot/scan)会判红,这是设计。 generate_paper_plugin与generate_playtest_server_driver只出文本骨架,未编译未运行;真机读数来自独立的探针脚本。- Rift 1.13.2 只到「能启动」,不要用它验证功能。
- 新增根文件
REPORT-FORMAT.md与DELIVERY_LOG.md,原来AGENTS.md里的交付表单章节改到前者。
完整技术明细见 mcp-server/CHANGELOG.md。
Full Changelog: V2.0.0...V2.1.0
MC-AI-Coding-Assistant-Tool是全部的文件;
MC-AI-Coding-Assistant-Tool_base是骨干文件;
data是各个平台的映射文件(必要)
剩下的为有关知识库
超级无敌大更新
V2.0.0 — 游玩自测上线,知识库与工具链大更新
这是自 V1.0.4 以来最大的一次更新。
工具总数从 V1.0.4 的 54 个增至 86 个。
完整技术明细见 mcp-server/CHANGELOG.md。
✨ 本次亮点
- AI 现在可以真正进游戏跑测试了。
新增游玩自测工具链,支持三种路线:桥 mod、进程内测试驱动、意图会话。可以自动启动客户端、进入世界、找村庄、飞抵目标、扫描方块与实体、点击 GUI、执行命令、截图,并把证据落盘。 - 多平台真机覆盖大幅扩展。
Fabric、Forge、NeoForge、Quilt、LiteLoader、Rift、ModLoader、基岩的多个版本档补齐了脚手架、映射、构建验证与真机测试。 - 文档检索与知识库增强。
中文查询、语义召回、Quilt/NeoForge 兼容、基岩 Script API、code-patterns 全族可读、上游版本查询等一批能力上线。 - CLI 与工具链安全加固。
新增双入口、输入通道、超时/静默、错误码分类;修复反编译、MDK、下载、缓存、写盘的一批安全问题。
🧪 游玩自测(新能力)
- 新增
playtest_bridge:通过桥 mod 与运行中的游戏交互,读取玩家、背包、实体、聊天,执行命令、截图、等待条件。 - 新增
generate_playtest_driver:为支持的游戏版本生成进程内测试驱动,支持长驻会话、剧本热载、失败判红。 - 新增
inspect_playtest_evidence:读取测试证据(状态、日志、截图、调用记录),给出结论。 - 新增
playtest_intent:用意图驱动游戏内 AI 会话,例如“走到某处”“找方块/实体”“观察”“截图”“等待”。 - 新增工作流
mc-ingame-playtest:把“生成驱动 → 启动游戏 → 跑剧本 → 判读证据 → 撤除”串起来。
真机覆盖包括但不限于(1.12.2+ 都可以使用):
- Fabric 1.20.1 / 1.20.4 / 1.21.1 / 1.21.3 / 1.21.4 / 1.21.8 / 1.21.10 / 1.21.11 / 26.1.x
- Forge 1.12.2 / 1.13.2 / 1.14.4 / 1.15.2 / 1.16.5 / 1.17.1 / 1.18.2 / 1.19.4 / 1.20.1 / 1.20.4
- NeoForge 1.20.4 / 1.20.6 / 1.21.1 / 1.21.11 / 26.x
- Quilt 1.18.2 – 1.21.11
- LiteLoader 1.12.2、Rift 1.13.2
支持自动进世界、飞抵、扫描方块/实体、GUI 点击、命令回值解析、截图新鲜度校验、JSONL 证据单行契约。
🔎 文档检索与知识库
- 修复中文查询零命中:FTS5 增加 CJK bigram LIKE 回退,并改为 OR 召回优先。
- 修复语义召回被 L0 结果反向封顶:语义白名单改用该版 L0 全集。
- Quilt 同线回落、NeoForge 1.20.1 走 Forge 语料时显式透出兼容信息。
list_*_versions的 notes 改为磁盘实扫派生,不再手抄。VERSION_NOT_FOUND载荷四平台统一,机器消费方不再按平台分支取候选。- 基岩 Script API 独立成语料树;
search_bedrock_docs支持按调用limit,两树检索按 id 去重。 - Fabric
@[code …]转引真正展开,官方示例不再整段空块。 - code-patterns 全族进入知识资源面,MCP 侧注册从 5 增至 121。
- 新增
query_upstream_releases:查 Forge / NeoForge / Fabric / Quilt / Parchment / Modrinth 等上游版本与 build。 - 新增
analyze_bedrock_log、resolve_lib_skills。 - 过期语义索引告警与重建;modloader 三档补语义库。
🧩 平台与版本支持
Forge
- 补齐/修正 1.7.10 – 1.20.4 多档规则、映射、pack_format、FG/Gradle 速查。
- 修复 Forge 1.20.4 的 FML 49 dev mod 发现、合并块、loot 管线 ISE 等问题。
Fabric
- 1.14.4 – 1.21.11、26.1.x 多档脚手架与真机覆盖。
- 修复 loader 钉值、mixins 展开、物品注册模式、Java 8 库面、FLK 依赖地板。
NeoForge
- 1.20.1 兼容层、1.20.4、1.20.6、1.21.x、26.x。
- 修正插件 id、Java 版本、事件栈、ModDevGradle 版本。
Quilt
- 10 档脚手架入口点、Gradle wrapper、构建验证。
- 处理 QSL 停更与同线回落策略。
ModLoader
- 1.6.4 补骨架与 fail-closed 设计。
基岩
- min_engine_version 统一。
- Script API 语料拆树、体裁降权、成员计数与索引一致性增强。
🛠️ 工具链与 CLI
- CLI 双入口:
mc-skill:工具线,dispatch 全部工具。mc-skill-scripts:仓库线,提供lib/corpus/cloth/gate等子命令。
- 修复
-className、@展开、同名字段被全局 flag 抢占、--stdin-json、--quiet/--timeout、list-tools裁剪、错误码分类。 - 新增
--raw、--output-format、--stdin-json;--json不再作为通用承诺。 - 只读启动路径不再加载 update 链,
--version/--help更快。 - 修复 Windows 下
.bat/.cmd调用、EPIPE、sqlite 边界、MDK 解压残树、跨进程锁、Java 子进程回收。 generate_config支持library=cloth|yacl。- 库 API 摘要、社区知识资源面、代码模式库扩展。
🔐 安全与稳定性
- 映射缓存改为 TOFU(先验证再复用),mojmap 记录 sha256。
mdk-checksums.json原子写;zip 炸弹预算;spawn/exec 超时;mod-decompile 缓存锁与完成哨兵。- Mixin
@At INVOKEowner 校验、modId转义、描述符解析深度上限。 - 下载重定向白名单;
port_project拒绝知识库自身;pack manifest 原子 rename。 - 写盘漏斗扩围;脚本门禁过滤 gitignored 产物。
- Forge Javadoc 整树事故后增加四道防线:解析空不覆盖、HTTP 200 假 404 识别、批量拒覆盖、整版无正文率检查。
📚 知识库内容纠错
Forge / NeoForge
- 修正
AttachCapabilitiesEvent、RightClickBlock、LevelTickEvent、EntityJoinWorldEvent、mods.toml字段、TOML 示例、NeoForge 插件 id、Java 17/21 口径等。
Fabric / Quilt
- 修正 1.21.11 映射轴、
SwordItem/PickaxeItem等构造、pack_format、FG/Gradle、QSL EOL、空壳普查。
基岩
- 修正 min_engine_version、表格形状、Script API 成员计数。
⚠️ 升级注意
- 运行环境要求:Node.js >= 22.5。
- npm 包只包含
mcp-server/代码;data/知识资产需从 GitHub Release 下载或自备,并用MC_SKILL_DATA指向。 - 部分输出契约变化:
VERSION_NOT_FOUND载荷统一。- 检索结果增加
totalPool/truncated。 query_api/query_loader_api带兼容注释,并推荐优先使用语义搜索。
- 游玩自测不是零配置:需要授权目录、JDK 分线、准备世界;部分平台需要桥 mod 或 dev-only 依赖。
- 不要依赖
deprecated_legacy_passed,后续版本会删除。
完整技术明细见 mcp-server/CHANGELOG.md。
Full Changelog: V1.0.4...V2.0.0
MC-AI-Coding-Assistant-Tool是全部的文件;
MC-AI-Coding-Assistant-Tool_base是骨干文件;
data是各个平台的映射文件(必要)
剩下的为有关知识库