Map Maker Utils

Map Maker's Utils

Streamline your Map Making & Data Pack workflow in Minecraft 26.3 - 1.21.11.

마인크래프트 맵 제작과 데이터팩 개발을 위한 유틸리티 모드입니다.

Overview / 개요

Map Maker's Utils (MMU) is a lightweight Fabric mod designed to reduce repetitive tasks for map makers and data pack developers. It provides essential commands, an in-game editor, and UI improvements to handle registry changes and data pack debugging more efficiently.

이 모드는 맵 제작자와 데이터팩 개발자가 겪는 반복적인 작업을 줄여주기 위해 설계되었습니다. 편리한 파일 및 개발 설정 관리 기능은 물론, 레지스트리 변경이나 데이터팩 오류 수정을 위한 UI 개선 기능을 제공합니다.

Features / 주요 기능

Debug & UI / 디버그 및 UI 개선

Reload Diagnostics / 리로드 오류 표시 (v1.3.0+)

• EN: Shows concise file paths (or resource ID if no path is supplied) and available line numbers for data pack loading errors during /reload. Covers functions, advancements, recipes, loot tables, predicates, item modifiers, tags, and other reloadable registries. Codec/validation errors without a source line are marked "line number unavailable". (Requires mod on server)
• KR: /reload 중 데이터팩 로딩 오류 발생 시 파일 경로(경로 미제공 시 리소스 ID)와 확인 가능한 줄 번호만 간결하게 출력합니다. 함수, 발전 과제, 레시피, 전리품 테이블, 조건자, 아이템 수정자, 태그 등을 지원하며 원본 줄 번호가 없는 Codec 오류는 '줄 번호 없음'으로 표시됩니다. (서버 설치 필요)

Safe Mode Error Visualization / 안전 모드 오류 시각화

• EN: When entering Safe Mode due to a data pack failure, the specific error log and registry file paths are displayed at the top of the screen for quick debugging.
• KR: 데이터팩 로딩 실패로 '안전 모드' 진입 시 화면 상단에 원인이 되는 오류 로그 및 레지스트리 파일 경로를 직접 표시하여 빠른 수정을 돕습니다.

Experimental Session Bypass / 실험적 설정 세션 무시

• EN: Adds an "Ignore for this session" button to the Experimental Registry warning screen. Once clicked, the warning will not appear for that map until the game is restarted.
• KR: 실험적 레지스트리 경고 화면에 "이번 세션 무시" 버튼을 추가합니다. 클릭 시 게임을 재시작하기 전까지 해당 맵에서 경고창이 다시 표시되지 않습니다.

Workflow Tools / 작업 효율 도구

/devsetup (v1.3.0+)

• EN: Runs configurable world development commands from config/mapmakerutils.json. Defaults to frozen noon time, clear frozen weather, disabled mob spawning, and disabled mob griefing. Reloads the config on every run without restarting. (Requires Level 2 permissions)
• KR: 개발용 월드 설정 명령을 일괄 실행합니다. 기본 설정은 정오 시간 고정, 맑은 날씨 고정, 몹 스폰 방지, 몹 파괴 방지입니다. 설정 파일(config/mapmakerutils.json)을 매 실행 시 새로 읽어오므로 재시작이 필요 없습니다. (권한 레벨 2 필요)

/dialogeditor [dialogId] (v1.2.0+)

• EN: Opens an in-game editor for creating new Dialogs or editing existing Dialog JSON files by ID.

  • Supports all Minecraft Dialog types (notice, confirmation, multi_action, server_links, dialog_list).
  • Edit body elements, input controls, actions, and inline/referenced Dialogs.
  • Validates and normalizes values before saving to the world's data pack.
  • Hot-swaps saved Dialogs directly into the running singleplayer world.
  • Features a safety confirmation warning if saving to a non-existent data pack (added in 1.2.1).

• KR: 새로운 Dialog를 제작하거나 ID로 기존 Dialog JSON 파일을 수정할 수 있는 인게임 편집기를 엽니다.

  • Minecraft의 모든 Dialog 유형 지원 (notice, confirmation, multi_action, server_links, dialog_list).
  • Body 요소, 입력 컨트롤, 액션 및 인라인/참조 Dialog 편집 가능.
  • 입력값 자동 검증 및 보정 후 월드 데이터팩에 JSON으로 저장.
  • 레지스트리 hot-swap을 통해 실행 중인 싱글플레이 월드에 즉시 반영.
  • 존재하지 않는 데이터팩에 저장 시도 시 안전 확인 경고창 표시 (1.2.1 추가).

/openpackfolder

• EN: (Singleplayer Only) Instantly opens the current world's datapacks folder in your OS file explorer.
• KR: (싱글플레이 전용) 현재 월드의 datapacks 폴더를 파일 탐색기로 즉시 엽니다.

/openvscode (v1.2.0+)

• EN: (Singleplayer Only) Opens the current world's datapacks folder directly in Visual Studio Code. (Requires the code command in your system PATH).
• KR: (싱글플레이 전용) 현재 월드의 datapacks 폴더를 Visual Studio Code로 즉시 엽니다. (시스템 PATH에 code 명령어가 등록되어 있어야 합니다.)

/hardreload

• EN: (Singleplayer Only) Reloads the entire singleplayer world by rejoining it. Useful for applying deep changes that /reload cannot handle.
• KR: (싱글플레이 전용) 맵을 나갔다 들어오는 방식으로 전체 리로드합니다. 일반 /reload로 적용되지 않는 변경 사항을 반영할 때 유용합니다.

Clipboard Utilities / 클립보드 유틸리티

/copypos

• EN: Copies current position as integer coordinates (x y z).
• KR: 현재 플레이어의 정수 좌표 (x y z)를 클립보드에 복사합니다.

/copypos me

• EN: Explicitly copies your own position.
• KR: 자신의 현재 위치 좌표를 명시적으로 복사합니다.

/copypos lookat

• EN: Copies the coordinates of the block you are currently looking at.
• KR: 현재 바라보고 있는 블록의 좌표를 클립보드에 복사합니다.

/copyrot

• EN: Copies your exact facing direction as Yaw Pitch.
• KR: 현재 바라보는 시선 방향 값을 Yaw Pitch 형식으로 클립보드에 복사합니다.

Configuration / 설정

The mod generates config/mapmakerutils.json on startup. Commands are executed sequentially under the caller's position, dimension, and permission levels. Leading / slashes are optional.

모드 최초 실행 시 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"
  ]
}