Pepper Game Night

12 Gesellschaftsspiele mit Lobby und KI-Mitspielern an Spieltischen in der Welt, optional um Einsatz, für ESX, QBCore und Qbox.

Überblick

Pepper Game Night bringt 12 Gesellschaftsspiele auf deinen Server: Brett-, Karten-, Würfel- und Party-Spiele mit einer gemeinsamen Lobby und KI-Mitspielern. Gespielt wird an Spieltischen in der Welt oder an einem Tisch aus der Spielebox. Die Spielfigur sitzt am Tisch, das Spiel läuft in einer Oberfläche.

Die Spiele

Voraussetzungen

Installation

1. Ressource im Cfx.re-Portal (Granted Assets) herunterladen
2. Nach resources/[pepper]/pepper_gamenight entpacken – nicht umbenennen, der Item-Export pepper_gamenight.… hängt am Ordnernamen
3. Für die Spielebox das Item eintragen (optional):

Das Bild aus install/images/ in den Bilderordner deines Inventars kopieren. 4. Datenbank: Die Tabellen legt das Script beim Start selbst an. Nur wenn dein DB-Benutzer kein CREATE-Recht hat, vorher install/pepper_gamenight.sql importieren 5. In der server.cfg nach den Abhängigkeiten eintragen und das Admin-Recht vergeben:

ensure oxmysql
ensure ox_lib
ensure es_extended      # bzw. qb-core oder qbx_core
# ensure ox_target      # optional
# ensure ox_inventory   # optional, für die Spielebox
ensure pepper_gamenight

add_ace group.admin pepper_gamenight.admin allow

6. Server starten – in der Konsole steht Pepper Game Night v1.0.0 gestartet (…, 0 Tische)

Erster Test

1. Als Admin an die Stelle stellen, an der die Tischmitte sein soll, /spieleadmin → Neuer Tisch, speichern
2. Am Tisch E drücken (oder ox_target): die Spiele-Zentrale öffnet sich
3. Lobby erstellen, z. B. Viererreihe, im Warteraum eine KI hinzufügen und Runde starten
4. Runde zu Ende spielen – /spielestats zeigt danach deine Statistik

Konfiguration

Name, Plätze, Tischmodell, erlaubte Spiele, Jobs und Einsatz-Grenzen eines Tisches stehen nicht in der Config, sondern werden im Spiel mit /spieleadmin eingestellt.

Grundlagen

Spiele und Zugzeit

Jedes Spiel lässt sich ausschalten; turnTime legt die Sekunden je Zug fest (10 bis 300). Fehlt ein Spiel in der Liste, ist es an.

Config.Games = {
    checkers = { enabled = true, turnTime = 60 },
    shed = { enabled = false },
}

IDs: race (Heimweg), checkers, mill, four, shed (Letzte Karte), swim, dice5 (Pfefferwurf), liar (Mäxchen), hangman (Wortjagd), quiz, categories, draw. Für quiz, categories und draw gelten eigene Phasen-Zeiten.

Lobby, Runde und KI

Einsätze

Spielebox, Tische, Anzeige

Webhooks

In config/server.lua ('' = aus): admin (Tisch angelegt, geändert, gelöscht), rounds (jede gewertete Runde), money (nur Runden mit Einsatz). Webhooks enthalten nur Namen, nie Spieler-Identifier.

Tische anlegen

Stell dich an den Ort, an dem die Tischmitte sein soll. Deine Blickrichtung wird Platz 1. /spieleadmin → Neuer Tisch, Name und Plätze wählen, speichern. Steht schon passendes Mobiliar dort, schalte Tisch erzeugen und Stühle erzeugen aus. Je Tisch lassen sich Spiele beschränken und Einsätze mit Mindest- und Höchstwert einstellen.

Unter Nur für Jobs trägst du Jobnamen getrennt durch Komma ein – leer bedeutet: für alle.

So wird gespielt

1. Am Tisch E drücken oder per ox_target öffnen. Die Zentrale zeigt Lobbys in der Nähe.
2. Lobby erstellen: Spiel wählen, optional private Lobby mit PIN.
3. Im Warteraum Plätze, Regeln und Einsatz einstellen, KI hinzufügen oder Spieler einladen.
4. Runde starten. Nach dem Ergebnis geht es mit „Nochmal“ oder „Anderes Spiel“ weiter.

Ausblenden schließt die Oberfläche, die Figur bleibt sitzen. Zurück per Taste am Tisch oder /spiele. Eine Einladung nimmt man in der Zentrale an (/spiele).

Spielen um Einsatz

Der Ersteller wählt im Warteraum Um Geld und den Betrag. Regeln:

• Mindestens 2 Menschen, keine KI. Gegen KI lässt sich kein Geld gewinnen.
• Abgebucht wird direkt vor dem Start. Kann jemand nicht zahlen, startet die Runde nicht und alle behalten ihr Geld.
• Wer während der Runde geht, verliert seinen Einsatz. Die Ersatz-KI gewinnt nichts, ihr Anteil geht an den nächsten Menschen.
• Bricht die Runde ab (Fehler, Admin, Neustart, letzter Mensch geht), gehen alle Einsätze zurück.
• Wer offline ist, bekommt sein Geld beim nächsten Laden des Charakters.

An der Spielebox sind Einsätze standardmäßig aus (Config.Stakes.AllowBox).

Eigene Fragen und Wörter

data/quiz.<sprache>.json: Einträge mit id, cat (geo, hist, sci, cult, sport, life), q und a. Die erste Antwort ist die richtige, das Spiel mischt selbst. data/words.<sprache>.json: hangman (nur A–Z), draw, categories.

Befehle und Rechte

Befehle

