Glücksspielsystem
Das Glücksspielsystem fügt EliteMobs ein voll ausgestattetes Casino hinzu. Spieler können ihre Elite-Münzen bei vier verschiedenen Minispielen einsetzen, Schulden machen, wenn ihnen das Geld ausgeht, und die Konsequenzen tragen, wenn der Schuldeneintreiber vor der Tür steht. Serveradministratoren können jeden Aspekt des Systems konfigurieren, von Auszahlungsmultiplikatoren bis hin zu Schuldengrenzen.
Einrichtung
Auf das Glücksspielsystem wird über speziell konfigurierte NPCs zugegriffen. Jedes Spiel und jede Anzeige hat einen eigenen NPC-Interaktionstyp.
Um einen Glücksspiel-NPC einzurichten, erstellen Sie eine NPC-Konfigurationsdatei und setzen Sie den interactionType auf einen der folgenden Werte:
| Interaktionstyp | Beschreibung |
|---|---|
GAMBLING_BLACKJACK | Öffnet das Wettmenü für Blackjack |
GAMBLING_COINFLIP | Öffnet das Wettmenü für Münzwurf |
GAMBLING_SLOTS | Öffnet das Wettmenü für Spielautomaten |
GAMBLING_HIGHERLOWER | Öffnet das Wettmenü für Höher oder Niedriger |
Der Gambling Den Owner NPC verwendet keinen speziellen Interaktionstyp. Um ihn einzurichten, erstellen Sie einen NPC mit dem Dateinamen gambling_den_owner.yml. Die Anzeige der Hauseinnahmen erscheint automatisch über dem NPC basierend auf diesem Dateinamen.
Spiele
Blackjack
Es gelten die Standard-Blackjack-Regeln. Das Ziel ist es, so nah wie möglich an 21 zu kommen, ohne diese zu überschreiten.
Regeln
- Sowohl der Spieler als auch der Dealer erhalten zwei Karten.
- Die zweite Karte des Dealers ist verdeckt, bis der Spieler stehen bleibt.
- Asse zählen als 11 oder 1 (automatisch angepasst, um ein Überbieten zu vermeiden, wenn möglich).
- Bildkarten (Bube, Dame, König) zählen als 10.
- Der Dealer bleibt bei 17 stehen.
- Spieler können bis zu 5 Karten halten.
Aktionen
| Aktion | Beschreibung |
|---|---|
| Hit | Eine weitere Karte ziehen. |
| Stand | Behalten Sie Ihr aktuelles Blatt; der Dealer spielt dann. |
| Double Down | Verdoppeln Sie Ihren Einsatz, ziehen Sie genau eine Karte und bleiben Sie dann automatisch stehen. Nur bei Ihrer ersten Aktion verfügbar (wenn Sie 2 Karten haben) und nur, wenn Sie es sich leisten können, Ihren Einsatz zu verdoppeln. |
Auszahlungen
| Ergebnis | Standard-Multiplikator |
|---|---|
| Normaler Gewinn (Spieler-Gesamtwert schlägt Dealer oder Dealer überzieht) | 2.0x |
| Blackjack (21 mit den ersten beiden Karten) | 2.5x |
| Push (Unentschieden) | 1.0x (Einsatz zurück) |
| Verlust (Spieler überzieht oder Dealer-Gesamtwert ist höher) | 0x (Einsatz verloren) |
Menü schließen
Wenn ein Spieler das Menü während des Zuges des Dealers schließt, wird das Blatt des Dealers automatisch ausgespielt und das Ergebnis wird aufgelöst. Wenn ein Spieler das Menü schließt, bevor er stehen bleibt, wird der Einsatz verwirkt.
Münzwurf
Ein einfaches 50/50-Spiel. Wählen Sie Kopf oder Zahl, und die Münze entscheidet Ihr Schicksal.
Spielweise
- Das Spiel öffnet sich mit einer Kopf-Schaltfläche und einer Zahl-Schaltfläche.
- Klicken Sie auf eine, um Ihre Wahl zu treffen.
- Eine Münzwurf-Animation wird abgespielt.
- Das Ergebnis wird angezeigt.
Auszahlungen
| Ergebnis | Standard-Multiplikator |
|---|---|
| Richtige Vermutung | 1.9x |
| Kante (Münze landet auf der Kante) | 10.0x |
| Falsche Vermutung | 0x (Einsatz verloren) |
Das Kanten-Ergebnis
Es gibt eine 1% Chance, dass die Münze auf ihrer Kante landet, anstatt auf Kopf oder Zahl. Wenn dies geschieht, gewinnt der Spieler immer, unabhängig von seiner Wahl, und erhält eine 10-fache Auszahlung auf seinen Einsatz. Eine spezielle Chat-Nachricht und visuelle Anzeige werden für dieses seltene Ereignis angezeigt.
Menü schließen
Wenn ein Spieler das Menü schließt, bevor er eine Wahl trifft, wird der Einsatz verwirkt.
Spielautomat
Drehen Sie drei Walzen und passen Sie Symbole an, um zu gewinnen. Seltenere Symbole zahlen mehr.
Spielweise
- Das Spiel öffnet sich mit einem 3x3-Walzen-Raster und einer Drehen-Schaltfläche.
- Klicken Sie auf Drehen, um die Walzen zu starten.
- Jede Walze stoppt nacheinander mit einer Animation.
- Die mittlere Reihe (Gewinnlinie) bestimmt das Ergebnis.
Symbole und Auszahlungen
Jedes Symbol hat eine Gewichtung, die bestimmt, wie oft es erscheint. Der Auszahlungsmultiplikator für das Übereinstimmen von drei Symbolen wird als 100 / Gewichtung berechnet. Das Übereinstimmen von zwei Symbolen zahlt 25% der Drei-Übereinstimmungs-Auszahlung für dieses Symbol.
| Symbol | Gewichtung | Chance | 3-Übereinstimmungs-Auszahlung | 2-Übereinstimmungs-Auszahlung |
|---|---|---|---|---|
| Kirsche | 35 | 35% | 2.86x | 0.71x |
| Zitrone | 28 | 28% | 3.57x | 0.89x |
| Orange | 20 | 20% | 5.0x | 1.25x |
| Goldene Glocke | 10 | 10% | 10.0x | 2.5x |
| Silberbarren | 5 | 5% | 20.0x | 5.0x |
| Glücks-7 | 2 | 2% | 50.0x | 12.5x |
Drei Glücks-7en ist der Jackpot und erhält einen speziellen visuellen und akustischen Effekt.
Menü schließen
Wenn ein Spieler das Menü schließt, bevor er dreht, wird der Einsatz verwirkt.
Höher oder Niedriger
Ein Streak-basiertes Kartenspiel. Raten Sie, ob die nächste Karte höher oder niedriger ist als die aktuelle, und bauen Sie einen Multiplikator auf. Zahlen Sie jederzeit aus oder riskieren Sie alles.
Spielweise
- Eine Karte wird gezogen und angezeigt (Werte reichen von 2 bis 14, wobei Ass = 14).
- Raten Sie, ob die nächste Karte höher oder niedriger sein wird als die aktuelle Karte.
- Wenn Sie richtig raten, erhöht sich Ihr Multiplikator und die aufgedeckte Karte wird zur neuen aktuellen Karte.
- Sie können jederzeit auszahlen, nachdem Sie mindestens eine richtige Vermutung gemacht haben.
- Wenn Sie falsch raten, verlieren Sie Ihren gesamten Einsatz.
- Wenn die nächste Karte gleich der aktuellen Karte ist, zählt dies als Verlust.
Streak-Multiplikator
Jede richtige Vermutung multipliziert Ihre Gewinne mit dem konfigurierten Multiplikator (Standard 1.5x). Der Multiplikator stapelt sich:
| Streak | Multiplikator (Standard) | Auszahlung bei 100 Münzen Einsatz |
|---|---|---|
| 1 | 1.5x | 150 |
| 2 | 2.25x | 225 |
| 3 | 3.375x | 337.5 |
| 4 | 5.0625x | 506.25 |
| 5 | 7.59x | 759 |
| ... | ... | ... |
| 12 | ~129.75x | ~12,975 |
Max Streak und Auto-Auszahlung
Die maximale Streak ist 12. Wenn ein Spieler 12 richtige Vermutungen erreicht, wird er automatisch ausgezahlt und seine Gewinne werden vergeben. Dies verhindert außer Kontrolle geratene Multiplikatoren.
Menü schließen
Wenn ein Spieler das Menü schließt, während er eine Gewinnsträhne hat, wird er automatisch ausgezahlt und erhält seine aktuellen Gewinne. Wenn er schließt, bevor er eine Vermutung gemacht hat, wird der Einsatz verwirkt.
Wetten
Bevor ein Spiel beginnt, wird dem Spieler ein Wettmenü angezeigt, um seinen Einsatz auszuwählen.
Einsatzlimits
| Einstellung | Standardwert |
|---|---|
| Mindesteinsatz | 10 |
| Maximaleinsatz | 1000 |
Wettmenü-Steuerelemente
Das Wettmenü bietet mehrere Steuerelemente:
- Erhöhungs-Schaltflächen -- Drei Größen von Erhöhungs- und Verringerungs-Schaltflächen. Wenn der Spieler mindestens 100 Münzen und keine Schulden hat, sind die Erhöhungen prozentbasiert (5%, 10%, 25% des Guthabens). Andernfalls werden feste Beträge von 10, 50 und 100 verwendet.
- All In -- Setzt den Einsatz auf das Maximum, das sich der Spieler leisten kann (einschließlich verfügbarem Kredit).
- Zurücksetzen -- Setzt den Einsatz auf das Minimum zurück.
- Spielen -- Startet das Spiel mit dem aktuellen Einsatz. Nur aktiv, wenn sich der Spieler den Einsatz leisten kann.
- Abbrechen -- Schließt das Menü ohne zu wetten.
Das Menü zeigt das aktuelle Guthaben des Spielers, etwaige bestehende Schulden und verfügbaren Kredit an.
Schuldensystem
Spieler können über ihr Guthaben hinaus wetten, indem sie Schulden machen. Das Casino gewährt Kredit bis zu einem konfigurierbaren Limit.
Wie Schulden funktionieren
- Wenn ein Spieler einen Einsatz platziert, der sein Guthaben übersteigt, wird der verbleibende Betrag als Glücksspielschuld hinzugefügt.
- Die maximale Schuld, die ein Spieler ansammeln kann, beträgt standardmäßig 500 Münzen.
- Spieler können keine Einsätze platzieren, die ihre Schulden über das Maximum hinausschieben würden.
- Wenn ein Spieler gewinnt, werden seine Gewinne zuerst zur Tilgung der Schulden verwendet, bevor sie seinem Guthaben hinzugefügt werden.
Verfügbarer Kredit
Der verfügbare Kredit eines Spielers wird berechnet als: maxDebt - currentDebt. Dies wird im Wettmenü angezeigt.
Schuldenwarnung
Wenn ein Spieler Schulden macht, erhält er eine Warnmeldung. Der Schuldeneintreiber kann nach ihnen kommen, während sie ausstehende Schulden haben.
Schuldeneintreiber-Boss
Der Schuldeneintreiber ist ein benutzerdefinierter Boss, der spawnt, um Spieler zu jagen, die Glücksspielschulden haben.
Spawn-Bedingungen
- Der Spieler muss ausstehende Glücksspielschulden haben.
- Eine periodische Prüfung läuft alle 60 Minuten (konfigurierbar) für alle Online-Spieler.
- Jede Prüfung hat eine 50% Chance (konfigurierbar), den Schuldeneintreiber für einen berechtigten Spieler zu spawnen.
- Nur ein Schuldeneintreiber kann gleichzeitig pro Spieler aktiv sein.
- Der Schuldeneintreiber verwendet die benutzerdefinierte Boss-Datei
debt_collector.yml.
Level-Skalierung
Das Level des Schuldeneintreibers basiert auf dem Kampflevel des Zielspielers. Seine Gesundheit wird mit einem konfigurierbaren Gesundheitsmultiplikator (Standard 5.0x) und sein Schaden mit einem Schadensmultiplikator (Standard 1.0x) multipliziert.
Verhalten
- Der Schuldeneintreiber spawnt 5 bis 10 Blöcke vom Spieler entfernt.
- Er zielt sofort auf den Spieler, für den er gespawnt wurde.
- Er hat standardmäßig ein Timeout von 600 Sekunden (10 Minuten). Wenn er nicht innerhalb dieser Zeit getötet wird, despawnt er und warnt den Spieler, dass er zurückkehren wird.
Ergebnisse
| Ergebnis | Effekt |
|---|---|
| Spieler tötet den Schuldeneintreiber | Der Boss despawnt. Die Schulden des Spielers werden nicht reduziert, aber er erhält eine Nachricht, dass er zurückkehren wird. |
| Schuldeneintreiber tötet den Spieler | Die Schulden des Spielers werden um 50 Münzen (konfigurierbar) reduziert. Wenn dies die Schulden vollständig tilgt, wird der Spieler benachrichtigt. Der Schuldeneintreiber despawnt nach 5 Sekunden. |
| Timeout (nicht rechtzeitig getötet) | Der Schuldeneintreiber despawnt und sendet eine Warnmeldung. Er wird versuchen, bei der nächsten Prüfung erneut zu spawnen. |
Gambling Den Owner
Der Gambling Den Owner ist ein spezieller NPC, der die Hauseinnahmen über seinem Kopf als schwebende Textanzeige anzeigt. Dies zeigt den Gesamtgewinn oder -verlust an, den das Haus aus allen Glücksspielaktivitäten angesammelt hat.
- Positive Einnahmen werden grün angezeigt (z.B.
+1234.56). - Negative Einnahmen (Spieler gewinnen mehr als sie verlieren) werden rot angezeigt (z.B.
-567.89). - Die Anzeige wird jede Sekunde aktualisiert.
- Hauseinnahmen werden in
house_earnings.ymlgespeichert und überleben Server-Neustarts.
Konfiguration
Alle Glücksspieleinstellungen werden in GamblingSettings.yml gespeichert. Nachfolgend sind die wichtigsten spielbezogenen Einstellungen aufgeführt.
Allgemeine Einstellungen
| Schlüssel | Beschreibung | Standard |
|---|---|---|
gamblingEnabled | Aktiviert oder deaktiviert das gesamte Glücksspielsystem. Wenn deaktiviert, funktionieren Glücksspiel-NPCs nicht und der Schuldeneintreiber wird nicht spawnen. | true |
maxDebt | Maximaler Schuldenbetrag, den ein Spieler durch Glücksspiel ansammeln kann. | 500.0 |
minBet | Mindesteinsatzbetrag für alle Glücksspiele. | 10 |
maxBet | Maximaleinsatzbetrag für alle Glücksspiele. | 1000 |
Auszahlungsmultiplikatoren
| Schlüssel | Beschreibung | Standard |
|---|---|---|
payouts.blackjack.normal | Auszahlungsmultiplikator für einen normalen Blackjack-Gewinn. | 2.0 |
payouts.blackjack.blackjack | Auszahlungsmultiplikator für einen natürlichen Blackjack (21 mit den ersten beiden Karten). | 2.5 |
payouts.coinFlip | Auszahlungsmultiplikator für das Gewinnen eines Münzwurfs. Setzen Sie unter 2.0 für Hausvorteil (1.9 = 5% Hausvorteil). | 1.9 |
payouts.higherLower.multiplier | Multiplikator, der pro richtiger Vermutung in Höher/Niedriger angewendet wird. Stapelt sich multiplikativ. | 1.5 |
Spielautomaten-Auszahlungen
Spielautomaten-Auszahlungen sind nicht konfigurierbar. Sie werden automatisch aus Symbolgewichtungen mit der Formel 100 / Gewichtung berechnet:
| Symbol | Gewichtung | 3-Übereinstimmungs-Auszahlung | 2-Übereinstimmungs-Auszahlung |
|---|---|---|---|
| Kirsche | 35 | 2.86x | 0.71x |
| Zitrone | 28 | 3.57x | 0.89x |
| Orange | 20 | 5.0x | 1.25x |
| Glocke | 10 | 10.0x | 2.50x |
| Barren | 5 | 20.0x | 5.00x |
| Glücks-7 | 2 | 50.0x | 12.50x |
Die payouts.slots.*-Schlüssel existieren in GamblingSettings.yml, werden aber nicht von der Spiellogik verwendet. Tatsächliche Auszahlungen sind immer gewichtungsbasiert.
Schuldeneintreiber-Einstellungen
| Schlüssel | Beschreibung | Standard |
|---|---|---|
debtCollector.spawnChance | Chance (0.0 bis 1.0), dass der Schuldeneintreiber bei jeder Prüfung spawnt. | 0.5 |
debtCollector.checkIntervalMinutes | Wie oft (in Minuten) geprüft wird, ob der Schuldeneintreiber für Spieler mit Schulden spawnen soll. | 60 |
debtCollector.timeoutSeconds | Wie lange (in Sekunden) bis der Schuldeneintreiber despawnt, wenn er nicht getötet wird. | 600 |
debtCollector.healthMultiplier | Gesundheitsmultiplikator für den Schuldeneintreiber-Boss. | 5.0 |
debtCollector.damageMultiplier | Schadensmultiplikator für den Schuldeneintreiber-Boss. | 1.0 |
debtCollector.debtReductionOnPlayerDeath | Schuldenbetrag, der reduziert wird, wenn der Schuldeneintreiber den Spieler tötet. | 50.0 |
Wirtschaftssicherheit
Das Glücksspielsystem verwendet ein sicherheitsorientiertes Transaktionsmodell. Alle Einsätze werden abgezogen und Ergebnisse werden finanziell aufgelöst, bevor visuelle Animationen abgespielt werden. Dies verhindert Exploits, bei denen ein Spieler sich mitten in der Animation trennen könnte, um einen Verlust zu vermeiden oder einen Gewinn zu duplizieren. Wenn sich ein Spieler zu irgendeinem Zeitpunkt während oder nach einer Animation trennt, ist sein finanzieller Zustand bereits korrekt.