Grudge List

Each entry stores the player's name and realm, one of six categories, a free-text reason, the date it was added, and who added it. The category is fixed to one of Ninja, Fake DC, Left early, Rude, Bad play or Other so entries stay comparable if you ever merge lists with friends; the reason is where you write what actually happened. The reason box in the table takes up to 200 characters; a reason typed after /grudge add or /grudge target, or one that arrives by import, has no length cap.

Entries are keyed on the lower-case name-realm pair. Names you type without a realm are assumed to be on your own realm and are displayed bare; players from other realms show as Name-Realm. A lower-case first letter is capitalized when you type a name, so "bob" is stored and shown as "Bob", and spaces in a realm name are stripped. Once a listed player has been seen in a group, the addon also stores their class and character GUID (the game's permanent id for a character), so a player who pays for a name change is still recognized the next time they land in your group.

Type a name into the box at the top of the List tab and press Enter or click the Add button next to it (the box takes up to 40 characters) when you know who it was. Click Add Target in the footer when they are standing in front of you; this works on players only and records their class and GUID immediately. Or open the Recent tab after a run and click Add next to the offender; that path also copies the class and GUID the addon recorded when it saw them. From chat, /grudge add Name reason and /grudge target reason do the same jobs with an optional reason.

Every path files the entry under Other. The three window paths (the name box, Add Target, the Recent tab) then switch you to the List tab and, if the entry is new, put the cursor in that row's reason box; type the reason, press Enter, and click the category button on the row to cycle it to the right one. The slash commands do not open the window or move the cursor: /grudge add prints "Added Name. Set the category and reason in /grudge." and /grudge target prints "Added Name." If the player is already listed, either command says so and, when you gave a reason, replaces the old one.

Every time your party or raid roster changes, the addon records each newcomer: name, class, zone, whether it was a party or a raid, and when. The Recent tab shows them newest first with a relative time ("just now", "12m ago", "3h ago", "2d ago"). Someone who groups with you again moves back to the top rather than appearing twice. The history is capped at 60 people; the oldest fall off.

Anyone already on your list shows a "listed" pill instead of the Add button. You can clear the history from the Settings tab without touching the list itself. You are never recorded in your own history, and placeholder names the game has not resolved yet are skipped. Before anyone has grouped with you, the tab says "No groupmates recorded yet. They appear here as soon as someone joins your group."

When the roster changes, the addon compares the new group against the last snapshot and checks each newcomer against the list, first by name-realm and then by GUID. A match produces up to three things, each on its own toggle: a chat line ("Grudge List: Name just joined and is on your grudge list - Ninja: took the sword (added 2026-09-01, on 2 lists)" with the name in class color), a banner in the raid-warning position reading "GRUDGE: Name - Ninja", and the raid-warning sound.

You are warned once per join. If the player stays in the group, ordinary roster changes do not warn about them again; if they leave and come back, you are warned again. Loading screens are the exception: on login, on /reload, and every time you enter or leave a dungeon or raid instance or take any other zone transfer with a loading screen, the addon forgets its snapshot and re-checks everyone present, so a listed player who is still in your group is announced again each time, worded "is in your group" instead of "just joined". /grudge check runs that same forced re-check on demand with the same wording. When a listed player sends you a party invite, the inviter's name is checked and you are warned while the invite dialog is still up, so you can decline. That invite check is by name only, since no GUID is available yet; a renamed character who invites you is not caught until they are actually in the group.

Export turns your list into plain text with a "GRUDGELIST 1" header line, a comment line saying who exported it and when, and then one entry per line in the form key|Name|Realm|category|added|addedBy|reason|sources. You copy it out of the Export window and paste it wherever you talk to your friends. Pipes, newlines and backslashes inside reasons are escaped so the text survives a chat paste.

Import merges. Nothing already on your list is removed. A name you already have keeps your own reason and category, with two exceptions that only add information: an empty reason is filled in from the import, and a category of Other is upgraded to whatever the other person chose. New names arrive with the original adder's name and original date, are marked as imported, and record who imported them and when. Every list a name has appeared on is remembered, so the row can show "2 lists", "3 lists" and so on. Importing the same text twice changes nothing. Text without the header is refused with "That is not a Grudge List export (missing header)." A line the importer cannot parse is counted as skipped rather than stopping the import. An export whose header carries a higher format number than the addon understands (today the format is 1) is refused with "This export is from a newer Grudge List (format N). Update the addon."; the check is on that format number, not on the addon's version.

The vertical bar is WoW's escape character in chat strings, and a stray one inside a reason could break a message or a color code. Every player-typed string is scrubbed before it reaches chat or the banner: pipes become forward slashes. The reason box in the table shows the text exactly as you typed it, pipe included, and the export format escapes pipes separately, so a pipe in a reason survives a round trip through export and import even though it shows as a slash in chat.

The window has three tabs (List, Recent, Settings) and a footer with Export, Import and Add Target. The title bar shows the version (v0.1.0) and the subtitle shows live counts, for example "3 grudges · 12 recent groupmates · click a reason to edit it, click a category to change it". It opens at 760x500, is resizable between 620x360 and 1200x900, and remembers its size. Esc closes it, and Esc also closes the Export/Import window. The Settings tab offers six accent presets for the window's one color (gold is the default) and the choice persists across sessions.

The List tab columns are Player, Category, Reason, Added and Remove. The Added column shows the date plus the first name of whoever added the entry in white; when the entry is on more than one list, the adder's name gives way to an "N lists" pill. The Recent tab columns are Player, Seen in, When and Grudge. Every control has a tooltip: the category button lists the cycle order, the reason box says it saves the moment you leave it, the Remove button reminds you about /grudge undo, and Add Target says it works on players only.

The layout has only been exercised under a widget mock, not rendered by the game. A layout pass (column widths, the reason box hit area, pill alignment) is expected after the first in-game screenshot.

A community database (a Discord-authenticated web service that tallies how many independent lists a name appears on, published as a data file the addon could read) was discussed on the day the addon was designed. It has not been started. The working recommendation is that if it ever exists it should show only counts, categories and recency, require more than one independent reporter, keep reasons private, and that the decision to build it should wait until after a few weeks of personal use of the addon. The export format and the per-entry list of sources were designed with that in mind, but today the only way a name gets a count above one is a friend pasting you their export.

Also unbuilt: a right-click "Add to Grudge List" item on unit frames (the Anniversary client's menu hooks are unverified), entries that expire, and a per-entry "warn once ever" mode.