SuperAPI AI 工具集

minecraft-builder-skill

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

用途:通过编写小型 JavaScript 配方(recipe),调用基于 Lodestone 的辅助函数来生成 Minecraft 建筑,导出原版 .nbt 结构文件,并打开内置预览器供用户检查与迭代。

主要能力:提供 createStructure、setBlock、fill、hollowBox、line、sphere、cylinder、normalizeBlock、createBlockNbt 等辅助函数,以及 api.lodestone 下的 Lodestone 类。支持原版 minecraft: 命名空间方块 ID 与方块状态字符串(如 minecraft:oak_stairs[facing=east,half=bottom,shape=straight])。默认启用类似 Minecraft 的方块状态更新,玻璃板、铁栏杆、栅栏会根据相邻方块自动生成 north/east/south/west 状态。默认输出为 gzip 压缩的原版结构 NBT,DataVersion 由运行器设置。

使用方式:在已安装的技能目录中操作,安装后不要重跑 Skills CLI。若缺少 node_modules/@mattzh72/lodestone,先运行 npm install --omit=dev。编写 ESM 配方文件,导出接收 api 的默认函数,返回 Lodestone Structure 或 { structure, metadata }。生成 NBT:node scripts/run-build.mjs path/to/recipe.mjs --out-dir minecraft-builds/my-build。打开预览:node scripts/preview.mjs --nbt minecraft-builds/my-build/my-build.nbt。非交互环境加 --no-open,夜间光照加 --lighting night。

适用场景:智能体需要创建、导出、预览 Minecraft 建筑,尤其是悬浮巨型结构等复杂建造。

限制:所有坐标必须位于结构尺寸内,运行器会校验边界并快速失败。预览使用 Lodestone 内置默认资源包,异常或自定义方块可能预览效果不佳。不要全局安装依赖,也不要猜测其他 Lodestone 版本。高级 API 使用前应查阅本地 references/ 下的 recipe-api.md、lodestone/ 与 default-pack-block-states.md。具体收费、价格与平台信息暂未提供。