PurpleTurtle Companion

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.