Pappy HUD Local Config

Client-side companion patch for PaPPy-PappyHUDMaster. It keeps every player's HUD layout outside Gale, r2modman, Thunderstore Mod Manager and other profile directories.

What it fixes

Synchronized mod profiles can replace BepInEx/config/pappy.valheim.hudmaster.cfg with the profile owner's layout. This patch redirects Pappy's active settings to:

%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\PappyHUDLocal\hud.cfg

That file belongs to the local Windows user and is not part of a mod-manager profile.

Features

• Preserves a different HUD layout for every player.
• Migrates the currently loaded Pappy layout on first run.
• Works entirely client-side; no dedicated-server installation is required.
• Keeps the official PappyHUDMaster package installed and updateable.
• Writes useful status messages to BepInEx/LogOutput.log.
• Writes a dedicated rotating log next to the local hud.cfg.

Installation

Install this package with Gale or another Thunderstore-compatible manager. PappyHUDMaster is an automatic dependency and must remain enabled.

Start Valheim once, open the Pappy editor with F7, and arrange the HUD. Later profile updates can replace the normal BepInEx config without replacing the personal layout used by the game.

Logs

%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\PappyHUDLocal\PappyHUDLocal.log

The log records Pappy detection, migration, redirected entry count, setting changes and failures. It rotates at approximately 1 MiB.

Version 1.2.0 automatically copies an existing legacy configuration from Valheim\RageClan\PappyHUDMaster\hud.cfg to the generic directory on first launch. The original file is kept as a backup.

Compatibility

• Valheim 1.0
• BepInEx 5.4.x
• PappyHUDMaster 1.0.1
• Client-side only

This companion relies on PappyHUDMaster's current internal configuration fields. If a future Pappy release changes those internals, this patch may require an update.

Credits and disclosure

PappyHUDMaster is created by PaPPy and distributed separately under the MIT License. This companion does not include or replace PappyHUDMaster.

This companion and its documentation were created with substantial AI assistance and are categorized accordingly on Thunderstore.

Changelog

1.2.0

• Replaced the server-specific Valheim/RageClan/PappyHUDMaster storage directory with the generic Valheim/PappyHUDLocal directory.
• Renamed the dedicated log to PappyHUDLocal.log.
• Automatically migrates the legacy per-player hud.cfg without deleting the original file.
• Updated the public plugin name and documentation for general community use.

1.1.0

• Added a dedicated rotating diagnostic log.
• Added debounced setting-change logging to avoid drag-operation spam.
• Reports Pappy detection, migration status, local file path and redirected entry count.
• Keeps per-player settings outside all mod-manager profile directories.

1.0.0

• Initial companion patch.
• Redirected PappyHUDMaster configuration entries to a per-player file under Valheim's persistent data directory.
• Migrated the currently loaded layout on first run.