PurpleTurtle Companion
Purple Turtle client companion: live stats, native shared fog of war, instant loot, combat/boss analytics and AdminTool audit coverage.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
Companion reads Valheim's existing explored-map state and sends only the central playable-world crop using the game's native 64 m fog cells. The Purple Turtle website unions valid client masks and prefers them over its movement-derived fallback, so unexplored terrain remains hidden without rescaling the full internal minimap texture.
