Confirm with your password

WhereTheCrowFlies

Client companion mod for TheRavensCall. Witnesses and reports combat events, kills, deaths, damage, blocks, parries, fishing, crafting, building, foraging, rituals, and player stats to servers running TheRavensCall.

Client-only Logging

· Website

Stars
0
Downloads
38
Version
1.1.0
Updated
Author
RavenIronStudios
Virus scan
✓ Scan successful
Runs on
Client-only
Required by
1 mods

Description

🐦‍⬛ Where The Crow Flies

Valheim Mod Deployment Framework Publisher Version

RavenIron's client companion mod for The Raven's Call: effortlessly witnesses and relays player combat, defense, kills, deaths, crafting, building, foraging, consumption, rituals, and 100% of vanilla stats to the hall's ledger.


🐦‍⬛ What Is WhereTheCrowFlies?

WhereTheCrowFlies is an opt-in client companion mod designed to pair with TheRavensCall (the server-side admin and chronicle mod).

In Valheim's peer-to-peer multiplayer simulation model, combat calculations, creature deaths, damage, parries, building, crafting, foraging, and fishing are simulated locally on the client that owns the local zone or character. WhereTheCrowFlies acts as the client-side scout—observing all gameplay events with zero client lag and securely reporting them back to dedicated servers running TheRavensCall via routed RPC.


⚙️ Features

  • Full-Coverage Kill & Death Tracking: Reports creature kills with star level, boss status, tamed flag, weapon damage type, biome, and coordinates. Reports player deaths with 15+ rich computed causes (bosses, monsters, PvP opponents, drowning, falls, burning, poison, smoke, tree crush, falling stalactites).
  • Combat & Defense Telemetry: Segregates PvE vs PvP damage dealt/taken, tracks hit counts, shields/weapon blocks, perfect timed parries, and total mitigated damage.
  • Smart 10-Second Batching: Aggregates continuous high-frequency telemetry (damage, defense, stat deltas) into compact 10-second batches, eliminating network congestion during massive raids.
  • Crafting, Upgrading & Repairs: Captures crafted items, quality upgrades, quantities, and crafting station origins.
  • Building & Demolitions: Records piece placements and structure demolitions with piece categories and coordinates.
  • Harvesting, Foraging & Agriculture: Relays berry/mushroom foraging, farm crop harvests, beehives, and sap extraction.
  • Survival & Consumables: Tracks food items eaten, health/stamina/eitr gains, and potion/mead consumption.
  • World Rituals & Exploration: Captures boss altar offerings/summons, portal traversals with tags, and Forsaken power activations.
  • 100% Vanilla PlayerStat Delta Sync: Intercepts all 105 vanilla PlayerStatType counters (distances traveled, jumps, arrows fired, skeleton summons, time in base, sleep, tree chops, mining hits, etc.) and synchronizes deltas to the server.
  • Full Stat & Skill Backfill: Broadcasts a full absolute snapshot of all 105 stats plus every raised Skills.SkillType (level and progress) on spawn and on a configurable interval (default 5 minutes) — so pre-existing totals a player already earned show up immediately, not just future deltas.
  • Zero In-Game Overhead: Runs completely in the background without UI or performance penalty.
  • Safe Everywhere: Connects safely to vanilla servers or servers without TheRavensCall with silent no-op dispatch.

📦 Installation

  1. Install BepInEx for Valheim.
  2. Download and extract WhereTheCrowFlies-v1.1.0.zip.
  3. Place WhereTheCrowFlies.dll into your Valheim/BepInEx/plugins/ directory.

🔧 Configuration

A configuration file is generated at BepInEx/config/com.raveniron.wherethecrowflies.cfg upon first launch:

[General]

## Send owner-side combat reports, world telemetry, crafting, building, harvesting, consumption, and player stats to servers running TheRavensCall.
# Setting type: Boolean
# Default value: true
EnableReporting = true

🛡️ Server Admin Note

