Übersicht der regear-Pipeline

Ein regear ist die Rückzahlung der Gilde für Ausrüstung, die du bei einem Tod verloren hast (oder für Items, die du bei einem Overcharge verbraucht hast). Die Pipeline von AO Master läuft komplett innerhalb der App — einreichen, prüfen, genehmigen, ausliefern — und hat zwei Auslieferungsmodi, die sich die identische Einreich- und Genehmigungshälfte teilen und sich erst bei der Auslieferung trennen.

Diese Seite ist der Einstieg. Lies sie zuerst; die modusspezifischen Seiten gehen ins Detail:

• Mitglieder — einen regear einreichen (bereits dokumentiert)
• Staff — prüfen + genehmigen / ablehnen
• Item-Modus — Cut-off + locker
• Silver-Modus — Auszahlung aus der Silver Bank
• Member Regear Report (Admin-Sicht)

Die gemeinsame erste Hälfte (Modi 1-2)

Die erste Hälfte ist unabhängig vom Modus identisch:

1. Mitglied reicht ein über #Request Regear (Tab „Deaths" oder „Overcharge"). Das Mitglied wählt die war role, die es gespielt hat; AO Master vergleicht die verlorene Ausrüstung mit dem loadout der Rolle und markiert pro Slot eventuelle Validierungsprobleme (Tier zu niedrig, Tier zu hoch, ungültig).
2. Staff prüft in #Review Requests. Die slotweise Validierung wird angezeigt; der Staff sieht pro Anfrage eine Aktion Approve / Reject / Archive. Die „primäre" grüne Aktionsschaltfläche ist modusabhängig — siehe unten.

Das ist der universelle Ablauf. Die Validierungsrichtlinie (auto-reject vs. zulassen vs. Staff-Entscheidung pro Problemtyp) wird pro Gilde unter Settings → Regear Policy festgelegt.

Die Modus-Aufteilung

Jede Gilde wählt einen regear-Auszahlungsmodus. Die Einstellung liegt unter Settings → Regear Policy → Mode. Vier Werte:

Modus	Was ausgeliefert wird	Wann zu verwenden
Item return	Staff packt die Items zurück in den locker des Mitglieds. Der Kanal Cut-off Tasks verwaltet die Packwarteschlange.	Klassischer Ablauf. Funktioniert ohne Item Price.
Silver — Sum by Item Price	Gutschrift = Summe der silver-Preise jedes verlorenen Slots (live aus dem Marktfeed des Albion Online Data Project).	Du willst die volle Verlustrückzahlung zu Live-Marktpreisen. Erfordert Item Price EIN.
Silver — War Role — Fixed cap	Gutschrift = die feste silver-Obergrenze der war role, unabhängig vom tatsächlichen Verlust.	Du willst pro Event vorhersehbare Auszahlungen. Begrenzt die Auszahlungsbelastung der Gilde.
Silver — War Role — Capped by actual	Gutschrift = der kleinere Wert aus (tatsächlicher Item-Price-Summe) oder (silver-Obergrenze der Rolle) — zahlt den tatsächlichen Verlust, aber nie mehr als die Obergrenze.	Das Beste aus beiden Welten: nie überzahlen, aber bei kleineren Verlusten exakt entschädigen.

Alle drei silver-Modi erfordern Silver Bank EIN UND Item Price EIN (Schalter unter Settings → Systems). Die Regear-Policy-Übersicht zeigt eine Requirements-Karte, die fehlende Voraussetzungen auflistet + Aktivierung mit einem Klick anbietet.

Eine Regel, nicht vier

Ursprünglich wurde Item Price nur vom Modus „Sum by Item Price" benötigt. TK hat die Regel auf jeder silver-Modus erfordert Item Price EIN festgelegt, um die Erklärung einfach zu halten. Drei Kontrollkästchen < eine 4-Zellen-Matrix.

Wo der Modus ausgewählt wird

/welcome → ⚙️ neben dem Gildennamen → Tab Regear Policy → Dropdown Mode.

Ein zweites Dropdown erscheint darunter, wenn du Silver payout wählst — das ist der Silver Mode-Picker mit den drei Untervarianten (Sum by Item Price · War Role — Fixed cap · War Role — Capped by actual). Beim Wählen einer der War-Role-Varianten erscheint eine Schaltfläche Set War Role Caps, die ein Untermodal für die silver-Obergrenze pro Rolle öffnet (auch unter Settings → War Roles editierbar).

Die Aufteilung — was nach Approve passiert

Gleiches Einreichen + gleiche Prüfung für beide Modi, aber die grüne Aktionsschaltfläche auf dem Prüfbildschirm wechselt Beschriftung und Verhalten:

Item-Modus — Create Cut-off Task

Staff genehmigt die Anfrage → sie wandert in die Cut-off Task-Warteschlange in #Cut-off Tasks. Ein Packer übernimmt die Aufgabe, nutzt den Pick Checker, um zu prüfen, dass er die richtigen Items aus der Gildentruhe gezogen hat, markiert die Aufgabe als ausgeliefert, und die Items landen im locker des Mitglieds.

Das Mitglied sieht den Fortschritt Schritt für Schritt in #My Requests: Submitted → Approved → Cutoff → Prepared → Delivered.

Volldetail: Item-Modus — Cut-off + locker. Der Kanal Cut-off Tasks wird in der Sidebar ausgeblendet, wenn die Gilde im silver-Modus ist (kein Cut-off in diesem Modus).

Silver-Modus — Payout

Staff genehmigt die Anfrage → sie geht in den Zustand approved-but-unpaid über. Staff kann:

