Dominó Game
Troubleshooting
Troubleshooting
See what the script is doing
Set Config.Debug = true in shared/config.lua and run restart suty-domino. The server console and each player's F8 console then show what happens: detected framework, inventory and target, placements, actions and refusals. Turn it back to false afterwards.
Common issues
Messages are quoted from the English locale. With the default Config.Locale = 'es', players see the Spanish version of the same text.
| Symptom | Fix |
|---|---|
Boot fails with FATAL: resource must be named "suty-domino" |
You renamed the folder. Rename it back to exactly suty-domino. |
The resource doesn't start because of ox_lib |
ox_lib is missing or starts after the domino. Move ensure ox_lib above ensure suty-domino. |
| Nobody can sit: «No se pudo iniciar la animación de sentado» / «Could not start the sitting animation.» | The game build is too old. Add sv_enforceGameBuild 2545 (or newer) to server.cfg and restart the server. With Config.Debug = true the console and F8 warn about it. |
| Chairs and table show no target options | ox_target or qb-target must start before the domino, with Config.Target = 'auto' (or the one you use). |
| Using an item does nothing (ox_inventory) | The entry needs client.export = 'suty-domino.useTable' / 'suty-domino.useCase', the folder must be named suty-domino, and the server must have restarted after adding the items. |
| Using an item does nothing (qb-inventory) | Entries in qb-core/shared/items.lua with unique = true and useable = true, qb-inventory started before the domino, Config.Inventory = 'auto' or 'qb'. |
| Using an item does nothing (qs-inventory) | qs-inventory started before the domino, entries with useable = true and no client.export, Config.Inventory = 'auto' or 'qs'. On ESX, es_extended must hand its inventory to qs-inventory (see Quasar's guide). |
| The table or the case is consumed twice / disappears | Keep consume = 0 and stack = false (ox_inventory) or unique = true (qb / qs), and don't register another usable item for these names. |
| A table or case loses its data (rules, tile style) | The item stacks. Use stack = false (ox_inventory) or unique = true (qb-inventory / qs-inventory). |
| The item image doesn't show | Copy the PNGs from install/ox_inventory/images/ to your inventory's image folder with the exact image name. |
| «Pack up your current table before placing another» | Each player can have one table at a time. Find yours on the map as «Your domino table». |
| The table can't be placed | Stand up, get out of the vehicle, aim at flat ground with room for every chair, leave space from other tables, and check the server table limit (Config.Deal.maxTables). |
| «There are already too many active tables» | The server reached Config.Deal.maxTables (8 max). Admins can delete unoccupied tables with /dominolimpiarmesas (items are not returned). |
| The case can't be used | You must be seated, the table must have no other case on it, and no inventory change may be pending in the panel. |
| A match is stuck waiting for players | Someone left mid-match: sit in their chair to take their tiles, or the table owner uses Add bot or Stop match. |
/dominodiseno doesn't open |
The player isn't an admin for the current character (see Installation → Admin access), or the command was renamed and the resource wasn't restarted. |
| A custom table image doesn't load | Use a direct public HTTPS link to the image file (not a gallery page), on a host allowed by Config.Artwork.allowedHosts. |
You changed config.lua but the old value stays |
That value is saved in the panel, which has priority. Change it in /dominodiseno → Settings. Don't wipe the server KVP to reset one setting. |
| A new default key doesn't apply | Players keep their own bindings in GTA Settings → Key Bindings → FiveM. |
| QB-Core sees the admin but the inventory fails (ox_inventory) | Your ox_inventory QB bridge must use the right character identifier. Selecting QBX doesn't fix it. |
| ESC doesn't open the pause menu | While you hold a drink, ESC puts the drink away instead. Press ESC again once your hands are empty. |
| Drinks don't fill thirst on ESX | Thirst on ESX goes through esx_status. Make sure it's running. |
Verifying the install
- Boot banner: the server console shows the SUTY DOMINO banner with the version and
Loaded. - Items: give yourself
domino_tableanddomino_case. Both show their image. - Placement: use the table standing. The preview appears and the table is placed with its four chairs.
- Sitting: the chair offers Sit down to play dominoes and the sitting animation plays.
- Case: seated, use the case. The 28 tiles come out on the table.
- Pack up: Put tiles away, then Pack up table. Each item comes back exactly once, with its data.
Reporting a bug
Open a ticket on Discord with:
- Your framework and inventory, with their versions
- The full console / F8 error, ideally with
Config.Debug = true - Steps to reproduce, and whether it happens with real players or with bots
- Your
shared/config.lua(never send license keys or database credentials)
