You are viewing a potentially older version of this package. View all versions.
MagiCorp-PurpleTurtle_AdminToolNotifier-0.2.0 icon

PurpleTurtle AdminToolNotifier

PURPLE TURTLE SERVER ONLY - client-side Admin Tool usage notifier and audit heartbeat.

Date uploaded 2 months ago
Version 0.2.0
Download link MagiCorp-PurpleTurtle_AdminToolNotifier-0.2.0.zip
Downloads 27
Dependency string MagiCorp-PurpleTurtle_AdminToolNotifier-0.2.0

This mod requires the following mods to function

MagiCorp-PurpleTurtle_Companion-1.2.1 icon
MagiCorp-PurpleTurtle_Companion

Purple Turtle client companion: live stats, shared fog of war, combat/boss analytics and AdminTool audit coverage.

Preferred version: 1.2.1

README

Purple Turtle Admin Tool Notifier

PURPLE TURTLE SERVER ONLY. This client-side companion is published for players joining the Purple Turtle Valheim server. It is not a general-purpose anti-cheat.

It watches the installed QoLTeam-Valheim_Admin_Tool client mod and reports supported Admin Tool actions to the Purple Turtle server's private audit receiver. The server records player, time, feature and details in its BepInEx audit log and exposes the same data on the Purple Turtle admin dashboard.

Current behaviour

  • Client-side package only. Nothing from this Thunderstore package needs to be installed on the dedicated server.
  • Supports Valheim Admin Tool 0.3.9 and reports action-level usage from both menu clicks and hotkeys.
  • Reports cheat toggles, ESP categories, item/entity spawns, skill edits, teleports, player kick/ban actions, world reset/regeneration actions and supported buttons.
  • Sends a heartbeat so the Purple Turtle server can show whether each connected player has the notifier and whether Admin Tool hooks are active.
  • The Purple Turtle server currently runs in monitor-only mode. No automatic kicks or bans are enabled.
  • Admin-tool audit events are not sent to Discord at present. They remain in the server log and dashboard.

Enforcement

The Purple Turtle server already has the server-side receiver needed to detect a missing or stale notifier heartbeat. It can therefore be changed to kick clients that do not report within a grace period. That enforcement is intentionally disabled for now.

Limits

This is cooperative telemetry, not tamper-proof anti-cheat. A modified or removed client mod can suppress or fabricate reports. Missing coverage means the notifier was not observed, not proof that a player cheated.

Requires BepInExPack Valheim and is intended for the Purple Turtle server's current Valheim/Admin Tool 0.3.9 setup. Legacy 0.1.x hooks remain as a fallback.

CHANGELOG

Changelog

0.7.1

  • Migration shim now targets PurpleTurtle_Companion 1.2.1.

0.7.0

  • Migration shim now targets PurpleTurtle_Companion 1.2.0.

0.6.0

  • Migration shim now pulls PurpleTurtle_Companion 1.1.0 with shared fog-of-war telemetry.

0.5.0

  • Retired the old AdminToolNotifier package implementation.
  • This package now depends on MagiCorp-PurpleTurtle_Companion-1.0.0 and contains no DLL.
  • Purple Turtle Companion carries forward the audit functionality and adds stats, live map telemetry and boss analytics.

0.4.0

  • Added lifetime stats and combat telemetry for the Purple Turtle dashboard.
  • Updated AdminTool auditing for the 0.3.9 generation.