Pepper Game Night

12 party and board games with lobbies and AI opponents at game tables in your world, optional stakes, for ESX, QBCore and Qbox.

Overview

Pepper Game Night brings 12 games to your server: board, card, dice and party games with one shared lobby and AI players. Players sit at game tables in the world or at a table from the game box. The character sits at the table while the game runs in an interface.

The games

Requirements

Installation

1. Download the resource from the Cfx.re Portal (Granted Assets)
2. Extract it to resources/[pepper]/pepper_gamenight – do not rename it, the item export pepper_gamenight.… depends on the folder name
3. Add the game box item (optional):

Copy the image from install/images/ to your inventory's image folder. 4. Database: the script creates its tables on start. Only if your DB user has no CREATE permission, import install/pepper_gamenight.sql first 5. Add it to server.cfg after the dependencies and grant the admin permission:

ensure oxmysql
ensure ox_lib
ensure es_extended      # or qb-core / qbx_core
# ensure ox_target      # optional
# ensure ox_inventory   # optional, for the game box
ensure pepper_gamenight

add_ace group.admin pepper_gamenight.admin allow

6. Start the server – the console shows Pepper Game Night v1.0.0 started (…, 0 tables)

First test

1. As admin stand where the table centre should be, /spieleadmin → New table, save
2. Press E at the table (or use ox_target): the game hub opens
3. Create lobby, e.g. Four Up, add an AI in the waiting room and Start round
4. Finish the round – /spielestats then shows your stats

Configuration

Name, seats, table model, allowed games, jobs and stake limits of a table are not in the config – you set them in game with /spieleadmin.

Basics

Games and turn time

Every game can be turned off; turnTime sets the seconds per turn (10 to 300). A game missing from the list is on.

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

IDs: race (Way Home), checkers, mill, four, shed (Last Card), swim, dice5 (Pepper Dice), liar (Bluff Dice), hangman (Word Hunt), quiz, categories, draw. quiz, categories and draw use their own phase timers.

Lobby, round and AI

Stakes

Game box, tables, display

Webhooks

In config/server.lua ('' = off): admin (table created, changed, deleted), rounds (every ranked round), money (only rounds with stakes). Webhooks contain names only, never player identifiers.

Placing tables

Stand where the table centre should be. Your facing direction becomes seat 1. /spieleadmin → New table, choose name and seats, save. If suitable furniture already exists, turn off Spawn table and Spawn chairs. Per table you can limit the games and set stakes with a minimum and maximum.

Under Jobs only enter job names separated by commas – empty means: for everyone.

How to play

1. Press E at the table or use ox_target. The hub shows lobbies nearby.
2. Create lobby: pick a game, optionally a private lobby with a PIN.
3. In the waiting room set seats, rules and stake, add AI or invite players.
4. Start round. After the result, continue with "Play again" or "Other game".

Hide closes the interface while the character stays seated. Return via the key at the table or /spiele. Invites are accepted in the hub (/spiele).

Playing for stakes

The creator picks For money and the amount in the waiting room. Rules:

• At least 2 humans, no AI. Nobody can win money against the AI.
• Money is taken right before the start. If someone can't pay, the round doesn't start and everyone keeps their money.
• Whoever leaves mid-round loses their stake. The replacement AI wins nothing, its share goes to the next human.
• If the round is aborted (error, admin, restart, last human leaves), all stakes are returned.
• Offline players receive their money the next time their character loads.

Stakes are off at the game box by default (Config.Stakes.AllowBox).

Your own questions and words

data/quiz.<language>.json: entries with id, cat (geo, hist, sci, cult, sport, life), q and a. The first answer is the right one, the game shuffles them. data/words.<language>.json: hangman (A–Z only), draw, categories.

Commands and permissions

Commands

The names of the first four are in Config.Commands – '' turns a command off.

Permissions

