Skip to content

Latest commit

 

History

History
46 lines (32 loc) · 3.03 KB

verification.md

File metadata and controls

46 lines (32 loc) · 3.03 KB

验证记录

2026-11-18,Windows / Node.js 20.12.2 / JDK 25.0.4。对象为本次提交的例子源码和配置。使用当前开发工作区构建的 MCFPP 0.1.0 CLI,SHA-256: 0cc7fa302d40aba3dde78dca3b9bd8ec5bf48be271f7ccaa6e5bfb000b5c06b3。

DSB 来自运行时补丁与重建说明,实际 JAR SHA-256: 6041464481ca6017316e4d08c65a08cb2fc304aa8c5585a7a37ffc64b2352d44。插件内置副本也已更新。

已执行

  • 11 个工程均构建成功,数据包最低格式均为 [121, 0],目标 26.3。
  • 最终批量运行验证 11/11 通过:14 个 MCFPP 源码测试通过,09 中一个有意禁用的测试跳过;10 的 Kotlin/JUnit 和独立 DSB 清单通过,宏结果为 42、6。
  • 11 的 ide-model --json 和 doc --format both 成功,IDE 模型的目标版本为 26.3。
  • 09 的调试映射和 07 的渲染入口元数据成功生成并解析。
  • 07 在 DSB 中实际运行到 tick 0 与 50,断言展示实体的 translation.y 分别为 4、0;已打开检查两张输出 PNG。截图使用 DSB 替代模型,没有加载 Minecraft 客户端素材。
  • DSB 修复对应的 ExecuteCompositionTest、CommandTraceOutputTest、CommandExecuteAndSelectorTest、NbtSchemaTest、CheckCommandTest、RenderCommandTest 已通过;六个补丁按顺序应用成功,增量补丁的 13 个文件与运行时源码一致。
  • 根 Gradle 的 verifyExamples 任务配置成功加载。

最后一次批量运行的可移植结果摘要见 verification-results.json。构建与元数据检查复用了源码和编译器未变化时的已有结果;最终源码测试使用上述最终 DSB JAR 重新执行。

复现

在仓库根目录执行:

node tools/verify.mjs --compiler /path/to/MCFPP-0.1.0.jar
node tools/verify.mjs --compiler /path/to/MCFPP-0.1.0.jar --mode test --dsb /path/to/datapack-sandbox-cli.jar
node tools/verify.mjs --example 11 --mode ide --mode docs --compiler /path/to/MCFPP-0.1.0.jar
node tools/verify.mjs --example 09 --mode debug --compiler /path/to/MCFPP-0.1.0.jar
node tools/verify.mjs --example 07 --mode render --compiler /path/to/MCFPP-0.1.0.jar
node tools/render-animation.mjs --dsb /path/to/datapack-sandbox-cli.jar

依赖缓存齐全后可给 verify.mjs 加 --offline。命令日志及 JSON 位于 build/verification,源码测试报告位于各例子的 build/tests/mcfpp。

动画画面

tick 0:y = 4 tick 50:y = 0
tick 0 tick 50

验证范围

实际验证覆盖 CLI 构建、数据包在 DSB 中的计算结果、元数据和离屏渲染。IDEA / VS Code 中的补全、重命名、断点按钮及渲染工具栏交互尚未逐项人工操作;插件导览 给出了练习步骤。未在原版 Minecraft 客户端或服务器中运行本集合。

10 使用独立 DSB 清单验证宏输出;当前开发编译器的多文件源码测试宏展开会触发 ConcurrentModificationException,详见该例说明。