FAQs

🔴 The Ludus board item does nothing when I use it

Ensure the item name in your inventory matches LudusConfig.Item.name (default: ludus_board).

ox_inventory users:

consume = 0,
server = {
    export = 'cdev_ludus.useLudusBoard'
}

Make sure:

• cdev_ludus starts after your framework and inventory

• Check the F8 console for errors

• Enable LudusConfig.Debug = true for extra logs

🗄️ Database tables are not created

• Ensure oxmysql is running

• Verify your MySQL connection in server.cfg

The resource automatically creates:

• cdev_ludus_players

• cdev_ludus_match_history

• cdev_ludus_player_history

on the first start. No manual SQL file is required.

👀 I placed a board but other players cannot interact

If using Target mode:

• Ensure ox_target or qb-target is installed

• They must start before cdev_ludus

If using DrawText:

• Players must be within Distances.InteractionDistance (default: 3.5m)

• On-screen hints: [E] play / interact · [G] pick up board (configurable in InteractionOptions.DrawText)

Sync note: Nearby spectators only receive live FX within Sync.interestRadius (default: 6.0m).

🧩 The board model, pawns, or dice do not load

Ensure the resource contains:

• stream/ folder

• cdev_board_game.ytyp (and matching .ydr models)

Default models:

• Board: cdev_board

• Dice: cdev_player_dice

• Pawns: cdev_player_red / blue / green / yellow

⚠️ Do not rename stream files unless you update LudusConfig.Props.

📤 I cannot pick up the board

Only the board owner or an admin can pick up an idle table.

• DrawText: press G (default pickupControlId = 47) while near the board

• Target: use the “Pick up board” option

• Or /luduspickup (optional keybind in GTA settings)

Boards in lobby or playing cannot be picked up until the session ends / is closed.

🔐 Admin commands do not work

Add this ACE permission to your server.cfg (or Qbox permissions.cfg):

add_ace group.admin cdev_ludus.admin allow

Restart the server after making changes.

🚫 I cannot delete a board game in progress

Boards with an active match cannot be deleted.

• Wait for the match to finish

• Or ask players to leave / forfeit

Admins can manage idle boards via /ludusadmin or /ludusdelete.

💰 Stake error / “outside the allowed range”

Wagers must be between Betting.MinStake and Betting.MaxStake (defaults: 100 – 100000).

The lobby UI shows an in-menu error banner. Adjust stakes or raise MaxStake in config.lua.

🃏 Chip stacks look wrong or missing

• Chip stacks only appear when wager is enabled (unless Props.Chips.showWithoutWager = true)

• Casino chip models (vw_prop_chip_*) require the Diamond Casino DLC assets; otherwise the fallback cash pile is used

• Recalibrate height with /ludusbalance if chips float or clip

📐 Pawns / dice are misaligned on the board

Use /ludusbalance (admin) near a placed board to calibrate layout layers, then save. Overrides are written to public/shared/layout_override.json.

♻️ Boards disappear after server restart

Placed boards are in-memory only (not saved to the database). After a restart, players/admins must place boards again (ludus_board item or /ludusplace).

Player ranking, history, and profiles are persisted in MySQL.

​PreviousIntegrationsNext - FiveM ResourcescDev ChessLast modified 22d ago