Skip to content

Releases

支持26.1+的新版本了!(*^▽^*)

Choose a tag to compare

@guguzea guguzea released this 31 Oct 05:35

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是各个平台的映射文件(必要,下载后可以删除你不需要的部分)
剩下的为有关知识库

新版本!ヽ( ̄▽ ̄)ノ

Choose a tag to compare

@guguzea guguzea released this 27 Oct 15:08

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是各个平台的映射文件(必要)
剩下的为有关知识库

超级无敌大更新

Choose a tag to compare

@guguzea guguzea released this 06 Oct 18:07
db44896

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 INVOKE owner 校验、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是各个平台的映射文件(必要)
剩下的为有关知识库

修复了一堆bug

Choose a tag to compare

@guguzea guguzea released this 11 Aug 00:00

现在支持26.1/26.1.2,without git包会小一些,但是更新可能出现问题;

修复了一个小bug

Choose a tag to compare

@guguzea guguzea released this 06 Aug 15:45

MC-AI-Coding-Assistant-Tool是全部的文件;
MC-AI-Coding-Assistant-Tool_base是骨干文件;
data是各个平台的映射文件(必要)
剩下的为有关知识库

现在可以拆分了!

Choose a tag to compare

@guguzea guguzea released this 06 Aug 12:15

添加了更多IDE支持,现在支持知识拆分下载(data还没有拆开,后面搞),只用下载你需要的部分!
MC-AI-Coding-Assistant-Tool是全部的文件;
MC-AI-Coding-Assistant-Tool_base是骨干文件;
data是各个平台的映射文件(必要)
剩下的为有关知识库

修复了一些bug

Choose a tag to compare

@guguzea guguzea released this 06 Aug 08:49

修复了agent查询时的命中问题,优化了引索,修复了一些数据问题,正在尝试将MCP数据和MCP结构分离,后面(也许是下一个版本)应该就可以根据需求分平台和版本下载了!

第一个发行版

Choose a tag to compare

@guguzea guguzea released this 16 Jul 03:25
V1.0.0

1