Friends with Benefits

# Friends With Benefits

Friends With Benefits shares dungeon lockouts and quests within a trusted circle and hands group management to the people you trust. Everything runs over a single addon channel — no server queries, no external services.

## Roles

**Who may do what.** You define roles, each holding exactly the permissions you tick — per data feature, per auto action, per proxy action. Roles are handed out in two places:

- **Sources** — Guild, Friends list (in-game + Battle.net), each Battle.net community separately. One role each.
- **People** — a personal assignment replaces every source role. The built-in role "Blocked" is permanently empty and always wins.

Five roles by default (Full trust · Data only · Group only · Raid guest · Blocked), own ones can be added. `/fwb perm NAME` shows which role applies and where it came from. Only people who run the addon show up. No source with a role and nobody assigned → the addon is effectively off.

*See the screenshots for all of the addon's windows.*

## Features

Tag shows who needs the addon: **↔** both · **→** only you

- **→ Auto actions** — auto-invite / -accept / -promote / -assist, ready check, role check, raid/party convert, instance reset on whisper/chat triggers; reacts to plain chat, so the other player needs nothing
- **→ LFG announcement** — post to your community chat with a cooldown
- **→ Leadership handover** — before you log out, or after a longer absence, your group lead goes to a member who is online and trusted; off by default
- **↔ Quest sharing** — request a quest another member has; their client shares it automatically, no action on their side (same group + in range required)
- **↔ Quest log tab** — second tab next to Blizzard's "All", grouped char → zone → quest
- **↔ Lockout tooltips** — hover a name in Guild / Community / Friends / Who to see their saved instances and reset times
- **↔ Lockout warning** — a "forbidden" icon in Blizzard's Group Finder when a group member is already saved to that ID
- **↔ Lockout browser** — all saved IDs grouped by instance, with a toggle to hide raids
- **↔ Group proxy ("Proxy Lead")** — leader actions (invite, kick, promote, ready check, master looter, subgroup…) without being leader; the leader's client executes them, so the leader needs the addon too. Per-action opt-in, role-gated.
- **↔ Raid planner** — paste a Raid-Helper JSON, everyone gets invited (offline players once they log in) and moved into their subgroup; Discord-name → char mapping is learned, state survives a relog
- **↔ Right-click menu** — quest/dungeon browser filtered to that char, group actions, group role (tank/healer/damage), raid marker, "Request invite", "Assign permissions", "Kick"

## Commands

| Command | Effect |
| --- | --- |
| `/fwb` | Help |
| `/fwb show` | Window, last tab |
| `/fwbq` · `/fwb quests` | Quest browser |
| `/fwbd` · `/fwb dungeons` | Lockout browser |
| `/fwbt` · `/fwb trust` | People tab (assign roles) |
| `/fwb config` | Options |
| `/fwb sync` · `/fwb req` | Send / request data now |
| `/fwb stats` | Count chars / lockouts |
| `/fwb test` | Send LFG announcement immediately |
| `/fwb perm NAME` | Which role applies, and why |
| `/fwb proxy` | Group proxy status |
| `/fwb handover` | Leadership handover on logout / away |
| `/fwb inv⎮lead⎮assist⎮kick NAME` · `/fwb ready⎮roles⎮raid⎮party⎮reset` | Leader action — direct if you're leader, otherwise via proxy |
| `/fwb apicheck` | Client/API diagnostics after patches |
| `/fwb debug on⎮off⎮status⎮trust NAME` | Debug logging |

## Good to know

**Self-healing sync** — only timestamps are broadcast; whoever needs something newer requests it. Sending is split per feature, so each source only gets what its role allows. No master, no central state. Optional relay (0–3 hops) connects people who aren't directly connected.

**No dependencies** — pure Lua, no libraries, no external services. German-language UI. Recipe sharing was removed in 2.15.