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

  1. Boot banner: the server console shows the SUTY DOMINO banner with the version and Loaded.
  2. Items: give yourself domino_table and domino_case. Both show their image.
  3. Placement: use the table standing. The preview appears and the table is placed with its four chairs.
  4. Sitting: the chair offers Sit down to play dominoes and the sitting animation plays.
  5. Case: seated, use the case. The 28 tiles come out on the table.
  6. 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)

Merry Christmas.

From Suty.