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

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 also implements AdminTool's official guard protocol, so the unmodified AdminTool 0.4.0 is denied to non-admin players. Client auditing remains useful evidence but 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, and the stored corpse drop count is cleared after spawning to prevent a second drop when it fades. This feature is adapted from RossQoL Combat/InstantLoot (MIT, Ross West).

Changelog

1.3.11

• Fixed false AdminTool.MapTeleport audit reports from normal minimap clicks.
• Map teleport is now reported only when the hooked action actually moves the local player by at least 20 metres.

1.3.10

• Added Fog.RepeatSync. It defaults to false, so legacy client fog is sent once per connection instead of being rescanned forever.
• Added Fog.RepeatIntervalSeconds (5-600 seconds) for servers that explicitly want repeating legacy client fog sync.
• Server-native shared fog still disables client fog scanning completely.

1.3.9

• Purple Turtle now uses the server's native Valheim+ shared exploration mask for the dashboard, matching the in-game fog grid instead of resampling it to 64 m cells.
• Client fog scanning is disabled when the server advertises native shared fog, removing the periodic main-thread scan and allocation.
• Legacy fallback fog polling is reduced to every 30 seconds and caches reflected Minimap fields.

1.3.8

• Fixed companion-map over-reveal: Valheim's explored BitArray is minimap-pixel data, not 64 m zone cells. Fog now uses the live m_pixelSize world transform before projecting into the website grid.
• Client fog now sends only the character's own m_explored state. The website unions each player's mask itself, avoiding duplicate shared/cartography exploration from m_exploredOthers.

1.3.7

• Fixed website fog alignment by preserving Valheim's native 64 m explored-map cells and sending the central playable-world crop instead of rescaling the full 2048x2048 internal minimap mask.
• Fixed instant loot against Valheim 1.0.14 retail assemblies: private Ragdoll members are now accessed safely, so creature death cannot be interrupted by FieldAccessException.
• Instant loot keeps normal death/ragdoll behaviour, drops loot immediately, prevents duplicate corpse-fade drops, and falls back to vanilla corpse loot if the instant path fails.
• Added reliable explored-map scheduling, reflection-safe minimap access and persistent fog sync diagnostics.
• Added rolling native Steam transport RTT/average/min/max/jitter/loss telemetry for the dashboard.
• AdminTool is audit-only on Purple Turtle: compatible clients are allowed to use it and actions remain logged.

1.3.6

• Fixed client-generated fog persistence and map sync reliability.
• Added safe reflected instant-loot implementation for the current retail Valheim assembly.

1.3.5

• Added native explored-map handling for Valheim's current 2048x2048 minimap state.
• Improved abrupt-disconnect/session tracking and endpoint/socket reporting.

1.3.4

• Reworked minimap private-field access through reflection for Valheim 1.0.14 compatibility.

1.3.3

• Fix fog sync timer scheduling so explored-map masks are actually transmitted after joining.

1.3.2

• Run fog-of-war sync on an independent Unity timer so explored-map telemetry cannot remain stuck at pending.
• Client-generated fog masks remain authoritative for the dashboard.

1.3.0

• Added Purple Turtle instant loot: creature drops spawn immediately at death while the corpse still falls/fades normally.
• Uses Valheim's normal corpse loot generation and clears the stored corpse drop count after spawning, preventing duplicate loot.
• Runs on both Companion clients and the dedicated server so whichever machine owns the dying creature can perform the drop.
• Adapted from RossQoL Combat/InstantLoot (MIT, Ross West).

1.2.1

• Fog sync now derives dimensions from the actual Valheim explored BitArray and no longer silently aborts on texture-size assumptions.
• Fog state is included in Companion heartbeats so the server/dashboard can show the exact sync state or failure reason.
• Added client-side native ISocket/Steam transport metrics to heartbeats for real network ping instead of game-loop RPC timing.

1.2.0

• Dashboard/player network telemetry now uses Valheim's native Steam socket RTT instead of routed-RPC latency.
• Admin telemetry includes remote address when exposed by the active transport, plus transport identity/type fallback.
• Added session network telemetry: current/average/min/max RTT, jitter, samples and probe-loss percentage.
• Added server-wide player death messages to shame the fallen.
• Boss defeats now broadcast a compact DPS/DPS% table and awards into in-game chat.
• Added a generic Purple Turtle server-chat RPC.
• Boss DPS summaries and player-death shame messages are also emitted to the existing AMP Discord event bot.

1.1.0

• Added native Valheim fog-of-war telemetry using each character's existing explored minimap cells.
• Dashboard now shows the shared union of genuinely explored terrain and keeps unexplored terrain hidden.
• Fog backfills the character's full existing map on first 1.1.0 sync and persists while players are offline.
• Fog payload is only about 8 KiB raw for the standard 256x256 minimap and is sent only when changed or periodically refreshed.

1.0.0

• Renamed and expanded the old Purple Turtle Admin Tool Notifier into Purple Turtle Companion.
• Added boss encounter aggregation with damage, DPS, DPS%, hits, biggest hit, damage taken, deaths and killing blow.
• Added Valheim Admin Tool 0.4.0 coverage and validated 71 hooks against the released DLL.
• Added coverage for speed/fun controls, pickup radius, map teleport, virtual workbenches and central world/terrain/server-tool requests.
• Added support for AdminTool's official server guard protocol; non-admins are denied by the Purple Turtle server.
• Preserved the existing lifetime stats, live-map, combat and audit RPC compatibility during migration.
• New Purple Turtle Companion icon.