• Eine bezahlen — Klick auf Payout in der Zeile → Gutschrift landet sofort im Silver-Bank-Guthaben des Mitglieds.
• Mehrere bezahlen — genehmigte Zeilen mehrfach auswählen + auf Payout klicken → Sammelgutschrift (z. B. wöchentlicher Zahltag).

Die Trennung in „approve" + „pay" ist beabsichtigt — wie bei Stripe / Payroll / PayPal. Sie gibt dem Staff ein Korrekturfenster: Bemerkst du zwischen Genehmigung und Auszahlung einen Fehler, lehne die Zeile ab, bevor Geld fließt. Keine ausgleichenden Buchungen nötig.

Das Mitglied sieht den Fortschritt in #My Requests als: Submitted → Approved → 💰 Credited X silver.

Die Gutschrift liegt in der Silver-Bank-Wallet des Mitglieds (#Silver Bank → My Home), bis es eine Auszahlung anfordert — das ist ein separater, vom Staff bearbeiteter Ablauf.

Volldetail: Silver-Modus — Auszahlung aus der Silver Bank.

Lebenszyklus-Zustände

Das Status-Badge in #My Requests und #Review Requests durchläuft diese Zustände (verschiedene Modi zeigen einen anderen Endzustand):

Badge	Gesetzt bei	Modus
Pending	Mitglied reicht ein	beide
Approved	Staff klickt Approve	beide
Delivered	Packer markiert den Cut-off Task als ausgeliefert	nur Item
Received	Mitglied klickt Received auf der Zeile in #My Requests	nur Item
Paid	Staff klickt Payout (silver landet in der Silver-Bank-Wallet des Mitglieds)	nur Silver
Archived	Mitglied archiviert, oder automatische Archivierung nach Ablauf des Aufbewahrungsfensters	beide
Rejected	Staff lehnt mit Begründung ab	beide

Pending-Anfragen sind modusagnostisch by design — sie kümmern sich nicht darum, welcher Auslieferungsmodus gerade aktiv ist. Sie verpflichten sich erst beim Genehmigen auf einen Modus, sodass ein Moduswechsel niemals eine pending-Anfrage strandet.

Modus auf einer aktiven Gilde umschalten

Du kannst den Modus jederzeit unter Settings → Regear Policy → Mode wechseln. AO Master blockiert den Wechsel, wenn:

• Eine approved-but-unpaid silver request existiert (muss zuerst bezahlt werden — „Modus verlassen: silver"-Zustand).
• Ein unresolved cut-off task noch unbezahlte Packarbeit hat (muss zuerst abgeschlossen werden — „Modus verlassen: item"-Zustand).

Ein Toast zeigt die Anzahl + Deep-Link zur betroffenen Liste an („Pay 3 pending payouts before switching" / „Finish 2 cut-off tasks before switching").

Pending-Anfragen werden bei einem Wechsel NICHT gelöscht — sie sind modusagnostisch. Neue Genehmigungen nach dem Wechsel verwenden den neuen Modus. Silver-Bank-Guthaben werden bei einem Moduswechsel NIEMALS gelöscht — die Bank ist ein dauerhaftes Hauptbuch, unabhängig vom regear-Modus. Mitglieder können das angesammelte silver behalten und jederzeit abheben, selbst wenn du zurück auf Item-Rückgabe umschaltest.

Overcharge sitzt neben regear, nicht darunter

Overcharge (OC) ist ein eigener Anfragetyp für verbrauchte Items (nicht in einem Tod verloren) — typischerweise food, potion oder siphon-bezogene Items, die das Mitglied während eines Events aufgebraucht hat. OC hat einen eigenen Tab in #Request Regear („Overcharge") und eine eigene Berechtigung („Request Overcharge").

Die OC silver-Auszahlung verwendet immer die Sum-by-Item-Price-Logik, unabhängig davon, welchen silver-Untermodus die Gilde gewählt hat. War-Role-Obergrenzen gelten nicht für OC, weil OC pro-Item ist, nicht pro-Tod. Unter der silver-Modus-Regel (Item Price EIN) ist OC silver-Auszahlung automatisch verfügbar, sobald die Gilde in irgendeinem silver-Untermodus ist.

OC im Item-Modus: verbrauchte Items werden über denselben Cut-off-+-locker-Pfad zurückgegeben wie regulärer regear nach einem Tod.

Berechtigungen auf einen Blick

Lies die Permissions-Referenz für die komplette Berechtigungsliste. Gates der regear-Pipeline:

Aktion	Berechtigung (Label wie unter Edit Role → Permissions)
Tod-regear einreichen	Request Death Regear
Overcharge einreichen	Request Overcharge
Prüfen + genehmigen / ablehnen	Approve Regear Requests
Einen Cut-off Task packen (Item-Modus)	Claim Cut-off Tasks
Cut-off Tasks beaufsichtigen	Supervise Cut-off Tasks
locker verwalten	Manage Lockers

Mitglieder können ihre eigenen Tode + Anfragen + locker dank der beiden oben genannten Selbstbedienungsberechtigungen immer sehen — es gibt keinen separaten Schalter „eigene Tode ansehen".

Wie es weitergeht

• Für die Einreichseite: Mitglieder — einen regear einreichen
• Für die Prüfseite: Staff — prüfen + genehmigen / ablehnen
• Für die Item-Modus-Auslieferung: Item-Modus — Cut-off + locker
• Für die Silver-Modus-Auslieferung: Silver-Modus — Auszahlung aus der Silver Bank
• Für die Audit-Seite: Member Regear Report