If your server uses AzuAntiCheat or a client mod whitelist, add WhereTheCrowFlies.dll to your server's allowed plugins list.

Changelog

All notable changes to WhereTheCrowFlies will be documented in this file.

1.1.0 Latest

Added

  • StatSnapshot (Event Type 11): Full absolute value of all 105 vanilla PlayerStatType counters, flushed on a configurable interval (FullSyncIntervalSeconds, default 5 minutes) and once immediately on spawn/join. Unlike StatSync's deltas, this backfills a player's pre-existing totals automatically (no data earned before install, or lost to a dropped packet, is ever missing) — the receiver assigns rather than accumulates each value.
  • SkillSnapshot (Event Type 12): Full skill state (level 0-100 and progress toward the next level) for every Skills.SkillType the player has raised at least once, on the same interval/on-spawn cadence. Skills were previously not reported at all.
  • Immediate on-spawn backfill: both new snapshot types also fire once the instant the local character spawns, instead of only waiting for the next scheduled resync, so a player who connects and disconnects quickly still backfills.
  • FullSyncIntervalSeconds config option (default 300, floor-clamped to 10): the two new snapshot types run on their own clock, deliberately decoupled from the pre-existing 10-second combat/damage-batch cadence — a full snapshot is idempotent and not latency-sensitive, so it doesn't need to match that cadence.

Fixed

  • Closed the gap where a player's true lifetime stats (as shown on their own client) could permanently diverge from what the server ever received, since StatSync only reported deltas observed after this mod was installed.
1.0.1

Added & Enhanced

  • Full 360° Telemetry Coverage (RavensCall_EventReport_V2):
    • Combat & Defense: Added tracking for star levels (m_level), boss status, tamed flag, primary weapon/damage type, shield/weapon blocks, perfect timed parries, and damage mitigated. Segregated PvE vs PvP damage streams.
    • Player Deaths: Enhanced death cause resolution with 15+ environmental and combat vectors (PvP killer name, boss names, drowning, fall, lightning, smoke, burning, freezing, poison, tree crush).
    • Crafting & Upgrades: Intercepts item creation, quality upgrades, quantities, and crafting station origins.
    • Building & Demolitions: Records piece placements and structure demolitions with piece categories and coordinates.
    • Harvesting & Farming: Captures foraged pickables (berries, mushrooms, thistle), crop harvests, beehives, and sap collectors.
    • Consumables & Survival: Tracks food consumption with health/stamina/eitr values and potion/mead ingestions.
    • World Events & Rituals: Relays boss altar offerings and summons, portal traversals with destination tags, and Forsaken power activations.
    • 100% Vanilla PlayerStat Delta Sync: Intercepts and accumulates all 105 vanilla PlayerStatType engine counters with compact 10-second delta flushes.
  • Backward Compatibility: Dual-transmits RavensCall_CombatReport_V1 alongside V2 reports to ensure zero regression on legacy servers.
  • Metadata & Links: Updated project website URL to https://ravenirongames.rglmobile1.workers.dev/.
1.0.0

Initial Release

  • Lightweight Combat & Event Reporting: Captures client-owned combat interactions (creature kills, player deaths, damage dealt/taken, fish catches) and sends them to dedicated servers running TheRavensCall.
  • Accurate Death Causes: Resolves rich, client-side death causes (environmental damage, boss encounters, drowning, falls) for accurate server-side Chronicle and Discord narration.
  • Batched Damage Reporting: Efficient 10-second / 500-damage accumulator that aggregates damage dealt and taken to prevent network congestion during high-intensity combat and raids.
  • Zero Configuration & Seamless Interop: Requires no player configuration and safely no-ops if connected to servers without TheRavensCall.

Full version history & older downloads →

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2333 · View mod page

Check out the mod page for detailed installation instructions.

2

Install WhereTheCrowFlies

This mod only needs to be installed on the client.

Download WhereTheCrowFlies 1.1.0

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.