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