这是 AI 可通过 AI 连接（MCP）调用的全部工具。工具名称和参数名称与代码一致，保持英文原样。设置方法见 AI 连接 (MCP)。
| 标记 | 含义 |
|---|
*参数 | 必须提供的参数。 |
| 只读 | 不更改世界。 |
| 实时 | 仅在编辑器打开时（实时模式）可用。 |
| 1 步 | 作为一步撤销保留。 |
- 坐标以方块为单位，x = 东，y = 上，z = 南。
min · max 为框的两个角（包含两端）。
- 方块写成
stone_bricks · oak_stairs[facing=east] 这样的形式。省略的属性取默认值。
- 图案可以像
70%stone,30%andesite 这样按比例混合，或用 grad(y: a→b→c) 表示高度渐变。
set_blocks · fill · shape · replace · transform · build · generate 还有 connect 参数。默认为 true，会将栅栏 · 玻璃板 · 铁栏杆 · 墙 · 楼梯拐角与相邻方块连接。- 许多编辑工具都有
name 参数，即在大纲中显示的 Actor 名称。
| 工具 | 作用 | 主要参数 |
|---|
status | 报告模式（实时/文件） · 打开的文件 · 未保存的更改 · 方块数 · 范围 · 选择 · 撤销数 · 相机。最先调用。只读 | — |
world_new | 打开一个空的新世界。有未保存的更改时拒绝。 | discard_unsaved |
world_open | 打开 .npworld 文件。有未保存的更改时拒绝。 | *path · discard_unsaved |
world_save | 保存为 .npworld。已有同名文件时加上 _vN。 | path · overwrite（仅当前打开的文件） |
undo · redo | 撤销 · 重做（包括用户编辑） | steps（1~50） |
actors | Actor 列表 · 删除 · 隐藏 · 显示 · 选择 · 重命名 · 复制 · 移动 · 变换 · 父级 · 新建文件夹 · 锁定 · 落到地面。1 步 | *action · name · new_name · filter · offset · pos · rot · size · parent |
select | 设置或清除编辑器的选择框。 | min · max · clear |
| 工具 | 作用 | 主要参数 |
|---|
inspect_region | 框的摘要 — 方块数 · 实际范围 · 各层数量 · 数量多的方块。只读 | *min · *max · top |
read_blocks | 以层切片字符图（最多 4 万格）或列表（最多 6 千个）读取框内方块。只读 | *min · *max · format（slices · list） · axis |
surface | 以文字显示每一列最顶部方块的高度和种类。只读 | *min · *max · step |
find_blocks | 查找符合条件的方块位置（lantern · * 等）。只读 | *match · min · max · limit |
block_search | 按关键词查找方块 id（brick stairs）。只读 | *query · limit |
block_info | 单个方块的默认状态 · 属性及允许值 · 同材质系列 · 颜色 · 相似方块。只读 | *block |
palette | 按颜色选方块 · 相似方块 · 方块渐变。需要 jar。只读 | color · like · gradient · steps · count · include_slabs_stairs · face |
| 工具 | 作用 | 主要参数 |
|---|
set_blocks | 逐格放置方块（最多 10 万格）。1 步 | *blocks · state |
fill | 用方块 · 图案填充框（实心 · 空心 · 仅墙 / 覆盖 · 仅空格 · 绘制 · 清除）。1 步 | *min · *max · pattern · form · mode · seed |
shape | 放置球 · 椭球 · 圆柱 · 圆锥 · 棱锥 · 框 · 线 · 拱 · 斜坡（楼梯）。1 步 | *shape · pattern · at · anchor · radius · radii · height · size · axis · hollow · from · to · direction · stairs |
replace | 在框内（默认整个世界）替换匹配的方块。Actor 保持不变。1 步 | *from · *to · min · max · seed |
clear | 清除框内的所有方块。1 步 | *min · *max |
transform | 对框内方块进行移动 · 旋转 · 翻转 · 堆叠（阵列） · 复制。1 步 | *op · *min · *max · offset · quarters · axis · direction · count · gap · to |
build | 将多个编辑按顺序合并为一步 · 一个 Actor。出错时全部撤销。 | *ops |
generate | 生成屋顶 · 窗 · 门 · 柱 · 半木结构 · 树 · 岩石 · 地形（岛 · 丘陵）。1 步 | *kind · min · max · at · preset · settings · seed |
| 工具 | 作用 | 主要参数 |
|---|
build_script | 用带变量 · 循环 · 条件 · 模板的 JSON 建筑程序建造墙 · 建筑 · 屋顶（11 种） · 塔 · 拱 · 桥 · 道路等。1 步 | script · origin · rotate · mirror · seed · dry_run · help |
furnish | 按用途 · 风格为一个房间布置家具 · 照明 · 装饰。1 步 | *min · *max · *purpose · style · seed · dry_run |
furnish_building | 按楼层查找建筑内的房间并分别布置。1 步 | *min · *max · type · purposes · style · min_area · dry_run |
terrain_sculpt | 用笔刷 · 多边形 · 曲线通道 · 框对现有地面进行抬高 · 降低 · 平整 · 平滑 · 阶梯化 · 噪声 · 悬崖 · 绘制。跳过建筑格。1 步 | *op · center · radius · polygon · points · width · min · max · amount · height · strength · material · protect · dry_run |
| 工具 | 作用 | 主要参数 |
|---|
terrain_water | 河流 · 自动河流 · 湖泊 · 瀑布 · 海岸 · 填充封闭水洼。1 步 | *op · points · at · top · min · max · radius · width · depth · sea_level · fluid |
terrain_shape | 悬垂 · 侵蚀 · 洞穴 · 道路（挖填 · 桥） · 材质规则 · 高度图 PNG 导出/导入。1 步 | *op · min · max · at · radius · points · pattern · path · min_height · max_height |
scatter | 按间距 · 密度 · 坡度 · 高度条件散布树 · 草 · 花 · 岩石 · 道具。1 步 | preset · items · min · max · at · radius · min_distance · density · max_slope · ground · seed |
props | 以自由变换放置 · 修改 · 复制 · 删除自定义模型道具。1 步 | *action · model · id · pos · rot · scale · offset · actor · filter |
| 工具 | 作用 | 主要参数 |
|---|
blueprints | 说明可建造的部件 · 参数 · 风格 · 地图设计图格式及示例。只读 | section（all · parts · map_spec） |
place_blueprint | 在现有地面上建造一个部件（房屋 · 塔 · 殿堂 · 城堡 · 道路 · 广场 · 喷泉 · 传送门 · 摊位 · 水井 · 路灯 · 桥 · 城墙 · 大台阶 · 树 · 岩石）。1 步 | *blueprint · params · detail · style · seed |
build_map | 用地图设计图（np-mapspec）一次性建造地形 → 道路 → 结构 → 村庄 → 自然（最大 1024×1024）。1 步 | *spec · detail · style · review |
detail = low（仅体块） · medium（普通建筑） · high（原版最高细节） · max（high + 装饰）style = medieval · fantasy_kingdom · nordic · desert
| 工具 | 作用 | 主要参数 |
|---|
camera | 移动编辑器相机或使其对准框。实时 | from · look_at · fov · frame_min · frame_max · view |
screenshot | 截取视口图像并返回。只读 · 实时 | camera 参数 + width · height · render（shader · raytraced · lit · unlit） · time_of_day |
map_image | 生成俯视地图图像（高度明暗 · 水为蓝色）。无需编辑器也可使用。只读 | *min · *max · scale · grid |
view_image | 生成 CPU 3D 渲染图（等轴 · 俯视 · 斜视 · 侧视 · 视线高度 · 近景 · 自定义相机）。无需编辑器也可使用。只读 | min · max · view · from · look_at · pos · heading · pitch · fov · zoom · width · height · outline · mark_min · mark_max · sun · shadows · exposure |
view_sheet | 将等轴 4 个方向（2×2）合成为一张图。是检查四周最快的方式。只读 | min · max · size · outline · sun · shadows |
| 工具 | 作用 | 主要参数 |
|---|
shader_looks | 显示画面风格预设（英文 id · 名称 · 全部值） · 已保存的风格 · 当前风格 · 值名称及范围。只读 | — |
shader_look | 查看或更改画面风格。在预设之上合并部分值。实时模式下会立即反映到预览中。 | preset · values · name · reset · save |
shader_formulas | 显示画面风格可更改的着色器函数（公式）列表和默认 GLSL。只读 | id |
build_shaderpack | 用当前画面风格生成 NP Lite 光影包 NP-Lite_<名称>_vN.zip。 | preset · values · name · folder |
build_resourcepack | 根据注册表生成完整资源包 <名称>_rp_vN.zip + .sha1.txt + 报告。 | name · folder · description · version_label · url · icon · allow_minecraft_namespace · server_registry · write_even_if_errors |
items | 显示注册表条目（放置类型 · 物品类型 · 物品模型 · 显示 · 盔甲 · 效果）。只读 | filter |
item_set | 更改并保存单个条目的物品类型 · 物品模型 id · 手持外观 · 盔甲图像 · 效果帧。 | *id · item_kind · item_model · display · armor · effect · allow_minecraft_namespace |
sky | 查看、更改或重置天空装饰（太阳 · 月亮 · 云）。 | *action（get · set · reset） · settings |
| 工具 | 作用 | 主要参数 |
|---|
sounds | 声音事件 · 文件状态 · 自定义方块声音 · 合成配方列表。只读 | section · filter |
sound_set | 创建或更改一个声音事件（包括替换原版）。 | *id · files · add_files · replace · subtitle · remove |
sound_generate | 用内置合成器生成无版权顾虑的声音并注册。recipe=starter_pack 为全部入门声音。 | *recipe · seed · variants · event · namespace · mode · volume · replace_existing |
block_sounds_set | 设置自定义方块的破坏 · 放置 · 行走 · 敲击 · 掉落声音。 | *block · preset（stone · wood · crystal） · break · place · step · hit · fall · clear |
| 工具 | 作用 | 主要参数 |
|---|
scene_rules | 显示世界逻辑规则列表与检查、可用的场景 Actor、触发器 · 条件 · 动作 type 的字段（schema）。只读 | section（actors · schema 等） · id |
scene_rule_set | 创建 · 更改 · 删除 · 调整顺序一条规则。也可设置变量 · enum · 数据类型。检查出错时拒绝。1 步 | rule · delete · index · force · variables · enums · types |
anim_clips | 显示动画片段列表与检查、片段 JSON。只读 | id |
anim_clip_set | 创建 · 更改 · 删除一个片段（轨道 · 镜头切换 · 事件 · 声音 · 标题 · 淡入淡出）。1 步 | clip · delete · force |
meta_actor | 创建 · 修改 · 删除 · 复制无方块 Actor（雾体积 · 画面风格体积 · 音源 · 场景 Actor trigger · spawn · display · text · light · camera · path · blocker）。1 步 | *action · kind · name · at · preset · settings · offset |
actor_components | 添加 · 修改 · 移除 · 启用/禁用 Actor 组件（trigger_volume · blocking_volume · interactable · sound_emitter · light · text_label · tags · logic）。1 步 | *action · actor · type · component · props · replace |
| 工具 | 作用 | 主要参数 |
|---|
bom | 框 · Actor · 世界的材料清单（物品数 · 组数 · 潜影盒）及原材料估算。只读 | min · max · actor · format · raw |
design_report | 标记设计检查（区域重叠 · 出生点位置 · 传送连接 · 埋没/悬空 · 命名规则）、各区域内容表、策划表。只读 | format · sheet · lint · placement · fix_names |
travel_times | 传送点 · 玩家出生点 · 村庄中心之间的直线距离与步行路线 · 步行/奔跑时间。只读 | walk · all_regions |
| 工具 | 作用 | 主要参数 |
|---|
export | 将世界（或框）以 .schem · Minecraft 世界文件夹导出到新文件夹（1.21.11）。 | *name · format（schem · world · both） · min · max · spawn · game_mode · biome · time · folder |
| 工具 | 作用 | 主要参数 |
|---|
world_info | 供查看程序使用的世界摘要 JSON（16³ 区段列表 · 版本 · Actor 框 · 场景 Actor）。只读 | sections · min · max · actors · catalog |
world_chunks | 16³ 区段的方块数据（调色板 + 压缩数组）JSON。只读 | sections · min · max · near · max_sections · max_bytes |