oathbound addon

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+)