Set up your HUD

Choose how to host your pack. Avatars take care of themselves.

Public serverChoose one ZIP or a web folderAutomatic source detection Local serverThis PC or your home networkBuilt-in pack hosting Manual setupYour own host or reverse proxyAdvanced hosting options

Minecraft version Paper serverJava 25for your server

Already using Enorials HUD?

Back up and stop the server, replace the old plugin JAR with the matching new one, and keep your entire plugins/EnorialsHUD/ folder. Restart. Working plugin hosting stays valid when both server.properties and the plugin config have no direct pack URL. Automatic detection prefers a nonempty server.properties URL, then a direct ZIP URL in the plugin config, then static/local hosting. The chosen ZIP must contain the current combined HUD pack.

For existing static hosting, upload the newly generated files after updating. Keep old pack filenames available while players may still download them. Upgrade instructions.

Public server · One combined ZIP

One pack. Your whole server.

Minecraft can send your combined pack through server.properties. EnorialsHUD checks the setup and supplies dynamic avatars.

How should players receive the pack?server.propertiesPlugin ZIP URLShared web folder

Download your plugin
Open Downloads and choose the plugin for Minecraft 26.2. You only need the plugin JAR.
Open Downloads
The API SDK is for developers. Follow the steps below to configure resource-pack delivery.
Install it and set the pack address
- Back up and stop your Paper server.
- Put one matching EnorialsHUD.jar in plugins/.
- Start once to create the plugin files, then stop the server.
- Open plugins/EnorialsHUD/config.yml.
Choose a web host that serves ZIP files directly without signing in. The selected method below determines whether you use one ZIP link or a folder address.
Use the built-in pack host. Enter the address of the computer running your server.
This example uses the built-in pack host with your own network or HTTPS proxy. Keep an existing working address if you already have one.

Your planned ZIP download URLExample — replace with a direct link on your web host
You will upload the generated combined ZIP at this address. A download preview page will not work.
config.yml · existing resource-pack section
```
resource-pack:

  delivery: server-properties
```
Update these fields in the existing section. Keep your other settings and do not add a second resource-pack: key.
Combine your own resource pack with the HUD
Before starting the pack build, put your Java resource-pack ZIP in plugins/EnorialsHUD/server-resource-packs/. Its pack.mcmeta must be at the ZIP root and match your Minecraft version. Merging is enabled by default.
Restart or run /enohud hud pack. Check plugins/EnorialsHUD/pack-merge-report.json for success. Conflicting protected fonts, textures or shaders stop the build and show the exact conflict. After a successful merge, publish the combined export and turn off the old separate pack sender.
Upload the ZIP and connect the link
- Save the config and start the server.
- Wait for Single HUD pack ready in the console. A missing-URL or missing-upload message is expected until you finish these steps.
- Upload this complete ZIP to your web host, unchanged:
plugins/EnorialsHUD/server-pack/EnorialsHUD-pack.zip

It already contains HUD graphics, dynamic-avatar support and compatible packs you added in Step 2.
Open server-pack/SHA1SUMS.txt and paste its 40-character hash below. Copy these two settings into your existing server.properties, then restart the server.

SHA-1 of the generated ZIPFrom server-pack/SHA1SUMS.txt, not the plugin JAR checksum

server.properties · existing file
```
resource-pack=https://packs.example.com/EnorialsHUD-pack.zip

resource-pack-sha1=<paste the generated ZIP hash above>
```
The generated server-pack/server.properties.example also contains the correct hash. Minecraft sends this pack; EnorialsHUD sends no second pack.
Keep resource-pack= empty in server.properties. EnorialsHUD uses the direct URL in your config and calculates the correct hash from the generated ZIP.
After uploading, run /enohud hud packcheck. Wait for Combined pack URL, content and hash verified. Restart if you changed delivery settings.

