PurpleTurtle Companion
Purple Turtle client companion: live stats, native shared fog of war, instant loot, combat/boss analytics and AdminTool audit coverage.
About this mod Author’s original text
Purple Turtle Companion
PURPLE TURTLE SERVER ONLY. This is the client companion for the private Purple Turtle Valheim server.
It replaces the old PurpleTurtle_AdminToolNotifier package and combines the client features into one plugin:
- live player telemetry for the private admin map
- full Valheim lifetime character statistics
- damage dealt/taken telemetry
- boss encounter analytics, including DPS and damage share
- AdminTool usage auditing
- heartbeat/coverage reporting to the server
- native Valheim explored-map sync for the shared website map
- immediate creature loot while retaining normal death/ragdoll behaviour
- native Steam transport/network telemetry
AdminTool coverage
Version 1.0.0 is validated against QoLTeam-Valheim_Admin_Tool 0.4.0 and dynamically hooks its current action surface. Coverage includes cheat toggles, skills, item/creature spawning, ESP, speed/fun sliders, pickup radius, map teleport, virtual workbenches, world/terrain resets and server-tool requests.
The Purple Turtle server implements AdminTool's official guard protocol in audit-only mode. Compatible clients are allowed to use AdminTool; Companion records covered actions for the private admin dashboard. Client auditing is cooperative telemetry, not tamper-proof anti-cheat.
Boss statistics
Damage events are reported to the server simulation owner and aggregated per encounter. After a boss dies the dashboard records:
- damage
- DPS
- DPS share %
- damaging hits
- biggest hit
- damage taken from the boss
- deaths caused by the boss
- killing blow
- fight duration
Lifetime profile statistics backfill immediately because Purple Turtle characters were created specifically for this server. Detailed damage telemetry only exists from the original companion 0.4.0 onward.
Instant loot
On Purple Turtle, creature loot is spawned immediately when the creature dies. The corpse itself behaves normally. The current implementation invokes Valheim's private vanilla Ragdoll.SpawnLoot path safely through reflection and clears the stored corpse drop count only after a successful drop, preventing duplicate loot without interrupting death handling. This feature is adapted from RossQoL Combat/InstantLoot (MIT, Ross West).
Shared map
On Purple Turtle, Companion now uses the server's native Valheim+ shared exploration BitArray directly for the website map. That is the same 2048x2048 fog grid used by the in-game shared map, so the web boundary matches the game instead of being resampled to coarse 64 m cells. The client-side scan is disabled when the server advertises this native source; the older client mask path remains only as a compatibility fallback. Legacy fallback sync is one-shot by default. Set Fog.RepeatSync = true in BepInEx/config/magicorp.purpleturtle.companion.client.cfg only if a non-native server needs ongoing client fog updates; Fog.RepeatIntervalSeconds controls the interval.
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: