You are viewing a potentially older version of this package. View all versions.
RavenIronStudios-WhereTheCrowFlies-1.2.1 icon

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.

Date uploaded a week ago
Version 1.2.1
Download link RavenIronStudios-WhereTheCrowFlies-1.2.1.zip
Downloads 39
Dependency string RavenIronStudios-WhereTheCrowFlies-1.2.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2360 icon
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.2360

README

πŸ¦β€β¬› Where The Crow Flies

WHERE THE CROW FLIES VERSION CLIENT SIDE

Two ravens fly out over Midgard every morning and come home every night to whisper in the All-Father's ear. They cannot be everywhere. So a crow keeps to each Viking's shoulder, watches what the ravens miss, and flies it back to the hall before the mead is cold.

Your kills, your deaths, your crafts and your parries, carried to the hall's ledger.

Where The Crow Flies is Raven Iron's client companion to TheRavensCall, the server-side admin and chronicle mod. It is opt-in, and it goes on each player's game.

Valheim works out combat, creature deaths, damage, parries, building, crafting, foraging and fishing on the player's own machine, the one that owns that piece of the world, so the server never sees most of it. Where The Crow Flies is the scout: it watches those events where they happen and reports them to a server running TheRavensCall, so its Chronicle, Discord narration and web dashboard know what really happened. On any other server it keeps quiet and changes nothing.


NEW IN 1.2.1

This is the Valheim 1.0.21 build of Where The Crow Flies.

You It
Play on Valheim 1.0.21 Where The Crow Flies runs on it and reports exactly what it reported before
Join a server update your game together with the server: Valheim 1.0.21 is network version 41

Nothing else is new in this version.


BEFORE YOU INSTALL

If… Then…
πŸ¦β€β¬› your server runs TheRavensCall install this on your own game. It reports what you do to that server, which is what it is for. Set EnableReporting = false if you would rather it did not.
🌍 your server does not run TheRavensCall nothing is reported and nothing breaks.
πŸ›‘οΈ your server uses AzuAntiCheat or a mod whitelist the server admin adds WhereTheCrowFlies.dll to the allowed plugins.
🏷️ the title panel is open your character holds still: movement, attacks, the map and chat are paused. Close it (Esc) before a fight.

I

Everything you do that the server cannot see for itself.

What it reports
βš”οΈ Kills creatures killed by a player, credited to the killer, with the creature's stars, boss and tamed flags, the killing blow's damage type, the biome and where it fell
πŸ’€ Deaths your own deaths with a cause: the boss or creature that did it, the player who killed you, drowning, a fall, burning, freezing, poison, or spirit or lightning damage
πŸ›‘οΈ Combat and defence damage dealt and taken, with creatures and players kept apart, hits, shield and weapon blocks, perfect parries and damage blocked
🎣 Fishing each fish you land, with its quality, weight and biome
πŸ”¨ Crafting items crafted and upgraded, how many, and at which station; repairs too
🏠 Building pieces placed and torn down, with their category and position
🌿 Foraging and farming berries and mushrooms picked, crops harvested
πŸ– Food and meads food eaten, with its health, stamina and eitr, and potions and meads drunk
πŸ—Ώ Rituals and travel boss altar summons, portal trips with the portal's tag, and Forsaken powers used
πŸ“– Read the saga β€” why a crow on every shoulder

In Valheim the machine that owns a zone or a character decides what happens there. A kill, a parry or a picked berry is settled on a player's own game and the server only sees the result, if that. TheRavensCall can only chronicle what it hears about, so Where The Crow Flies listens where the event happens and sends a short report to the server over Valheim's own routed messages. It credits the right player: a berry you pick is reported by your own game, under your name, not by whoever owns that patch of ground.

Damage, blocks and parries come thick and fast in a fight, so they are added up and sent in small batches, every ten seconds or sooner in a heavy fight, instead of one message per swing.


II

Every number Valheim keeps about you, on the server too.

