Dominó Game

Configuration

Configuration

Files you can edit

File What is in it
shared/config.lua Every setting on this page
locales/es.lua, locales/en.lua Every text players see
beer/*.json Model and hand-grip data for the drinks. You don't need to edit it

These files are not encrypted. Edit the existing entries; don't paste a second Config table at the end of the file.

The in-game panel wins. Most options can also be changed in game with /dominodiseno → Settings (admins). Values saved there take priority over shared/config.lua and survive restarts. If you change config.lua and nothing happens, change that value in the panel instead.

Framework, target, inventory

Config.Framework = 'auto'   -- 'auto' | 'qbx' | 'qb' | 'esx'
Config.Target    = 'auto'   -- 'auto' | 'ox' | 'qb'
Config.Inventory = 'auto'   -- 'auto' | 'ox' | 'qb' | 'qs'
Option auto does Manual values
Config.Framework qbx_core, then qb-core, then es_extended 'qbx', 'qb', 'esx'
Config.Target ox_target if started, otherwise qb-target 'ox', 'qb'
Config.Inventory qs-inventory if started, otherwise ox_inventory / qb-inventory 'ox', 'qb', 'qs'

With Config.Inventory = 'auto' a server can run ox_inventory and qb-inventory together: each table and case goes back to the inventory it was used from. A manual value only uses that inventory. All three options need a resource restart. Use exactly the values above (for example 'ox', not 'ox_inventory').

A manual framework doesn't start or install anything, and doesn't set ox_inventory's inventory:framework convar.

Debug and language

Config.Debug  = false   -- true: the server console and each player's F8 show what the script is doing
Config.Locale = 'es'    -- 'es' (Spanish) | 'en' (English)

Config.Debug is file-only: the panel doesn't change it. With false, nothing is printed except the startup banner. Spanish is the fallback for missing keys in any locale.

Items

Config.TableItem = {
    name = 'domino_table',
    gizmoKey = 'H',          -- switches between the placement preview and the gizmo
}
Config.Case = { item = 'domino_case' }

The names must match your inventory items. Renaming an item doesn't migrate the units players already own: pack up every table and case first.

Game rules

New tables copy these rules. The table owner can change them per table with the target option Rules for this table before a match starts.

Config.Game = {
    mode = 'auto',
    target = 200,
    capicuBonus = 50,
    chuchaBonus = 0,
    passBonus = 0,
    openingBonuses500 = false,
    fourPlayerMode = 'ask',
    turnSeconds = 30,
    turnTimeout = 'pass',
}
Config.Deal = { minimumMixMs = 10000, maxTables = 8 }
Option Default What it changes
mode 'auto' auto: 2 seated players play 1 vs 1 (seven tiles each, draw from the pile), 3 play free for all (seven each, seven left to draw), 4 play the mode in fourPlayerMode. Any chairs work, and the lineup locks when the shuffle ends. Force a fixed mode with 'pairs', 'duel' or 'ffa' (they use their classic chairs). File-only, needs a restart
target 200 Points to win the match (10–2000)
capicuBonus 50 Extra points for a non-double capicú. 0 turns it off
chuchaBonus 0 One-sided chucha (0–0) bonus. 0 = off
passBonus 0 Points per pass. Teams: the opposing team scores. Free for all: the next player. Time-outs score nothing. Suggested: 10
openingBonuses500 false When playing to 500, hands 1–4 add 100 / 75 / 50 / 25 points
fourPlayerMode 'ask' With four players: 'ask' (the owner chooses), 'pairs' (2 vs 2) or 'ffa4' (free for all, all 28 tiles dealt)
turnSeconds 30 Seconds to play a turn (0–300). 0 = no limit
turnTimeout 'pass' When time runs out: 'pass' skips the turn, 'play' plays a legal tile automatically
Deal.minimumMixMs 10000 Minimum shuffle time in milliseconds (the panel shows seconds, 1–120)
Deal.maxTables 8 Tables allowed on the server at the same time (1–8). Lowering it doesn't remove tables already placed

Each player can have one placed table at a time.

Sound

Config.Audio = {
    enabled = true,
    distance = 12.0,       -- metres (1-50)
    shuffleVolume = 0.45,  -- 0.0 - 1.0
    impactVolume = 0.75,   -- 0.0 - 1.0
}

Shuffle and tile-impact sounds, heard by players within distance of the table.

Table designs

Config.Artwork = {
    command = 'dominodiseno',
    allowImageUrls = true,
    allowedHosts = {},
}
Option Default What it changes
command 'dominodiseno' Admin command that opens table customization and the Settings panel
allowImageUrls true Lets admins put their own HTTPS image on a table
allowedHosts {} Empty = any public HTTPS host. Otherwise only these exact host names, for example { 'images.example.com' } (no https://, no paths)

Images must be a direct public HTTPS link to the image file itself, not a gallery page. They load on each player's game; the server doesn't host a copy.

Admins

Config.Admin = {
    ace = 'admin',
    qbGroups = { 'admin', 'god' },
    esxGroups = { 'admin', 'superadmin' },
}
Option What it changes
ace ACE permission that makes a player an admin, on every framework
qbGroups QB-Core: QBCore permission groups. QBX: ACE names checked the same way
esxGroups ESX: compared with the player's group

The panel refuses to save a change that would remove your own admin access.

Seated controls

Config.Styles = { command = 'dominofichas' }
Config.Hud = { command = 'dominohud', key = 'H' }
Config.View = {
    fovCommand = 'dominovista', fovKey = 'K', fovSteps = { 50, 60, 70, 80, 90, 100 },
    cameraCommand = 'dominocamara', cameraKey = 'V', thirdDistance = 1.35, thirdHeight = 0.35
}
Option Default What it changes
Styles.command 'dominofichas' Tile and case style menu for the case owner
Hud.command / Hud.key 'dominohud' / H Show or hide your HUD while seated
View.fovCommand / fovKey 'dominovista' / K Cycle the field of view while seated
View.fovSteps 50 … 100 Field-of-view presets the key cycles through
View.cameraCommand / cameraKey 'dominocamara' / V First / third person while seated
View.thirdDistance 1.35 Metres the third-person camera sits behind the head
View.thirdHeight 0.35 Height of the third-person camera

Keys are defaults only: each player can rebind them in GTA Settings → Key Bindings → FiveM, and their choice is kept. Other players' tiles stay hidden in both camera modes.

Drinks

Config.Beer = {
    enabled = true,
    items = { suty_beer_brisa = 'brisa', suty_beer_sol = 'sol', suty_beer_costa = 'costa', ... },
    sixpacks = { suty_sixpack_brisa = 'brisa', suty_sixpack_sol = 'sol', suty_sixpack_costa = 'costa' },
    sixpackBeers = 6,
    thirst = { malta = 45, sprunk = 45, ecola = 45, ..., brisa = 12, sol = 12, costa = 15, ... },
    fullSeconds = 12,
    command = 'dominobeber',        key = 'B',
    standCommand = 'dominobeberpie', standKey = 'E',
    placeCommand = 'dominocolocar',  placeKey = 'G',
}
Option Default What it changes
enabled true Turns the drinks on or off
items 11 drinks Item name → drink style. Names ending in _can are cans with their own opening animation. Keep the styles as shipped
sixpacks 3 six-packs Six-pack item → brand
sixpackBeers 6 Bottles in a new six-pack. What's left is saved in the item
thirst per style Thirst (0–100) a full bottle fills; half a bottle fills half. Beers fill a little and can still be drunk with full thirst. Drinks without alcohol are refused, and put away by themselves, once thirst is full
fullSeconds 12 Seconds of non-stop drinking to empty a full bottle
command / key 'dominobeber' / B Hold to drink at the table (not on your own turn)
standCommand / standKey 'dominobeberpie' / E Standing: open the drink, then hold to drink
placeCommand / placeKey 'dominocolocar' / G Standing: set the drink down on a surface (green preview = it fits)

Standing, the bottle only leaves your hand when it's empty, or when you die or ragdoll: then it stays on the ground with what it had left, for anyone to pick up. In a vehicle it stays in your hand.

Drunk effects

Config.Drunk = {
    enabled = true,
    units = { brisa = 1.0, sol = 1.0, costa = 0.6, malta = 0.0, sprunk = 0.0, ecola = 0.0, ... },
    halfLifeMinutes = 6,
    levels = { tipsy = 1.5, drunk = 3, wasted = 5, smashed = 7 },
}
Option Default What it changes
enabled true Turns drunk effects on or off
units per style Units a full bottle adds (half a bottle adds half). 0 = no alcohol
halfLifeMinutes 6 What you drank halves every this many minutes. With 6, effects end after about 2.5 min (2 beers), 6 min (3), 10 min (5), 13 min (7) or 15.5 min (9)
levels see above Units needed for each level
Level Effects
tipsy Light camera sway and blur, buzzed walk and drunk face
drunk Drunk walk, more sway and blur, the car pulls to one side now and then
wasted Very drunk walk, you stumble and fall now and then while walking
smashed Strongest sway and blur, you fall on your own (even standing) and get back up, the car pulls hard

Your own walk and face come back when it wears off. Admins can sober anyone up with /sobrio (Commands).

Settings panel (/dominodiseno → Settings)

Group Fields
Match Points to win, capicú bonus, chucha bonus, points per pass, 500-point bonuses, four-player mode, turn time, time-out action, minimum shuffle, table limit
Sound On/off, distance, shuffle volume, impact volume
Custom images Allow image links, allowed hosts
Framework and language Framework, language
Inventory items Table item, case item
Default keys Gizmo key, HUD key
Commands Customization command, case-style command, HUD command
Administrators ACE, QB / QBX groups, ESX groups

The panel also turns the HUD widgets The table and Last plays on or off for every table on the server. Players can still hide their whole HUD.

Changes to the framework, language, items, keys, commands and admin settings wait for a restart suty-domino. Don't restart during a match. The panel blocks framework or item-name changes while tables or cases from the inventory are deployed: pack them up first.

Not in the panel (edit shared/config.lua): Config.Game.mode, Config.View, Config.Target, Config.Inventory, Config.Debug, Config.Beer and Config.Drunk.

Quick reference

Want to… Set
Play to 500 Config.Game.target = 500 (or in the panel)
Give points for each pass Config.Game.passBonus = 10
Remove the turn timer Config.Game.turnSeconds = 0
Always play teams with four Config.Game.fourPlayerMode = 'pairs'
Allow fewer tables at once Config.Deal.maxTables = 4
Only allow images from your own host Config.Artwork.allowedHosts = { 'images.example.com' }
Switch the game to English Config.Locale = 'en' (or in the panel)
Turn the drinks off Config.Beer.enabled = false
No drunk effects Config.Drunk.enabled = false
See what the script is doing Config.Debug = true, then restart suty-domino

Merry Christmas.

From Suty.