One ZIP and the original hearts / hunger bars
A single fixed pack keeps the original game bars visible by default. The HUD panels and themes still switch, without downloading another pack. To keep the original bars hidden instead, set resource-pack.single-pack.hide-vanilla-bars: true, rebuild the ZIP, upload it, update the hash and restart. Those original bars then stay hidden even when a player turns their HUD off.
- Save the config and start the server.
- Wait for Static HUD packs ready in the console.
- Upload the complete generated folder to your web folder, preserving filenames.
plugins/EnorialsHUD/hosting-export/generated/
On your websitehttps://packs.example.com/hud/generated/<hash>.zip
Test a real ZIP URL from hosting-export/pack-index.json. This method hosts shared variants and supports automatic native-bar overlays.
The plugin checks your setup
A malformed URL, incorrect hash, login page, missing file or outdated combined ZIP produces a specific console message. Administrators can run /enohud hud packcheck for the single-ZIP methods. A broken selected URL does not silently fall back to a different sender.
Save the config and start the server. Wait for resource-pack preparation to finish.
The player and server are on the same computer. The loopback address works without router changes.
Allow inbound TCP 25599 on the server PC's private-network firewall. Players must use the same home network; router port forwarding is unnecessary.
Find your server PC's local IP
On Windows, run ipconfig in Command Prompt. Use the IPv4 address of the connected Ethernet or Wi-Fi adapter, such as 192.168.1.50. Reserve it in your router if it changes after a restart.
Point your pack domain to the machine running your HTTPS proxy. This example assumes Caddy and Minecraft share the same machine; keep the HUD backend private.
HTTPS example with Caddy
Set up the domain and allow public ports 80/443 for Caddy's usual HTTPS setup. Validate the configuration before starting or reloading Caddy.
Caddyfile · generated packs only
caddy validate --config Caddyfile --adapter caddyfile
Docker, a separate proxy machine or a connection behind CGNAT needs a different network setup. Read the hosting guide.
Packs are served automatically. A working Minecraft game port alone does not make the pack address reachable.
Join and see your avatar
Connect with Minecraft Java, accept the server resource pack and open the HUD:
/enohud
Your HUD portrait uses your skin automatically. Party rows show each member?s face, and the minimap shows their skin heads. New players and avatar refreshes need no new pack upload.
How does automatic detection choose?
With resource-pack.delivery: auto, a nonempty server.properties pack URL wins. Otherwise the plugin checks resource-pack.url, then static/local hosting. Use delivery: server-properties to prepare one ZIP before setting its link, or delivery: plugin to explicitly use plugin hosting. Plugin mode reports a conflict if server.properties still sends another pack. Restart after changing the source.

Your graphics in one place

The pack contains the artwork. The plugin supplies each player's face.

Enorials HUDPrepares shared packs

Upload your combined pack

MinecraftPlayers download the pack

Accept once and play

Your own avatarRendered from your skin

When do I upload again?

After changing the plugin, artwork, layouts or merged packs. For one ZIP, upload the new export and update its configured hash before restarting. New players, skins and themes need no upload.

No client mod needed

The server runs the plugin. Players use Minecraft Java and accept its resource pack.

Already have a website?

Any web host that serves ZIP downloads can hold your combined ZIP or the exported shared-pack folder. No extra pack listener or proxy is needed on your Minecraft server.

Ready for your players

Join as a regular player and check the HUD, your portrait and the minimap.

Something missing?

Need a hand?

Installation manualThe same illustrated steps Hosting guideWeb folders, LAN and proxies TroubleshootingMissing packs or portraits

Different clients on one server

Install ViaVersion/ViaBackwards on the server and use built-in or shared web-folder hosting. A fixed ZIP URL remains native-profile only.

For a web folder, add your client versions to resource-pack.clients.prebuild, restart and upload the generated folder before they join.

Setup & compatibility

Common questions

Does each player need a different pack?

No. The plugin shares packs and draws your own HUD portrait from your skin. The small set of pack variants depends on client resource format, server content and native-bar preferences, not the number of players.

Why does my avatar show a default face?

The HUD uses the skin in your server-side player profile first. On an offline-mode server, enable avatars.name-lookup.enabled in plugins/EnorialsHUD/config.yml to look up the official Java account with the same name, then restart normally. This option is off by default. Missing accounts and launcher-only skins use the default face. Read the avatar settings. No resource-pack re-upload is needed.

Can I use only server.properties for the resource pack?

Yes. Choose the server.properties guide above. Use the current combined ZIP exported by this version, including HUD assets and any merged owner pack. The plugin verifies the chosen URL and recognizes Minecraft as the sender.

Is BetonQuest required?

No. The core HUD, minimap, party tools and trading work without it. Quest features use the optional BetonQuest integration. Money in trades requires Vault and an economy provider; otherwise trading uses items.

Can I use my own resource pack?

Yes. The plugin merges compatible ZIPs from plugins/EnorialsHUD/server-resource-packs/ into its export. Check pack-merge-report.json, then upload the combined result. The one-ZIP methods deliver your pack and HUD together. Read the pack guide.

Set up your HUD

Download your plugin

Install it and set the pack address

Upload the ZIP and connect the link

Join and see your avatar

Ready for your players

Need a hand?

Different clients on one server

Common questions