πŸ“Š Every vanilla stat every one of Valheim's own player counters (distance travelled, jumps, arrows fired, trees chopped, mining hits, time in base, sleep and the rest), the changes sent every ten seconds
πŸ“š Full backfill a complete snapshot of every stat, plus every skill you have raised (level and progress), the moment you spawn and every five minutes after
πŸ‘€ Out of the way no HUD changes. The only window is the title panel, and only when you open it.
πŸ“– Read the saga β€” why a snapshot as well as the changes

The changes alone would only ever count what you did after installing the mod, and a lost message would be lost for good. The snapshot carries your true totals, the ones your own game shows, so the server's ledger starts complete and heals itself. Any changes still waiting are sent before each snapshot, so nothing is counted twice. How often the snapshot goes out is FullSyncIntervalSeconds; it always goes out when you spawn, whatever that is set to.


III

Choose which of your earned titles the hall shows with your name.

On a server running TheRavensCall, the title you pick is shown with your name in its Discord narration, Chronicle log and web dashboard. Nothing changes on your in-game nameplate.

You It
/titles in chat, titles in the console (F5), or your TitlePanelKey opens the title panel: every title you have earned, as a button
Click a title sets it
No title clears it
Esc or Close closes the panel
/title lists what you have earned and which one is active
/title Wolf Hunter sets that title; titles of several words work
/title clear shows no title, and it stays that way: titles you earn later are listed, not shown, until you pick one
πŸ“– Read the saga β€” who decides what you have earned

The server does. This mod only sends your request and shows whatever TheRavensCall answers, in the chat box or console you typed in, or in the panel. The panel asks the server when it opens and refreshes after every click, so it always shows the true state. The console commands are the same as the chat ones, without the leading /.

If nothing answers within a few seconds, you get a one-time hint naming the two likely causes: a TheRavensCall too old for titles, or a server that has turned off AcceptClientReports. Everything else in this mod keeps working either way.


THE TOOLBOX

First ten minutes: put WhereTheCrowFlies.dll in BepInEx/plugins/ β†’ join a server that runs TheRavensCall β†’ play as you always do β†’ type /titles to pick your title.

Chat Console (F5)
/titles titles open the title panel (or press your TitlePanelKey)
/title title list your titles
/title <name> title <name> set one
/title clear title clear show no title
ravenscall … admins: TheRavensCall's own server command, typed from your console. It runs on the server; the output is in the server console.
πŸ› οΈ Install
  1. Install BepInExPack Valheim.
  2. Put WhereTheCrowFlies.dll in BepInEx/plugins/.
  3. Start the game once. The settings appear in BepInEx/config/com.raveniron.wherethecrowflies.cfg.
πŸ› οΈ Open the title panel with a key

Set TitlePanelKey in the config to the key you want. It is None by default, which means the commands only.

πŸ› οΈ For server admins: an anti-cheat or a whitelist

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


MULTIPLAYER

Works with any server Needs TheRavensCall on the server Needs Where The Crow Flies on each player
joins vanilla servers and servers without TheRavensCall: its reports go unheard there, and nothing breaks everything this mod reports Β· titles Β· the ravenscall admin command each player's own reports: deaths, combat, crafts, building, harvests, food, stats, skills and titles. A player without it sends none of their own.

Older servers. It still sends the older combat report alongside the full one, so an older TheRavensCall keeps hearing what it understands. A server can turn all player reports off with TheRavensCall's AcceptClientReports.


COMPATIBILITY

Mod
TheRavensCall (Raven Iron) its partner: the server mod that receives the reports and answers title requests
AzuAntiCheat Β· mod whitelists add WhereTheCrowFlies.dll to the server's allowed plugins
Mods with their own title or titles command Where The Crow Flies leaves theirs alone and says so in the log. TitlePanelKey still opens the panel.

SETTINGS

All in BepInEx/config/com.raveniron.wherethecrowflies.cfg. A client-side mod: every setting is your own.

πŸ–₯️ Local β€” yours alone
Section Settings
General EnableReporting (send reports to servers running TheRavensCall; on by default) Β· FullSyncIntervalSeconds (seconds between full stat and skill snapshots; 300 by default) Β· TitlePanelKey (a key that opens the title panel; None by default)

CREDITS

Needs: BepInExPack Valheim 5.4.2360 Β· pairs with TheRavensCall on the server (1.7.0 or newer for titles).

