🎡 Glücksrad — jedes Detail erklärt
Die Preset-Liste
Hub → Events → Glücksrad. Jedes Preset ist eine eigene Rad-Konfiguration mit eigener Preisliste und eigenem Jackpot.
| Element | Funktion |
|---|---|
| Start | öffnet die Rad-Vergabe für dieses Preset (Spieler auswählen). |
| Bearbeiten | öffnet den Preis-Editor. |
| Ticket-Stufe | hinter dem Namen steht in Gold, mit welchem Ticket Spieler dieses Rad selbst einlösen können (siehe Tickets). Ist dieselbe Stufe schon einem Rad weiter oben zugewiesen, wird die Zeile rot und mit „(DOPPELT)“ markiert — dann ist nur das obere Rad erreichbar. |
| Löschen | entfernt das Preset serverseitig. default ist unlöschbar — der Button wird dort ausgeblendet. |
| + Neues Preset | der Server legt ein frisches Preset an und liefert die aktualisierte Liste. |
| Mausrad | scrollt die Liste bei vielen Presets. |
Der Preis-Editor
| Feld | Verhalten |
|---|---|
| Label | Anzeigename in der Gewinn-Meldung („1x Bandage“). Leer → ClassName wird angezeigt. |
| ClassName | Item-Klasse des Gewinns (als Text editierbar). Neue Preise kommen über „Preis hinzufügen“ dazu — das öffnet den Such-Picker, das gewählte Item wird eine neue Zeile. |
| Menge | Stückzahl des Gewinns. Stapelbare Items (Munition, Nägel, Geldscheine …) kommen als gebündelter Stapel, große Mengen als mehrere volle Stapel; alles andere als einzelne Items. Vergabe erst ins Inventar, bei vollem Inventar vor die Füße — ein Gewinn geht nie verloren. |
| Gewicht | Ein gewichteter Zug pro Dreh: Chance = Gewicht ÷ Summe aller Gewichte. Die Summe muss nicht 100 ergeben (ist aber praktisch: dann ist Gewicht = Prozent). |
| Att | Nur bei Waffen sichtbar (live geprüft). Öffnet das Loadout-Panel (unten). Wechselt die Zeile auf eine Nicht-Waffe, bleiben die Attachments in den Daten — nur der Button verschwindet. |
| Jackpot | Toggle + Item + Nachricht mit %player%/%item%. Gewinnt jemand das Jackpot-Item: globaler Broadcast, Jackpot-Sound, Eintrag in jackpots.log. |
| Einlösbar mit Ticket | Durchklick-Auswahl Kein Ticket → Bronze → Silber → Gold → Prestige. Legt fest, mit welchem Ticket Spieler dieses Rad selbst starten können. Gold = vergeben, grau = nur Admin-Vergabe, rot = die Stufe gehört bereits einem anderen Rad (mit Namensnennung in der Statuszeile). |
| Speichern | überträgt die Liste gechunkt in beide Richtungen — auch 100+ Preise speichern zuverlässig. |
Rad vergeben — der Claim-Flow
Admin startet
Preset-Liste → Start → Zielspieler wählen und senden.
Spieler löst ein
Der Spieler bekommt eine Meldung und hat 60 Sekunden, um L zu drücken (STRG+L ist das Boss-Ranking — kein Konflikt). Das Rad öffnet nicht über anderen Menüs/Inventar.
Dreh & Gewinn
Das Rad zeigt Live-3D-Vorschauen der möglichen Preise in den Zellen (Waffen inkl. Loadout). Das Ergebnis entscheidet der Server — die Animation passt sich an, der Client kann nichts beeinflussen. Danach wird der Gewinn vergeben.
Tickets — Spieler lösen das Rad selbst ein
Neben der Admin-Vergabe können Spieler ein Rad mit einem Ticket-Item selbst starten. Es gibt vier Stufen (Bronze, Silber, Gold, Prestige); jede Stufe gehört zu genau einem Rad — zugewiesen im Preis-Editor des jeweiligen Presets.
Ticket in die Hand nehmen
Aktion „Glücksrad ansehen“ auslösen.
Vorschau lesen
Es öffnet sich die Preisliste des zugeordneten Rades — mit 3D-Vorschau, Menge und Gewinnchance in Prozent je Preis. Die Prozente rechnet der Server aus denselben Gewichten, mit denen später gedreht wird.
Einlösen oder abbrechen
Abbrechen lässt das Ticket unangetastet. Erst Einlösen verbraucht ein Ticket (vom Stapel eins) und startet das Rad.
| Regel | Verhalten |
|---|---|
| Wartezeit | Nach dem Rad 15 Sekunden, bevor das nächste Ticket eingelöst werden kann („Bitte noch X s warten“). Während das Rad dreht, geht keine neue Vorschau auf. |
| Ticket ohne Rad | Ist der Stufe kein Preset zugewiesen, meldet der Server „Dieses Ticket gehört zu keinem Rad“ — das Ticket bleibt erhalten. |
| Leeres Rad | Hat das zugewiesene Preset keine Preise, wird ebenfalls nichts verbraucht. |
| Offenes Admin-Angebot | Wartet noch ein per L einzulösendes Rad, wird das Ticket blockiert („Es wartet schon ein Rad auf dich“) — nie zwei Räder gleichzeitig. |
| Server-autoritativ | Der Server liest das Ticket selbst aus der Hand des Spielers; der Client schickt nie eine Item-Klasse mit. |
Wie Spieler an Tickets kommen
Tickets sind ganz normale, stapelbare Items — jedes System, das Items vergibt, kann sie verteilen. Es ist keine zusätzliche Konfiguration im Mod nötig:
- ZYADTrader: Tickets als Angebot einstellen (z. B. gegen ZYAD-Scheine) — der Grind-Kreislauf.
- Mutant-Loot: Ticket-Klasse als Loot-Zeile eintragen, Seltenheit über das Gewicht.
- RaidBases-Loot und Weltloot (
types.xml). - Admin: Tickets direkt spawnen.
Waffen-Loadouts (Att-Panel)
Slot-Zeilen werden aus der Waffen-Config erzeugt (Attachment-Slots + Magazine); pro Slot öffnet eine Suchliste mit ausschließlich kompatiblen Items. Die Live-3D-Vorschau zeigt die Waffe mit der aktuellen Auswahl. Bei der Vergabe montiert der Server das komplette Loadout; ungültige Einträge werden übersprungen, nie gecrasht.
Design-Tipps
- Ein „günstiges“ Rad (Nahrung/Medizin) und ein seltenes „Event“-Rad — genau dafür gibt es Presets.
- Gewichte auf 100 summieren = direkt in Prozent denken.
- Das Jackpot-Item auch als normale Preiszeile eintragen — das Jackpot-Flag steuert nur Broadcast/Sound/Log, nicht die Chance.
- Menge = Stückzahl: Bei stapelbarer Ware also den echten Wunschwert eintragen (Munition „20“, nicht „1“ — sonst gibt es genau eine Patrone).
- Ticket-Stufen als Fortschritt denken: Bronze = Verbrauchsgüter, Gold/Prestige = Chase-Items. Der Zufluss lässt sich über den Trader-Preis und die Drop-Gewichte feiner steuern als über die Preisliste selbst.