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 |