Raven Iron's client companion mod for TheRavensCall. Vendored, and not ours: the title panel's gilt frame is Wubarrk's VikingOS shared source (MIT), compiled in unchanged.

Support Raven Iron. Every Raven Iron mod is free, and stays free: all of it, always. Nothing is held back for patrons, and nothing ever will be. If you'd like to help cover server hosting and test hardware:

CHANGELOG

Changelog

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

[1.2.1] - 2026-11-01

Changed

  • Rebuilt and checked against Valheim 1.0.21 (network version 41). Valheim 1.0.21 replaced PlayerProfile.GetStat(stat) with GetStat(stat, difficulty). This mod never called it: the stat snapshot reads the profile's unconditional counter set (m_playerStats[0]) directly and the live stat deltas hook PlayerProfile.IncrementStat, both unchanged in 1.0.21, and the counter list is the same 205 stats as before. The other patched game methods (crafting, building, kills, deaths, fishing, blocking, the title picker's text-input check) were re-read against 1.0.21 and still bind and behave the same.
  • Website link is now https://ravenirongames.com/.
  • BepInEx dependency is now BepInExPack_Valheim 5.4.2360.
  • The DLL no longer carries an absolute build path that included the build machine's user name (DLLs already published are unchanged).

[1.2.0] - 2026-09-23

Added

  • /title command (chat) and title command (F5 console): pick which of your earned titles the server shows with your name in its Discord narration, Chronicle log and web dashboard on servers running TheRavensCall 1.7.0+ β€” nothing changes on your in-game nameplate. title alone lists what you've earned and which one is active, title <name> (multi-word titles supported, e.g. title Wolf Hunter) sets it, title clear shows no title (and on TheRavensCall 1.7.0 it stays that way: titles you earn later are listed, not shown, until you pick one). The server has the only say on which titles you've actually earned β€” this mod just sends the request and prints whatever TheRavensCall answers.
  • RavensCall_EventReport_V2 Event Type 13 (TitleRequest): the wire packet /title sends β€” schema version 2, op 1 = list, 2 = set, 3 = clear. See HANDOFF.md Β§2.2 for the full layout.
  • RavensCall_TitleReply_V1: a new server β†’ client routed RPC, registered once per world session the same way TheRavensCall registers its own listeners. TheRavensCall sends the reply text directly to the requesting player; this mod prints it back into whichever window (chat box or F5 console) the command was typed in, prefixed [WhereTheCrowFlies]. The reply now also carries the requesting player's full earned-title list and active title, so the title panel below is always fresh after any op with no second round trip.
  • The title panel (/titles chat, titles F5 console, or the new TitlePanelKey config): a small window, on the family's shared gilt-frame theme (vendored from ValkyriesCargo, MIT, by Wubarrk), listing every title you've earned as a button β€” click one to set it, "No title" to clear it, Esc or Close to leave. It asks the server on open and refreshes after every click over the same wire the title command uses. While it's open your character holds still β€” movement, attacks, the map and chat are paused, the same way the game's own sign-text dialog pauses them.
  • ravenscall title <player> [<title>|clear]: the existing admin routing stub's description now mentions the matching admin subcommand TheRavensCall 1.7.0 adds β€” no wire change on this mod's side, the stub only ever routes the raw command text to the server.

