RageClanPappyHUDLocal

v1.2.0·Updated 2026-09-20

Keeps every PappyHUDMaster layout in a private per-player file outside mod-manager profiles, preventing profile synchronization from overwriting personal HUDs.

About this mod Author’s original text

Pappy HUD Local Config

Client-side companion patch for PaPPy-PappyHUDMaster. It keeps every player's HUD layout outside Gale, r2modman, 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 -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.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

PaPPy-PappyHUDMaster

File & checksum

Filename
RageClanPappyHUDLocal-1.2.0.zip
File size
13.3 KiB