@kar-mi/spirit-vale-tools-rewards

[!WARNING] Deprecated: This package is no longer maintained. Existing releases remain available as-is, but no further updates or support are planned.

Spirit Vale reward tracking and replay utilities.

Install

bun add @kar-mi/spirit-vale-tools-rewards

Usage

import {
  FishNetMobRewardTracker,
  loadBundledMobRewardCatalog,
  queryMobRewardCatalog,
} from "@kar-mi/spirit-vale-tools-rewards";

const tracker = new FishNetMobRewardTracker();

// packet: DecodedFishNetPacket from @kar-mi/spirit-vale-tools-capture
for (const event of tracker.consume(packet)) {
  console.log(event);
}

const catalogMobs = queryMobRewardCatalog(loadBundledMobRewardCatalog(), { text: "slime" });
console.log(catalogMobs.length);

Use loadRewardReplay to rebuild reward state from a recorded log session and RewardSessionLogFollower to follow a live session — either by polling it, or by iterating it (RewardSessionLogFollower.watch()), which wakes on a filesystem event instead of a timer and yields only batches that carry something. Call close() when done.

The tracker derives XP gains from the character's absolute XP callback. Session and aggregate XP totals therefore include party-shared and other standalone gains even when no individual mob death can be attributed. Per-mob summaries remain limited to confirmed kill correlations.

See the package guide for registry setup and usage.