SuperAPI AI 工具集

minecraft-datapack

数据与分析

查看项目

更新于 10-15 22:40

技能介绍

用途:当交付物是数据包文件(pack.mcmeta、data/ 目录及 .mcfunction/JSON 内容)时使用本技能;仅涉及命令片段、不绑定数据包文件树时改用 minecraft-commands-scripting,涉及加载器 API、Java 代码或运行时模组行为时改用 minecraft-modding。

主要能力:编辑前先检查 pack.mcmeta 与目标 Minecraft 版本,除非要求迁移否则保留既有目标;元数据数字本身不会让旧命令或注册表结构兼容。支持函数、进度、配方、战利品表、谓词、物品修饰器与标签等注册表数据,以及世界生成覆盖(如生物群系噪声设置、生成开销)。

版本元数据:1.21/1.21.1 用 pack_format 48,1.21.2/1.21.3 用 57,1.21.4 用 61,1.21.5 用 71,1.21.6 用 80,1.21.7/1.21.8 用 81;自 1.21.9 的数据包格式 82 起改用 min_format 与 max_format,如 1.21.9/1.21.10 为 [88, 0],1.21.11 为 [94, 1],26.1 为 [101, 1],26.2 为 [107, 1],26.3 为 [121, 0]。含 82 以下旧格式的范围需同时保留 pack_format 与 supported_formats。

用法:将数据包文件夹或 ZIP 放入世界的 datapacks/ 目录,pack.mcmeta 置于根目录,使用 /datapack list、/datapack enable、/datapack disable、/reload 等命令;引擎标签 minecraft:load 与 minecraft:tick 必须放在 minecraft 命名空间。编辑后运行 ./scripts/validate-datapack.sh --root /path/to/datapack(严格模式加 --strict),再在游戏内 /reload 并测试,检查 latest.log。

限制:tick 函数应保持简短;宏需 1.20.2+ 且必须提供 with 来源;世界生成覆盖需基于原版完整 JSON 修改而非从零创建;26.3 移除了生物群系顶层 spawn_costs,改用 minecraft:gameplay/natural_mob_spawns 环境属性。其他细节暂未提供。