Resource Pack

Overview

mineHud renders HUD text through custom font providers and client shaders. Those assets are delivered as a resource pack. The plugin can build and host the pack itself, inject into Nexo, write a zip for external pack tools, or point at a pre-hosted URL.

Backends

Configured under resource-pack.mode:

Mode	Behavior
`auto`	Use Nexo when the plugin is present, otherwise standalone
`standalone`	Build the pack and host it over HTTP inside the plugin
`nexo`	Inject HUD assets into the Nexo pack (falls back to standalone if Nexo is missing)
`folder`	Write a complete zip into a directory (Oraxen/ItemsAdder-style external packs)
`external`	Use a pre-hosted pack URL; no local generation for client download

Check the active backend at runtime:

/minehud packinfo

Standalone

Default path when Nexo is not installed.

resource-pack:
  mode: standalone
  bind-host: "0.0.0.0"
  port: 8163
  public-host: ""
  public-url: ""
  pack-format: 34
  required: false

Concern	Detail
Hosting	Plugin starts an HTTP server on `bind-host`:`port`
Player URL	Built from `public-url`, or `public-host` + port, or detected server IP
Dispatch	Pack is sent to players when ready (join / after regeneration)
`required`	When `true`, forces clients to accept the pack

Note: Ensure the port is reachable from players (firewall / reverse proxy). For production behind a reverse proxy, set public-url to the public HTTPS URL of the pack.

Nexo

resource-pack:
  mode: nexo   # or auto with Nexo installed

mineHud injects fonts, glyphs, and shaders into the Nexo resource pack
Pack distribution is managed by Nexo
Glyphs referenced as <glyph:id> are resolved from Nexo; heights can be overridden via glyph-heights

When mode: nexo but Nexo is missing, the plugin logs a warning and falls back to standalone.

Folder Mode

Writes a complete pack zip for external pack pipelines (Oraxen external packs, ItemsAdder, manual hosting):

resource-pack:
  mode: folder
  folder-path: "plugins/Oraxen/pack/external_packs"
  folder-file-name: "minehud.zip"
  public-url: ""   # optional: if empty, may still host HTTP for convenience

Copy or wire the generated zip into your existing pack system as required by that tool.

External URL

Use a pack you already host (CDN, nginx, etc.):

resource-pack:
  mode: external
  public-url: "https://cdn.example.com/packs/minehud.zip"

The plugin does not generate a downloadable pack for clients in this mode; ensure the hosted zip matches the current HUD assets.

Pack Format

pack-format: 34 targets Minecraft 1.21.x. Change only if you know the correct format for your client versions.

Reload Behavior

Command	Pack regeneration	Use when
`/minehud reload`	Regenerates when the pack signature changed	New panels/lines/fonts, glyph usage, background metrics that alter assets
`/minehud softreload`	Never regenerates; fails if signature would change	Text, colors, placeholders, many offsets/conditions

Soft reload results:

Result	Action
OK	Applied live without client re-download
PACK_CHANGE_REQUIRED	Run `/minehud reload`
NO_BASELINE	Run `/minehud reload` once to establish a pack signature

What Affects the Pack Signature

Changes that typically require a full reload include:

Adding or removing panels/lines that change generated font slots
Using new glyphs or glyph height overrides
Backend/mode changes
Settings that alter generated shader/font assets

Text-only MiniMessage and PlaceholderAPI updates often soft-reload safely.

Troubleshooting

Issue	What to check
Players do not get a pack	`/minehud packinfo` — is the backend ready? Is the URL reachable?
Blank / misaligned HUD	Ensure clients accepted the pack; try `/minehud reload`
Soft reload refuses	Pack-impacting change — use full reload
Port conflicts	Change `resource-pack.port` or set `public-url` behind a reverse proxy
Nexo not applying	Confirm Nexo is loaded before mineHud; check logs for backend selection