Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
PurpleTurtle Companion
Purple Turtle client companion: live stats, native shared fog of war, instant loot, combat/boss analytics and AdminTool audit coverage.
By MagiCorp
| Last updated | 5 days ago |
| Total downloads | 160 |
| Total rating | 1 |
| Categories | Mods Tools Client-side Utility AI Generated |
| Dependency string | MagiCorp-PurpleTurtle_Companion-1.3.11 |
| Dependants | 1 other package depends on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2350README
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.