Compatibility

  • Pairs with TheRavensCall 1.7.0+ for /title to get an answer, and needs AcceptClientReports on (it disables the player /title path the same way it disables every other client report; the admin's ravenscall title still works). On an older TheRavensCall, or a 1.7.0+ server with AcceptClientReports=false, the request still sends (Event Type 13 is just another RavensCall_EventReport_V2 payload) but nothing replies, so after 5 seconds this mod prints a one-time hint naming both possible causes. An older TheRavensCall with LogCombatReports enabled will additionally log an "unknown eventType 13" line server-side β€” harmless, just noise.
  • Every other event type, and every server this mod already worked with, is unchanged.

[1.1.3] - 2026-09-15

Fixed

  • Harvests were credited to the zone owner, not the picker. The pickable hook was a prefix on Pickable.RPC_Pick, which runs only on the client that owns the pickable's zone, so every berry another player picked in that zone was reported under the owner's name, and a second player picking an already-picked bush produced a phantom harvest. The hook is now a postfix on Pickable.Interact, which runs on the picking player's own client, and it skips a pickable that was already picked, plus any repeat of the same pickable within two seconds, because a non-owner's picked flag only updates when the owner's reply lands and holding Use re-runs the interaction every 0.2 s. The amount uses the same drop-scaling formula the owner uses; the rare skill-bonus yield is rolled inside the interaction on the picker's own client into a local a postfix cannot read, so it is not counted (the owner adds whatever value the picker sent, unvalidated).
  • Failed crafts were counted, multi-crafts were undercounted. InventoryGui.DoCrafting returns early (max quality, missing requirements, inventory full, missing DLC, upgrader resource missing) with the recipe still selected, and it fires when the craft bar completes, so "inventory filled while the bar ran" is ordinary play; the old postfix reported all of those as crafts and sent the recipe amount, ignoring multi-craft and the station bonus. The item is now counted at its target quality before and after: zero difference means nothing was made, and the difference is the real amount. An upgrader that fails or breaks the item no longer reports an upgrade.
  • Absolute stats double counted every full-sync cycle. The full snapshot never cleared the pending delta window, and both timers reset to zero instead of subtracting their interval, so they drifted and the snapshot landed inside a delta window; the next delta flush was then added on top of the snapshot on the server. Pending deltas now go out before every snapshot (the spawn backfill included), and both clocks subtract their interval.
  • ravenscall season start | end can now be typed from a client. A routing stub registers the name flagged server-only and remote, so the game sends it to the server, which checks the admin list and runs TheRavensCall's real command (any TheRavensCall that registers the command, confirmed back to 1.2.2; the server-side flags added in 1.2.4 do not gate a routed command). Non-admins get "You are not admin" from the server.
  • Docs said 105 vanilla stats. Valheim 1.0 has about 205; the handoff and README now say so.

[1.1.2] - 2026-09-15

Fixed

  • Player deaths were never reported. The death hook was a Harmony patch on Character.OnDeath, but Player.OnDeath is a full override that never calls base, so the patch only ever ran for creatures and SendDeath was dead code from the first release. Death narratives, death_history, PvP killer attribution and the Discord death post have all been silent on every server. Player deaths now have their own Player.OnDeath patch, which runs on the victim's own client only (the method itself returns early for every non-owner). Creature kills were never affected. No wire change: the V1 type-2 death packet is the one every TheRavensCall since 1.1.0 already credits; the V2 Death packet is additionally understood from TheRavensCall 1.2.0, which first registered the V2 receiver. Pairs with any TheRavensCall 1.1.0 or newer; 1.2.3 additionally binds every self-report to the sending peer, which a 1.1.2 client passes unchanged.

[1.1.1] - 2026-09-10

Fixed

  • Valheim 1.0.7 compatibility. 1.0 turned PlayerProfile.m_playerStats from a single PlayerStats into an array of ten (one per achievement difficulty), so the 1.1.0 build failed to load at all on 1.0.7 (MissingFieldException at the first stat snapshot). The snapshot now reads bucket 0, the unconditional one that IncrementStat always writes and the exact successor of the pre-1.0 object; the per-difficulty buckets are skipped on purpose, because they undercount a session in which cheats were used.
  • Rebuilt against the 1.0.7 client assemblies on BepInEx 5.4.2350; every game reference and all 15 Harmony targets verified by exact signature on both the client and the dedicated-server build. No wire-protocol change: StatSnapshot still sends (short id, float value) pairs, there are simply 205 of them now instead of 105 (1.0 added a hundred counters). Pair with TheRavensCall 1.2.2 or newer - older receivers cap a snapshot at 200 pairs and silently drop the last five.

Changed

  • Manifest dependency moved to denikson-BepInExPack_Valheim-5.4.2350 (the Valheim 1.0 pack; older packs can take the chainloader down on 1.0's Unity 6).

[1.1.0] - 2026-08-19

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] - 2026-08-17

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] - 2026-08-16

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.