nbtmapper

模组

· 作者 sait95703

本模组旨在用于地图艺术创作和创意项目。 仅在服务器规则允许的情况下,在多人游戏服务器中使用。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.0 · 1.21.11 · Fabric

一键开服(送7天)

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 轴偏移建造原点,距离为上一张地图的宽度
  • 非常适合并排构建多张地图画作品
  • 通过主选项卡上的 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 鞘翅飞行

工作原理

模组在每个客户端刻上运行状态机:

NEXT → EQUIPPING → MOVING → PLACING → NEXT → ...
                                ↘ SUPPLYING (当方块不足时)
  • NEXT: 找到下一个要放置的方块,批量跳过空气/已完成的方块
  • EQUIPPING: 切换快捷栏到正确的方块
  • MOVING: 导航到目标 4 格范围内
  • PLACING: 放置方块并预填充附近相同类型的方块
  • SUPPLYING: 传送到存储区,获取方块,返回

多个状态可以在单个刻内链接,以实现高效建造。

NBT 文件格式

模组读取标准的 Minecraft 结构 NBT 文件(.nbt)。这些文件可以通过以下方式创建:

  • 游戏内的结构方块
  • 外部工具,如 NBT Studio 或 Amulet Editor
  • 导出为 NBT 格式的地图画生成器
  • 推荐:在线地图画生成器,如 MapartCraft 可以将图像转换为 NBT 文件

模组读取 palette(方块类型)和 blocks(位置),仅保留每个 X/Z 列的最顶层方块。

重要提示

  • 仅客户端:此模组完全在客户端运行,无需安装服务端。
  • 服务器规则:使用前请确保您的服务器允许使用建筑辅助工具。
  • 传送指令:补给系统依赖服务器提供的传送指令(例如 Essentials 的 /home、/warp)。请在“设置”选项卡中配置这些指令。
  • 创造飞行:默认移动模式需要创造模式的飞行能力。如果在不具备飞行权限的情况下进行生存游戏,请切换为行走/奔跑模式。
  • 备份:该模组会在世界中放置方块。请务必对重要建筑进行备份。
  • 首次运行:首次启动时,会生成 storage.json 文件,其中包含默认的箱子坐标,但这些坐标可能与你的服务器不匹配。你必须在“存储”选项卡中配置自己的箱子位置。

按键绑定

按键 操作
Z 打开/关闭图形用户界面(打开时自动暂停)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源