Die Namen der ersten vier stehen in Config.Commands – '' schaltet einen Befehl aus.

Rechte

Es gibt genau ein Recht: Admin = ACE pepper_gamenight.admin oder eine Gruppe aus Config.AdminGroups (admin, superadmin, god). Der Server prüft es bei jedem Admin-Aufruf neu.

Tasten

Exports und Events

Exports (Server, nur lesend)

exports.pepper_gamenight:isPlaying(src)   -- sitzt der Spieler in einer Lobby oder Runde?
exports.pepper_gamenight:getTables()      -- Liste der Tische (leer, solange das Script startet)

Server-Ereignis pepper_gamenight:roundFinished

Wird nach jeder beendeten Runde auf dem Server ausgelöst – z. B. für eigene XP- oder Erfolgs-Scripts. Clients können es weder sehen noch auslösen.

AddEventHandler('pepper_gamenight:roundFinished', function(data)
    if not data.ranked then return end -- nur Runden mit mindestens 2 Menschen
    for _, p in ipairs(data.players) do
        if not p.bot and p.place == 1 then
            print(p.name .. ' hat ' .. data.game .. ' gewonnen')
        end
    end
end)

Framework-Anbindung

Die Bridges in bridge/ (offen) erkennen ESX, QBCore und Qbox automatisch. Der Hausanteil geht an esx_addonaccount, Renewed-Banking oder qb-banking, wenn ServerConfig.HouseAccount gesetzt ist; sonst verlässt er den Umlauf.

Fehlerbehebung

FAQ

Sind Tische dabei?

Nein. Ein Admin stellt sie im Spiel mit /spieleadmin auf. Tisch und Stühle erzeugt das Script, oder du nutzt vorhandenes Mobiliar.

Kann man allein spielen?

Ja, mit KI-Mitspielern in 10 der 12 Spiele. Pfefferwurf und Quizabend lassen sich auch von einem Spieler starten. Stadt, Land, Pfeffer und Kritzelraten brauchen Menschen.

Kann man gegen die KI Geld farmen?

Nein. Einsätze brauchen mindestens 2 Menschen und keine KI. Geht ein Spieler während einer Runde mit Einsatz, gewinnt die Ersatz-KI nichts.

Was passiert mit Einsätzen nach einem Absturz oder Neustart?

Einsätze stehen vor dem Start in der Datenbank. Nach Abbruch, Absturz oder Neustart werden sie erstattet; wer offline ist, bekommt das Geld beim nächsten Laden des Charakters.

Können Spieler verdeckte Karten oder Quizlösungen auslesen?

Würfel, Karten, Züge und Geld entscheidet der Server. Verdeckte Karten und Quizlösungen erreichen keinen Client vorzeitig, die Quizdateien in data/ bleiben auf dem Server.

/spieleadmin sagt „Dafür fehlt dir das Recht“.

Die ACE-Zeile add_ace group.admin pepper_gamenight.admin allow in die server.cfg eintragen oder deine Gruppe in Config.AdminGroups aufnehmen.

Die Spielebox tut nichts.

Das Item gamenight_box muss in deinem Inventar eingetragen sein – bei ox_inventory mit dem server.export aus install/ox_items.lua. Außerdem muss Config.Box.Enabled = true sein; in Sperrzonen (Config.Box.NoGoZones) lässt sich keine Box aufstellen.

Kann ich vorhandene Möbel oder eine MLO nutzen?

Ja. Stell dich beim Anlegen in die Tischmitte und schalte Tisch erzeugen und Stühle erzeugen aus. Stehen Stühle verkehrt herum, hilft Config.Table.ChairHeadingOffset.

Kann ich einen Tisch auf bestimmte Jobs beschränken?

Ja. Trag die Jobnamen unter Nur für Jobs in /spieleadmin ein, getrennt durch Komma. Leer bedeutet: für alle.

Kann ich die Zugzeit ändern?

Ja, je Spiel mit turnTime in Config.Games (10 bis 300 Sekunden). Quizabend, Stadt, Land, Pfeffer und Kritzelraten nutzen eigene Phasen-Zeiten.

Kann ich eine Taste für die Zentrale festlegen?

Ja. Config.Keys.Open legt eine Vorbelegung fest, z. B. 'F6'. Mit '' setzt jeder Spieler seine Taste in den GTA-Tastenoptionen selbst.

Kann ich für Siege XP vergeben?

Ja, mit dem Server-Ereignis pepper_gamenight:roundFinished (siehe „Exports und Events“). data.ranked ist nur bei Runden mit mindestens 2 Menschen true.

Kann ich eigene Quizfragen ergänzen oder übersetzen?

Fragen und Wörter stehen in data/quiz.<sprache>.json und data/words.<sprache>.json – im Quiz ist die erste Antwort die richtige. Für eine neue Sprache kopierst du locales/en/, übersetzt es, legst die passenden Dateien in data/ an und setzt Config.Locale.

Wie spiele ich ein Update ein?

Neue Version im Cfx.re-Portal (https://portal.cfx.re/assets/granted-assets) herunterladen und den Ordner ersetzen – vorher config/, data/ und angepasste locales/ sichern. Tische und Statistik liegen in der Datenbank und bleiben erhalten.

Support

Ticket im Discord öffnen: https://discord.gg/6NaFJWKDYu (Kategorie „Script Support“) – den Kauf vorher mit /verify verknüpfen.

Permanent auf dem Dev-Server von Pepper Scripts getestet.

Changelog

Aktuelle Version: 1.0.0 (2026-11-01). Alle Änderungen stehen auf der Updates-Seite und in CHANGELOG.md in der Ressource.

Fehler gefunden? Melde ihn im Discord.