TotemSentinel

Compatibility: Valheim 1.0.0-1.0.15; latest build, Harmony target, ZDO field, and isolated boot verification completed on 1.0.15. See the fleet compatibility evidence.

TotemSentinel is a standalone client-side BepInEx mod for Valheim that turns newly discovered Fuling Totems into a tactical, player-controlled camp-check radar and wide treasure search.

The first successful pickup of a world- or enemy-spawned Fuling Totem grants three camp checks (bankable up to nine). It does not scan immediately, allowing players to finish combat before choosing when to sweep.

The Flow: Live Counts Become The Final Answer

Values replace • They do not accumulate.

1. Live Pulse (3s): Tapping V spends one check and initiates a 3-second live pulse beneath the minimap.
2. Real-time Reaction: As enemies fall or loot is gathered, live sector memory updates dynamically.
3. Decisive Snapshot: The final pulse replaces the counter with an authoritative CAMP CLEAR or enemy tally.
4. Stable Final Summary: The final results linger cleanly without rushing the player, dismissible with [X] or auto-closing after 5 minutes.

Signature Feature: Greed's Gambit

Hold LeftShift while pressing V to trigger Greed's Gambit—a high-stakes, 3x wide-area search for wealth across the plains.

┌──────────────────────────────────────┐     ┌──────────────────────────────────────┐
│        GREED'S GAMBIT (3x WIDE)      │ ──▶ │         "AT A SINGLE SCRATCH"        │
│   192m Search: Coins, Metal, Jewels  │     │   Any damage triggers Horde Retribution  │
└──────────────────────────────────────┘     └──────────────────────────────────────┘

• 3x Wide Scan Radius: Expands loot radar up to 192 metres, detecting buried or hidden Coins, BlackMetalScrap, Rubies, Amber, AmberPearls, SilverNecklaces, and Fuling Totems.
• The Curse of the Totem (35s): For 35 seconds following a Greed scan, the player is cursed by ancient avarice.
• Single-Scratch Retribution: Taking any damage while cursed immediately alerts (BaseAI.Alert()) and enrages every creature across the 192m sector to hunt the player down!

Features

• Player Agency First: Totems grant checks; they never force an intrusive scan mid-combat.
• Greed's Gambit Risk/Reward: 3x wide loot detection balanced by a 35-second vulnerability window.
• Death Safe: Earned checks survive player death; interrupted in-progress scans are refunded.
• Minimap Anchored: Compact card positioned beneath the circular minimap (MapCorners)—no center-screen spam.
• Comprehensive Enemy Breakdown: Separate live counts for standard Fulings, Shamans, and Brutes.
• Loose Loot Tracking: Accurately counts loose coins, black metal scrap stacks, and precious gems in tall grass.
• Zero Network Lag: Operates exclusively on local, already-hydrated client ZDOs. 0 server RPCs, 0 desync risk.
• Hot-Path Optimized: Allocation-free ZDO sector iteration; no LINQ or physics overhead.

Controls

Configuration

Settings are saved in BepInEx/config/djcdevelopment.totemsentinel.cfg:

In-Game Test Harness

Enable -console in Steam launch options, enter any world, and press F5:

• totemalert: Toggles UI card preview.
• totemalert status: Displays current session charges and settings.
• totem 1: Spawns an isolated test fixture (pedestal totem, 3 fulings, coins, and black metal).
• totem clear: Destroys tracked fixture objects.

AI Disclosure & Transparency

In compliance with community and platform guidelines:

• Development: Architected, modernized for Valheim 1.0.12, and tuned with AI assistance.
• Design & Testing: Fully audited with Cecil reflection against native game binaries and verified locally on Valheim 1.0.12.

License

MIT License. Crafted with care for the Valheim community.