Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 4.65 KB

README.md

File metadata and controls

67 lines (45 loc) · 4.65 KB

MCFPP 能力示例

11 个可单独打开的工程,展示 MCFPP 与 IntelliJ IDEA / VS Code 插件能力。目标为 Minecraft Java 26.3、JDK 25;每个工程包含 main、预期结果和运行验证。01–09、11 使用源码测试,10 使用 Kotlin/JUnit 与独立 DSB 清单。

运行第一个示例

安装支持 26.3 的 MCFPP CLI(编译器当前开发版 0.1.0)及对应版本的插件。终端和插件均选择 JDK 25。

DSB 使用包含本次修复的版本:源码补丁与重建步骤。它补齐实体召唤、UUID、execute/store 及追踪开销问题。

cd 01-language-basics
mcfpp build
mcfpp test --dsb-jar /path/to/datapack-sandbox-cli.jar

把生成的 build/basics 放入世界的 datapacks,执行 /reload 和 /function showcase.basics:main,输出 15、120、2.5。源码测试在 DSB 的新世界运行。

IDEA 单独打开编号目录,在 Settings → Tools → MCFPP 配置工具链。VS Code 打开 examples.code-workspace 可加载所有工程。语言服务适用于两个编辑器;下文的原生 Test、Debug、Run (Render) 菜单属于 IDEA 插件。

示例索引

工程 展示能力
语言基础与 26.3 浮点 变量、范围循环、条件、递归、默认参数和版本指令
数据模型与泛型 组合继承、工厂、结构类型、泛型和可选字段
函数值与集合 lambda、函数引用、捕获、map/filter/fold 和字符串
文本与原版命令 text 样式、悬停/点击、翻译、命令语句块及插值
ScoreRef 与 NBTRef 显式地址、同步读取、复制引用和值缺失处理
实体模板与上下文 实体字段、类型化引用、选择器和 forEachAt
展示实体与调度 26.3 浮点、属性 setter、tick/loop/schedule 和渲染预览
原版资源整合 数据文件、函数标签、advancement 回调和资源包
源码测试与调试 测试生命周期、禁用测试、递归、断点和结构值观察
Kotlin MNI 宏 显式绑定、类型化 quote DSL、内联回调和 Kotlin/JUnit
编辑器与文档导览 跨文件导入/别名、文档悬停、重命名、格式化和 API 文档

每个项目显式指定 version = "26.3"。01 可练习切换版本后 #if 分支、诊断及补全刷新;当前编译器模板默认目标也是 26.3。

批量验证

需要 Node.js 20+,脚本无 npm 依赖。可使用 PATH 中的 mcfpp,或指定完整 CLI 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

首次 Kotlin MNI 构建访问 Maven/Gradle;缓存齐全后加 --offline。也可设置 MCFPP_COMPILER_JAR 和 DSB_JAR,再执行 ./gradlew verifyExamples。编译器和 DSB 由使用者安装,仓库不包含工具 JAR。

逐项日志和 JSON 结果写入 build/verification。本次交付的执行范围见 验证记录。

调试与渲染

09 提供递归、列表字段和生命周期断点练习;07 提供展示实体动画。在 main 旁选择 Run (Render),初始暂停,按 Play 播放。通过 Settings → Tools → MCFPP 配置本地 Minecraft 客户端 JAR/assets 和附加资源包;空配置使用 DSB 替代模型。PNG 保存在 build/render/exports,Stop 关闭预览进程。

调试映射位于 build/debug/mcfpp.debug.json;渲染入口元数据位于 build/preview/mcfpp.render.json。插件导览 提供可复现操作。

构建 07 后,可执行 node tools/render-animation.mjs --dsb /path/to/datapack-sandbox-cli.jar 生成并核对首帧和第 50 tick 的 PNG;验证记录 展示实际输出。

Kotlin MNI

10 使用 Kotlin @MNIMacro、@JvmStatic 和显式 func ... = Provider.method 暴露宏。注解参数只写类型,参数模式由 Value / InlineFn wrapper 推断。Kotlin provider 在编译阶段运行,生成的数据包在 Minecraft 中独立执行。

根 Gradle 工程用于批量验证;各工程的 MNI Gradle 文件由 CLI 在 .mcfpp 中生成。旧版空 Gradle 模板已更新为这个示例集合。