Preydator

Your Prey Is Never Alone… and Neither Are You.

Preydator sharpens your senses for Midnight’s Prey Hunts with real‑time stage tracking, cinematic Predator‑style audio cues, and a clean, customizable progress bar built for modern Edit Mode layouts. Every transition, every ambush warning, every moment of the hunt is delivered with clarity and intention—no clutter, no noise, just the information you need when the prey is near.

Built specifically for Midnight’s hunt systems, Preydator has evolved into a modular, fully featured companion suite. It includes a Prey Currency Tracker, a Warband‑wide prey overview, a Hunt Table companion panel with reward intelligence, and weekly‑aware snapshots for all your characters. Whether you’re chasing crests, planning weekly rewards, or managing a roster of alts, Preydator keeps your prey state, rewards, and opportunities visible at a glance.

Why Preydator

Blizzard exposes only stage transitions—not true percentages—so Preydator interprets the hunt the way the game actually works: stage‑based, event‑driven, and zone‑aware. Every cue, every transition, every alert is grounded in real API data, not guesswork.

Players choose Preydator because it delivers:

Reliable stage tracking using Blizzard’s quest and widget APIs
Cinematic Predator‑inspired audio cues for stages and ambushes
A clean, customizable progress bar that stays readable in combat
A Hunt Table companion panel with grouping, sorting, reward intel, and direct quest actions
A full Prey Currency Tracker with session deltas, themes, and layout controls
Warband‑wide prey visibility, including weekly‑aware snapshots and N/H/Ni difficulty tracking
Deep customization for textures, colors, percent modes, vertical orientation, labels, and audio
Modern Edit Mode integration, including a compact quick‑settings window
Stable, predictable behavior that avoids taint‑prone Blizzard paths and respects your UI
A fully modular architecture, letting you enable or disable entire systems cleanly and safely

Preydator is a focused, Midnight‑specific companion designed to enhance the hunt without overwhelming your screen or your workflow.

Major Features (v2.0.0)

Core Hunt Tracking

Real‑time prey stage tracking with fallback percent modes (Quarters or Thirds)
Predator‑style audio cues for stages and ambushes
Stage‑aware labels, prefix/suffix customization, and out‑of‑zone/ambush overrides
Vertical and horizontal bar modes with full orientation and fill‑direction controls
Spark line, tick marks, color presets, and full texture customization

Modular Runtime System

Independent runtime modules for Bar, Sounds, Currency, Hunt Table, and Warband
Module‑aware settings gating across all tabs
Reload‑aware UX when enabling/disabling modules
Disabled modules fully shut down their UI, windows, and update routes
New installs start with the bar unlocked for easy placement

Currency, Warband & Weekly Tools

Prey Currency Tracker with session deltas and layout controls
Theme support for Currency, Warband, Hunt Table, and the Prey Bar:
Light, Brown, Dark, Deuteranopia, and Protanopia
Warband currency table with sortable columns, realm grouping, and tracked‑currency visibility
Warband prey overview with Normal/Hard/Nightmare (N/H/Ni) difficulty tracking and weekly‑aware snapshots
Weekly Hunt Cap tracking for chest/sack rewards across difficulties

Hunt Table Companion & Reward Intelligence

Hunt Table companion panel with reward icons, zone labels, and difficulty grouping
Grouping/sorting controls (Group Hunts By, Sort Hunts By) and collapsible headers
Direct quest accept/open actions from the panel
Reward cache persistence with daily refresh and stage‑4 invalidation
Reward Intelligence & Cost Context for smarter reward summaries and value‑aware decision‑making

Expanded Hunt Source Scanner

Pin‑driven hunt discovery using Blizzard’s adventure map systems
Cleaner NPC context detection and reduced scan spam
Safer, more reliable fallback behavior across NPC and interaction types

Performance & Stability

CPU optimizations for zone caching and reduced unnecessary refresh routes
Strict gating for ambush detection, hunt scanning, and currency updates
Safer fallback behavior when prey zone IDs or widget data are unavailable
Hardened reward extraction, quest‑context detection, and debug payload formatting

Diagnostics & Debugging

/pd inspect for live prey/quest/widget state
/pd inspectquest, /pd inspectquestbug, /pd inspectquestboth for quest‑focused diagnostics
/pd mem for memory snapshots
/pd debug tools for logging and troubleshooting
BugSack‑compatible payload output for all major inspect flows

Support & Feedback

All issues, feature requests, and feedback should be filed at:
https://github.com/RagingAltoholic/Preydator/issues