地图制作工具

Map Maker's Utils

在 Minecraft 26.3 - 1.21.11 中简化你的地图制作与数据包工作流。

这是一个用于 Minecraft 地图制作与数据包开发的实用工具模组。

Overview / 概述

Map Maker's Utils (MMU) 是一个轻量级的 Fabric 模组，旨在减少地图制作者和数据包开发者的重复性工作。它提供了必要的命令、游戏内编辑器以及 UI 改进，以便更高效地处理注册表变更和数据包调试。

本模组旨在减少地图制作者和数据包开发者所面临的重复性工作。除了便捷的文件与开发设置管理功能外，还提供了用于注册表变更和数据包错误修复的 UI 改进功能。

---

Features / 主要功能

Debug & UI / 调试与 UI 改进

Reload Diagnostics / 重载错误显示 (v1.3.0+)

• EN：在 /reload 期间数据包加载出错时，显示简洁的文件路径（若未提供路径则显示资源 ID）以及可用的行号。涵盖函数、进度、配方、战利品表、谓词、物品修饰器、标签及其他可重载的注册表。没有源行号的 Codec/验证错误会标记为“行号不可用”。(需要服务器安装模组)
• KR：在 /reload 期间数据包加载出错时，仅简洁地输出文件路径（若未提供路径则输出资源 ID）以及可确认的行号。支持函数、进度、配方、战利品表、谓词、物品修饰器、标签等，对于没有原始行号的 Codec 错误会显示为“无行号”。(需要服务器安装)

Safe Mode Error Visualization / 安全模式错误可视化

• EN：当因数据包加载失败而进入“安全模式”时，在屏幕顶部直接显示导致问题的错误日志及注册表文件路径，以帮助快速修复。
• KR：当因数据包加载失败而进入“安全模式”时，在屏幕顶部直接显示导致问题的错误日志及注册表文件路径，以帮助快速修复。

Experimental Session Bypass / 忽略本次会话的实验性设置

• EN：在实验性注册表警告界面添加“本次会话忽略”按钮。点击后，在游戏重启之前，该地图将不再显示警告窗口。
• KR：在实验性注册表警告界面添加“本次会话忽略”按钮。点击后，在游戏重启之前，该地图将不再显示警告窗口。

---

Workflow Tools / 工作流效率工具

/devsetup (v1.3.0+)

• EN：批量执行开发用世界设置命令。默认设置为正午时间固定、晴朗天气固定、阻止生物生成、阻止生物破坏。每次执行时都会重新读取配置文件（config/mapmakerutils.json），因此无需重启。(需要权限等级 2)
• KR：批量执行开发用世界设置命令。默认设置为正午时间固定、晴朗天气固定、阻止生物生成、阻止生物破坏。每次执行时都会重新读取配置文件（config/mapmakerutils.json），因此无需重启。(需要权限等级 2)

/dialogeditor [dialogId] (v1.2.0+)

• EN：打开游戏内编辑器，用于创建新的 Dialog 或按 ID 修改现有的 Dialog JSON 文件。
  • 支持 Minecraft 的所有 Dialog 类型（notice、confirmation、multi_action、server_links、dialog_list）。
  • 可编辑 Body 元素、输入控件、动作以及内联/引用 Dialog。
  • 输入值自动验证与修正后，以 JSON 形式保存到世界数据包。
  • 通过注册表热交换，立即反映到正在运行的单人游戏世界中。
  • 尝试保存到不存在的数据包时显示安全确认警告窗口（1.2.1 新增）。
• KR：打开游戏内编辑器，用于创建新的 Dialog 或按 ID 修改现有的 Dialog JSON 文件。
  • 支持 Minecraft 的所有 Dialog 类型（notice、confirmation、multi_action、server_links、dialog_list）。
  • 可编辑 Body 元素、输入控件、动作以及内联/引用 Dialog。
  • 输入值自动验证与修正后，以 JSON 形式保存到世界数据包。
  • 通过注册表热交换，立即反映到正在运行的单人游戏世界中。
  • 尝试保存到不存在的数据包时显示安全确认警告窗口（1.2.1 新增）。

/openpackfolder

• EN：（仅单人游戏）立即在文件资源管理器中打开当前世界的 datapacks 文件夹。
• KR：（仅单人游戏）立即在文件资源管理器中打开当前世界的 datapacks 文件夹。

/openvscode (v1.2.0+)

• EN：（仅单人游戏）立即用 Visual Studio Code 打开当前世界的 datapacks 文件夹。（需要系统 PATH 中已注册 code 命令）
• KR：（仅单人游戏）立即用 Visual Studio Code 打开当前世界的 datapacks 文件夹。（需要系统 PATH 中已注册 code 命令）

/hardreload

• EN：（仅单人游戏）通过退出并重新进入地图的方式对整个世界进行完全重载。适用于应用普通 /reload 无法处理的更改。
• KR：（仅单人游戏）通过退出并重新进入地图的方式对整个世界进行完全重载。适用于应用普通 /reload 无法处理的更改。

---

Clipboard Utilities / 剪贴板工具

/copypos

• EN：将当前玩家的整数坐标 (x y z) 复制到剪贴板。
• KR：将当前玩家的整数坐标 (x y z) 复制到剪贴板。

/copypos me

• EN：明确复制自己当前的位置坐标。
• KR：明确复制自己当前的位置坐标。

/copypos lookat

• EN：将当前所注视方块的坐标复制到剪贴板。
• KR：将当前所注视方块的坐标复制到剪贴板。

/copyrot

• EN：将当前视线方向值以 Yaw Pitch 格式复制到剪贴板。
• KR：将当前视线方向值以 Yaw Pitch 格式复制到剪贴板。

---

Configuration / 配置

模组首次启动时会生成 config/mapmakerutils.json 文件。命令以执行者的位置、维度、权限为准按顺序执行，命令前的 / 可以省略。

模组首次启动时会生成 config/mapmakerutils.json 文件。命令以执行者的位置、维度、权限为准按顺序执行，命令前的 / 可以省略。

{
  "devSetupCommands": [
    "gamerule minecraft:advance_time false",
    "time set noon",
    "gamerule minecraft:advance_weather false",
    "weather clear",
    "gamerule minecraft:spawn_mobs false",
    "gamerule minecraft:mob_griefing false"
  ]
}