nbtmapper

nbtmapper

此模组适用于地图艺术建筑和创意项目。 仅在服务器规则允许的情况下,才可在多人服务器上使用。

世界生成

NbtMapper - 自动地图画构建器

免责声明: 本模组用于地图画构建和创意项目。仅在服务器规则允许的情况下于多人服务器使用。

一个 Fabric 客户端模组,帮助你从 NBT 结构文件构建地图画。加载你的结构,设置坐标,模组会辅助完成移动、物品栏管理、方块放置和补给。

前置要求

  • Minecraft 1.21.11
  • Fabric Loader 0.18.2+
  • Fabric API
  • Java 21+
  • 一个带有传送命令(如 /home、/warp)的服务器,用于自动补给

安装

  1. 为 Minecraft 1.21.11 安装 Fabric Loader
  2. 下载模组 .jar 并放入你的 mods/ 文件夹
  3. 确保 Fabric API 也在 mods/ 文件夹中
  4. 启动游戏

快速开始

  1. 将你的 .nbt 结构文件放入 <game_dir>/nbtmapper/
  2. 在游戏中按 Z 打开 GUI
  3. 进入 Tasks 标签页,点击一个 NBT 文件进行加载
  4. 在 Main 标签页点击 New Site 设置构建原点(自动吸附到 128 方块地图网格)
  5. 在 Storage 标签页配置你的存储箱子(每种方块类型的箱子坐标)
  6. 在 Settings 标签页设置你的传送命令
  7. 点击 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(打开时自动暂停)