OathboundExpShare

Oathbound Exp Share

Oathbound Exp Share is an essential companion mod for LionAndOtter's Oathbound RPG mod in Valheim.

In original Oathbound, experience points (EXP) are only credited if a player lands the direct physical killing blow on an enemy. This introduces two game-breaking issues during standard gameplay:

1. DoT Kills Grant Zero EXP (Critical Bug Fix): If an enemy dies to Damage-Over-Time (such as burning fire from the Druidic Staff of Fire, fire arrows, poison, or spirit), vanilla Valheim ticks do not assign an attacker identity to the fatal hit. Original Oathbound detects a null killer and completely discards the kill reward. Neither the attacker nor anyone else receives EXP.
2. No Group Progression: Teammates playing together do not share EXP. Whoever lands the final hit takes all the experience, forcing players to compete for last hits and leaving support roles, healers, and secondary damagers behind.

Oathbound Exp Share resolves both issues completely, while introducing real-time in-game Admin GUI configuration synchronization.

---

Core Features

• Fixes Damage-Over-Time (DoT) Kills: Restores lost experience when monsters die from fire, burning effects (including weapons like the Druidic Staff of Fire), poison, or spirit. The player who applied the effect is properly credited and awards are processed normally.
• Damage Contribution EXP Share: All players (and their summoned companions) who contributed damage to a monster earn class EXP when the monster is defeated.
• Proximity / Distance Share: Group members within a configurable distance (default: 50 meters) earn class EXP even if they did not directly strike the target. Ideal for support classes, healers, or teammates fighting together.
• No Duplicate Rewards: Each player is credited only once per enemy kill. If a player qualified under both damage dealt and proximity, they receive the highest reward percentage.
• Real-Time Admin In-Game GUI Sync: Server administrators can open the Configuration Manager menu (press F1) in-game to adjust settings with live sliders. Changes are sent directly to the dedicated server and saved to disk without requiring a server reboot. Non-admins cannot alter server settings.
• Non-Destructive & Safe: Interacts with Oathbound through native networking RPCs (Warrior_Reward_1) without modifying or replacing original Oathbound files.

---

Configuration

Settings can be changed live in-game via the F1 Configuration Manager menu, or edited directly in BepInEx/config/com.aitod.valheim.oathboundexpshare.cfg:

[General]

• EnableExpShare (Default: true): Master toggle for EXP sharing and DoT kill recovery.
• EnableDebugLogs (Default: false): Enables verbose logging to the BepInEx console for damage and EXP tracking.

[Damagers]

• ShareWithDamagers (Default: true): Grants EXP to players who damaged the monster.
• DamagerExpPercent (Default: 100.0): Percentage of the kill EXP awarded to damagers (e.g. 100 for full EXP, 50 for half).
• DamagerMaxDistance (Default: 100.0): Maximum distance in meters from the monster for damagers to qualify (0 = unlimited map-wide).

[Nearby]

• ShareWithNearby (Default: true): Grants EXP to nearby group members within range, even if they did not deal damage.
• NearbyRadius (Default: 50.0): Radius in meters around the defeated monster to award proximity EXP.
• NearbyExpPercent (Default: 100.0): Percentage of the kill EXP awarded to nearby players (e.g. 100 for full, 75 for 75%).

---

Installation

Via Thunderstore / r2modman (Recommended)

1. Install using your mod manager.
2. Ensure both BepInExPack Valheim and Oathbound are installed.

Manual Installation

1. Extract OathboundExpShare.dll into your Valheim/BepInEx/plugins/ folder.

Dedicated Servers & Multiplayer

• Dedicated Server: Place OathboundExpShare.dll in your server's BepInEx/plugins/ directory.
• Clients: Installing on clients enables local damage tracking and in-game Admin GUI controls.

---

Requirements

• BepInExPack Valheim (5.4.2300+)
• Oathbound (0.21.6+)

---

Changelog

• v1.1.1:
• Codebase optimization: pruned 500+ lines of dead fallback scaffolding and redundant reflection.
• Eliminated intermediate list and state allocations on every mob death for zero garbage collection overhead.
• Added repeat-attacker check to prevent redundant ZDO network writes during rapid melee combat.
• Unified live admin configuration synchronization into a single streamlined RPC.
• v1.1.0:
• Resolved the critical issue where DoT kills (fire/burning, poison, spirit) yielded zero EXP.
• Implemented real-time Admin in-game GUI synchronization via F1 Configuration Manager.
• v1.0.0:
• Initial release providing damage-based and proximity-based EXP sharing for Oathbound.