FORGEHUD FREE 1.4.1 — DUNGEONFORGE INTEGRATION PREVIEW

Tested: Paper 1.21.11; Java 21 bytecode (runtime checks used JDK 25).
Companion: Minecraft Java 1.21.11, Fabric Loader and matching Fabric API.
This ZIP does not include paid DungeonForge, class plugins, equipment collections or paid models.

SERVER: Back up plugins/ForgeHUD and player data. Stop the server. Put server/ForgeHUD-1.4.1.jar in plugins, removing the older ForgeHUD JAR. Restart fully; do not /reload. Install your separately purchased DungeonForge normally. The live tracker was tested with DungeonForge 1.7.1 and the local 1.7.2 candidate.

PACK: ForgeHUD bundles the free pack. Set pack.public-address to the address players can reach and allow TCP 8163, OR host resourcepack/ForgeHUD-Free-resourcepack.zip at a direct public HTTPS URL and set pack.url. Keep pack.assume-loaded false unless a verified merged pack contains these assets. Restart after pack hosting changes. Players must accept the pack for ornate orbs and boss artwork. The large dungeon card is drawn by the optional companion.

CLIENT: Put client/ForgeHUD-Controls-1.4.1+1.21.11.jar into the player's mods folder with Fabric API for 1.21.11. Do not put this file into server plugins. Press F8 for Dungeon tracker On/Off, party menu and party layout. /hud switches the personal HUD.

DUNGEONS: /fparty create; /fparty invite NAME; invited player /fparty accept. Leader uses /fparty join to browse or /fparty join DUNGEON. Normal DungeonForge permissions and entry restrictions still apply. The card shows the actual run, room count, timer, current-room enemies, secrets and deaths. Guidance is inferred from run state; creator-authored quest chains are a future proposal. Native DungeonForge boss phases appear in the ornate frame.

NO COMPANION: The core dungeon plugin remains playable. ForgeHUD sends a short action-bar run summary; the card requires the companion. Class skills and talents require their separate class plugins. Core party/HUD use does not require a paid class.

UPDATING: Existing config files are retained. Enable integrations.dungeonforge.enabled and integrations.dungeonforge.run-hud, plus controls.client-enabled, if previously disabled. Use /hud reload for supported configuration changes; restart after JAR changes. Back up any custom equipment or combined pack before replacing it; this free package has empty equipment and arsenal defaults.

SCOPE: New tracker verified on Paper 1.21.11 only. Other versions, Folia, every screen size/mod combination and public-host networking are not qualified here. Native DungeonForge parties are transient: leaving the server removes membership; reconnecting requires a fresh invitation.

Guide: https://forgecraftwiki.netlify.app/wikis/forgehud/dungeon-tracker/
Support/free resources: https://discord.gg/WxvYk6YeNf
DungeonForge: https://builtbybit.com/resources/dungeonforge-3d-dungeon-builder.91465/

COMPACT MMO LAYOUT — NEW IN 1.4.1
Press F8 > HUD size / layout. Select Party, Dungeon or Player. Size − / Size + adjusts just that panel from 50% to 150% in 5% steps. Drag a panel by its frame and choose its screen anchor. Positions/sizes are stored per client in config/forgehud-controls.json.

Party: smaller lower-left frames, portraits, live health, ready/leader marks, optional detailed class/status rows. Player: compact portrait + health/resource/XP display; players without a class see real food, not invented mana. Dungeon: smaller upper-right goal card; choose Detailed for enemy/secret/death counters.

Player Style switches MMO panel / Classic orbs. Classic resource-pack orbs use Minecraft GUI scale; the independent Player size buttons apply to the MMO panel. Vanilla hotbar and resource-pack boss/skill artwork retain their existing scale. The new three-panel layout does not resize every Minecraft GUI element.

HUD Reset restores the compact defaults while preserving key bindings. Existing older layout preferences migrate once to the smaller arrangement; existing key bindings are retained. GUI percentages are capped and frames stay inside small screens. Size/anchor controls were exercised in the real Minecraft screen; drag geometry was tested separately from physical mouse input.

UPDATE BOTH FILES: server/ForgeHUD-1.4.1.jar on the server and the 1.4.1+1.21.11 companion in the player's mods folder. The compact player frame needs the new server bridge. The server retains classic fallback for clients without the new handshake. It expires a stopped companion lease rather than permanently hiding legacy orbs.
