oathbound addon
Tactical Norse command window (G key) and AI stance control (Free Hunt, Stay, Heel, Recall) for the Oathbound Hunter wolf companion.
About this mod Author’s original text
Oathbound Addon
A focused companion enhancement mod for Oathbound (WarriorRpg) that adds direct tactical control to the Hunter class wolf companion.
Focus and Scope
Currently, this mod is dedicated specifically to the Hunter class and its companion wolf.
In difficult combat or modded setups (such as CLLC multi-star enemies), animal companions without tactical commands often charge into dangerous packs and die quickly. This mod solves that problem by giving Hunters clear strategic command over their companion without artificially buffing stats or altering other classes.
Hunter Companion Tactical Control
Control your wolf companion in real time using a native Norse-styled command window.
How It Works
- Play as the Hunter class with your summoned companion wolf.
- Press G (configurable) to open the Command Window (styled after the Oathbound Norse UI).
- Click any command card to issue orders:
| Command | Icon | Behavior |
|:--- |:---: |:--- |
| FREE HUNT | Wolf Trophy | Aggressive. Wolf roams and attacks nearby enemies freely (standard Oathbound behavior). |
| STAY | Wood Shield | Guard Ground. Wolf holds its current position and will not follow or chase. |
| HEEL | Wolf Pelt | Pure Passive. Wolf stays glued to your heel, clears combat aggro, and never attacks. Useful for sneaking, moving through dangerous areas, or preventing unwanted pulls. |
| RECALL | Staff Shield | Emergency Disengage. Instantly clears combat aggro, breaks combat, pulls the wolf back to your side, and enters Heel mode. |
Features
- Native Valheim UI: Integrated cleanly into Valheim's existing Norse UI styling with smooth mouse control.
- Companion Name Persistence: Custom tamed name (set via native Shift+E) is saved to your character save file and automatically restored whenever your wolf respawns, revives, or is re-summoned.
- HUD Stance Badge: Lightweight indicator shows current order (WOLF: FREE HUNT, WOLF: STAY, WOLF: HEEL).
- Zero Overhead: Pointer-based event hooks with zero scene scanning and zero memory allocations during combat.
Configuration (BepInEx/config/com.aitod.valheim.oathboundaddon.cfg)
- CommandWindowKey (Default: G): Hotkey to toggle the command window.
- HoldMode (Default: false): Set to true if you prefer holding the key instead of toggling.
- ShowHudBadge (Default: true): Toggle the HUD stance indicator.
- BadgePosX / BadgePosY (Default: 0.5, 0.88): Screen position (0.0 to 1.0) of the HUD stance badge.
- AbilityPromptOffsetX / AbilityPromptOffsetY (Default: 0.0, 0.0): Horizontal (X) and vertical (Y) offsets for the class ability prompt text and companion health bar (useful to prevent overlap with food or status bars).
- ProgressHudOffsetX / ProgressHudOffsetY (Default: 0.0, 0.0): Horizontal (X) and vertical (Y) offsets for the Oathbound class level and XP progress bar.
Requirements
- Valheim
- BepInExPack Valheim
- Oathbound (v0.21.6+)
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- 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.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- 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.
Install these first, or the mod will not work: