Commands

Parent Command

All commands use the parent /minehud (aliases: /hud, /customhud).

Player Commands

Command	Description
/minehud toggle	Toggle personal HUD visibility

/minehud toggle

Enables or disables the HUD for the executing player only.

• Permission: minehud.command.toggle (default: true)
• Usage: /minehud toggle
• Aliases: /hud toggle, /customhud toggle

Administrator Commands

Command	Description
/minehud reload	Reload configuration and regenerate the resource pack when needed
/minehud softreload	Soft-reload without regenerating the resource pack
/minehud editor	Open an online editor session and receive a chat link
/minehud packinfo	Show active pack backend, readiness, URL, and signature
/minehud debug	Print layout debug lines for the executing player

/minehud reload

Reloads config.yaml and language.yaml, rebuilds the render plan, and regenerates the resource pack if the pack signature changed. Online players may receive an updated pack when ready.

• Permission: minehud.command.reload (default: op)
• Usage: /minehud reload

/minehud softreload

Applies configuration changes that do not require a new resource pack (text, placeholders, many layout offsets, conditions, permissions).

Result	Meaning
Success	Config applied without pack regeneration
Pack change required	Changes need a full /minehud reload
No baseline	No generated pack signature yet — run /minehud reload first

• Permission: minehud.command.softreload (default: op)
• Usage: /minehud softreload

/minehud editor

Creates a remote editor session, uploads the current config snapshot to the mineCodes relay, and sends a clickable URL in chat.

Requires editor-bridge.enabled: true and a reachable relay. See Online Editor.

• Permission: minehud.command.editor (default: op)
• Usage: /minehud editor

/minehud packinfo

Shows runtime pack status: backend id, readiness, public URL, short signature, and active editor session URL if any.

• Permission: minehud.command.reload (default: op)
• Usage: /minehud packinfo

/minehud debug

Prints resolved HUD line positions (screen 480×270 model, pixels relative to anchor) for the player. Rows are also written to the server log.

Useful when matching the online editor preview with in-game placement.

• Permission: minehud.command.reload (default: op)
• Usage: /minehud debug

Permissions

Permission	Default	Description
minehud.command.toggle	true	Access to /minehud toggle
minehud.command.reload	op	Access to /minehud reload, packinfo, and debug
minehud.command.softreload	op	Access to /minehud softreload
minehud.command.editor	op	Access to /minehud editor
minehud.admin	op	Parent permission for all admin commands

minehud.admin includes:

• minehud.command.reload
• minehud.command.softreload
• minehud.command.editor