There is exactly one permission: admin = ACE pepper_gamenight.admin or a group from Config.AdminGroups (admin, superadmin, god). The server checks it again on every admin call.

Keys

Exports and events

Exports (server, read-only)

exports.pepper_gamenight:isPlaying(src)   -- is the player in a lobby or round?
exports.pepper_gamenight:getTables()      -- list of tables (empty while the script is starting)

Server event pepper_gamenight:roundFinished

Fired on the server after every finished round – e.g. for your own XP or achievement scripts. Clients can neither see nor trigger it.

AddEventHandler('pepper_gamenight:roundFinished', function(data)
    if not data.ranked then return end -- only rounds with at least 2 humans
    for _, p in ipairs(data.players) do
        if not p.bot and p.place == 1 then
            print(p.name .. ' won ' .. data.game)
        end
    end
end)

Framework integration

The open bridges in bridge/ detect ESX, QBCore and Qbox automatically. The house cut goes to esx_addonaccount, Renewed-Banking or qb-banking if ServerConfig.HouseAccount is set; otherwise it leaves circulation.

Troubleshooting

FAQ

Are tables included?

No. An admin places them in game with /spieleadmin. The script spawns table and chairs, or you use existing furniture.

Can I play alone?

Yes, with AI players in 10 of the 12 games. Pepper Dice and Quiz Night can also be started by a single player. City, Country, Pepper and Scribble Guess need humans.

Can players farm money against the AI?

No. Stakes need at least 2 humans and no AI. If a player leaves a round with stakes, the replacement AI wins nothing.

What happens to stakes after a crash or restart?

Stakes are stored in the database before the start. After an abort, crash or restart they are refunded; offline players get the money the next time their character loads.

Can players read hidden cards or quiz answers?

Dice, cards, moves and money are decided by the server. Hidden cards and quiz answers never reach a client early, and the quiz files in data/ stay on the server.

/spieleadmin says "You don't have permission".

Add add_ace group.admin pepper_gamenight.admin allow to your server.cfg or put your group into Config.AdminGroups.

The game box does nothing.

The gamenight_box item must be registered in your inventory – with ox_inventory including the server.export from install/ox_items.lua. Config.Box.Enabled must be true; inside restricted zones (Config.Box.NoGoZones) no box can be placed.

Can I use existing furniture or an MLO?

Yes. Stand in the middle of the table when creating it and turn off Spawn table and Spawn chairs. If chairs face the wrong way, use Config.Table.ChairHeadingOffset.

Can I restrict a table to certain jobs?

Yes. Enter the job names under Jobs only in /spieleadmin, separated by commas. Empty means: for everyone.

Can I change the turn time?

Yes, per game with turnTime in Config.Games (10 to 300 seconds). Quiz Night, City, Country, Pepper and Scribble Guess use their own phase timers.

Can I set a key for the hub?

Yes. Config.Keys.Open sets a default, e.g. 'F6'. With '' every player sets their own key in the GTA key bindings.

Can I give XP for wins?

Yes, with the server event pepper_gamenight:roundFinished (see "Exports and events"). data.ranked is only true for rounds with at least 2 humans.

Can I add my own quiz questions or translate it?

Questions and words are in data/quiz.<language>.json and data/words.<language>.json – in the quiz the first answer is the right one. For a new language copy locales/en/, translate it, add matching files to data/ and set Config.Locale.

How do I install an update?

Download the new version from the Cfx.re portal (https://portal.cfx.re/assets/granted-assets) and replace the folder – back up config/, data/ and changed locales/ first. Tables and stats live in the database and are kept.

Support

Open a ticket on Discord: https://discord.gg/6NaFJWKDYu (category "Script Support") – link your purchase with /verify first.

Permanently tested on the Pepper Scripts dev server.

Changelog

Current version: 1.0.0 (2026-11-01). All changes are listed on the updates page and in CHANGELOG.md inside the resource.

Found a mistake? Report it on Discord.