Hitlist (Forever)

Hitlist is a world PvP revenge tracker for World of Warcraft: Forever. Record the enemy players who gank you, keep notes on them, put a bounty on their head, and get warned the moment they show up again.

Features
- **Verified ganks:** when an enemy player kills you, Hitlist reads the death recap and shows a "Killed by..." window. The killing blow and anyone who helped get credit. If they're already on your list, the gank is logged automatically.
- **One-key recording:** target an enemy player and press your keybind (or type `/hitlist add`). Hitlist saves their name, race, class, guild and level, plus your zone and coordinates. Manual reports count once per player per 10 minutes, so spamming does nothing.
- **Revenge profiles:** verified and reported ganks, encounter history, Kill on Sight, priority (Low to Nemesis), a reason, private notes and a "revenge settled" flag.
- **Bounties:** Annoyance (25), Ganker (50), Corpse Camper (100), Guild Nemesis (250) and Most Wanted (500). Tiers rise on their own from verified ganks, or you can set them yourself. Points are bragging rights, not gold.
- **Nearby alerts:** a banner and sound when someone on your list appears on your nameplates, target or mouseover. Most Wanted players get their own banner.
- **Tooltip line:** mouse over a listed player to see their ganks, priority and bounty.
- **Recently Seen:** every enemy player you've spotted this session, ready to add.
- **Sharing:** post a one-line report to guild chat, or copy a Discord-ready report.
- **Backup and restore:** copy your whole list as text and paste it back anytime.

Getting started
1. Turn on enemy nameplates (V).
2. Bind a key: Options > Keybindings > AddOns > Hitlist > Record current target. Or make a macro containing `/hitlist add`.
3. Type `/hitlist` to open the window, or `/hitlist test` to try it with sample records.

Slash commands
- `/hitlist` - open or close the window
- `/hitlist add` - record your current target
- `/hitlist recent` - recently seen enemies
- `/hitlist config` - settings
- `/hitlist backup` / `/hitlist restore` - back up or restore your list
- `/hitlist test` / `/hitlist cleartest` - add or remove sample records
- `/hitlist testalert` - preview an alert
- `/hitlist lastdeath` - show how Hitlist read your last death
- `/hitlist unit` - show what the game reports about your target (useful for bug reports)
- `/hitlist debug` - toggle debug messages
- `/hitlist help` - list all commands

How verification works
- **Verified** ganks come from Blizzard's death recap, the same data as the death recap window. If the recap can't be read, Hitlist uses the one enemy player who had you targeted in the last 6 seconds before you died. If more than one did, it doesn't guess.
- **Reported** ganks are ones you add yourself (keybind or Add by Name). They're useful for the rogue who sapped you and ran, but they're marked as unverified and don't raise bounties.

What Hitlist can't do
Hitlist plays by Forever's addon rules:
- **No combat log.** Forever closes it to addons, so Hitlist relies on the death recap instead. It can tell who killed you, but not who you kill.
- **Coordinates are yours, not theirs.** Addons can't read another player's position.
- **No enemy names in dungeons, raids, battlegrounds or arenas.** Forever hides them there. Open-world PvP is unaffected.
- **No automation.** Hitlist never targets, attacks or casts for you.
- **Beta saved-data bug:** the Forever beta has had trouble loading addon data after a restart. Use Back Up List until you've confirmed your data survives.

Coming next
- **v0.2 Guild Hitlist:** share reports and KOS targets with guildmates who run Hitlist.
- **v0.3 Guild bounty board:** claims, approvals and a leaderboard.

Feedback
Bug reports and ideas are welcome in the comments. For bugs, include a screenshot of any error and the output of `/hitlist unit` or `/hitlist lastdeath`.