
nbtmapper
此模组适用于地图艺术建筑和创意项目。 仅在服务器规则允许的情况下,才可在多人服务器上使用。
查看大图NbtMapper - 自动地图画构建器
免责声明: 本模组用于地图画构建和创意项目。仅在服务器规则允许的情况下于多人服务器使用。
一个 Fabric 客户端模组,帮助你从 NBT 结构文件构建地图画。加载你的结构,设置坐标,模组会辅助完成移动、物品栏管理、方块放置和补给。
前置要求
- Minecraft 1.21.11
- Fabric Loader 0.18.2+
- Fabric API
- Java 21+
- 一个带有传送命令(如
/home、/warp)的服务器,用于自动补给
安装
- 为 Minecraft 1.21.11 安装 Fabric Loader
- 下载模组
.jar并放入你的mods/文件夹 - 确保 Fabric API 也在
mods/文件夹中 - 启动游戏
快速开始
- 将你的
.nbt结构文件放入<game_dir>/nbtmapper/ - 在游戏中按 Z 打开 GUI
- 进入 Tasks 标签页,点击一个 NBT 文件进行加载
- 在 Main 标签页点击 New Site 设置构建原点(自动吸附到 128 方块地图网格)
- 在 Storage 标签页配置你的存储箱子(每种方块类型的箱子坐标)
- 在 Settings 标签页设置你的传送命令
- 点击 Start —— 剩下的交给模组处理
功能
全自动构建
- 加载 NBT 结构并按优化的蛇形模式放置方块
- 在放置地毯/表面方块前自动放置圆石底座
- 在范围内时预填充附近的同类型方块以提升速度
- 瞬间跳过已经正确的方块
自动补给
- 检测物品栏中方块类型不足
- 使用服务器传送命令(如
/home、/warp)前往你配置的存储区域 - 批量补给:一次行程获取多种方块类型
- 取货后合并物品栏中分散的堆叠
自动下一张地图
- 地图完成后,自动加载下一个 NBT 文件(按字母顺序)
- 沿 X 轴按上一张地图的宽度偏移构建原点
- 非常适合并排构建多地图作品
- 通过 Main 标签页的 Auto 按钮切换开关
会话持久化
- 进度每 10 秒自动保存
- 记住最后加载的文件、原点、设置和运行状态
- 如果构建处于活动状态,游戏重启后自动恢复
安全功能
- 循环检测:陷入循环时自动暂停,20 秒后恢复
- 方块验证:检查之前放置的方块以确保正确
- 卡住检测:构建过程中卡住时重新定位玩家
- 移动和放置尝试的最大重试限制
- 移动过程中的自动错误恢复
GUI 概览
按 Z 打开。GUI 有 4 个标签页:
Main 标签页
- 构建原点坐标(只读,通过 New Site 设置)
- 大型 Start/Pause 按钮
- 进度显示,可手动设置/重置
- Auto 开关(完成后自动加载下一张地图)
- Debug 开关(显示实时 HUD 覆盖层)
Tasks 标签页
- 列出
nbtmapper/文件夹中的所有.nbt文件 - 点击加载,X 删除
- 显示进度计数和已完成地图的
[done]标记 - Open NBT Folder 按钮用于快速访问
Storage 标签页
- 将每种方块类型映射到箱子位置(X/Y/Z)
- 直接在 GUI 中编辑坐标
- 更改时自动保存
Settings 标签页
- TP to Store:传送到存储区域的命令
- TP to Worksite:返回构建现场的命令
- Update Home:在补给行程前更新你的家位置的命令
- Move Mode:Walk / Sprint / Creative Fly / Always Fly / Elytra
配置文件
所有配置文件存储在 <game_dir>/nbtmapper/:
| 文件 | 用途 |
|---|---|
storage.json |
方块到箱子坐标的映射和传送命令 |
settings.json |
原点、移动模式、自动下一张、最后加载文件、运行状态 |
<name>_progress.json |
每张地图的构建进度 |
移动模式
| 模式 | 描述 |
|---|---|
| Walk | 标准地面移动 |
| Sprint | 疾跑地面移动 |
| Creative Fly | 创造模式飞行,到达后禁用 |
| Always Fly | 创造模式飞行,保持启用 |
| Elytra | 基于鞘翅的飞行 |
工作原理
模组在每个客户端 tick 上运行一个状态机:
NEXT → EQUIPPING → MOVING → PLACING → NEXT → ...
↘ SUPPLYING (when low on blocks)
- NEXT:找到下一个要放置的方块,批量跳过空气/已完成的方块
- EQUIPPING:将快捷栏切换到正确的方块
- MOVING:导航到目标 4 方块范围内
- PLACING:放置方块并预填充附近的同类型方块
- SUPPLYING:传送到存储区,获取方块,返回
多个状态可以在单个 tick 中串联以实现高效构建。
NBT 文件格式
模组读取标准的 Minecraft 结构 NBT 文件(.nbt)。这些文件可以通过以下方式创建:
- 游戏内结构方块
- 外部工具,如 NBT Studio 或 Amulet Editor
- 导出为 NBT 格式的地图画生成器
- 推荐:在线地图画生成器如 MapartCraft 可以将图像转换为 NBT 文件
模组读取 palette(方块类型)和 blocks(位置),每个 X/Z 列只保留最顶部的方块。
重要说明
- 仅客户端:本模组完全在客户端运行。无需服务器端安装。
- 服务器规则:使用前务必确保你的服务器允许构建辅助工具。
- 传送命令:补给系统依赖服务器提供的传送命令(如 Essentials 的
/home、/warp)。在 Settings 标签页中配置这些命令。 - 创造飞行:默认移动模式需要创造飞行能力。如果在没有飞行权限的生存模式下游戏,请切换到 Walk/Sprint。
- 备份:模组会在世界中放置方块。务必备份重要的建筑。
- 首次运行:首次启动时会创建
storage.json,其中的默认箱子坐标不会匹配你的服务器。你必须在 Storage 标签页中配置你自己的箱子位置。
按键绑定
| 按键 | 操作 |
|---|---|
| Z | 打开/关闭 GUI(打开时自动暂停) |
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。