FAQs

Solutions to frequently asked questions.

♟️ The chess board item does nothing when I use it

Ensure the item name in your inventory matches ChessConfig.Item.name (default: chess_board).

ox_inventory users:

server.export = 'cdev_chess.useChessBoard'

Make sure:

• cdev_chess starts after your framework and inventory

• Check the F8 console for errors

• Enable ChessConfig.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_chess_players

• cdev_chess_match_history

on the first start.

👀 I placed a board but other players cannot see "Play Chess"

If using Target mode:

• Ensure ox_target or qb-target is installed

• They must start before cdev_chess

If using DrawText:

• Players must be within InteractionDistance (default: 2.5m)

Note: Players who join after placement may need a few seconds to sync. Rescan interval: TargetRescanMs (default: 8 seconds).

🧩 The board model or pieces do not load

Ensure the resource contains:

• stream/ folder

• .ytyp file

Default models:

• Board: cdev_chesstable

• Pieces: cdev_chess_*

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

📤 I cannot pick up the board after a game

Only the white player (board owner) or an admin can pick up the table.

Use "Pickup Table" in the match UI.

🔐 Admin commands do not work

Add this ACE permission to your server.cfg:

add_ace group.admin cdev_chess.admin allow

Restart the server after making changes.

🚫 I cannot delete a board — it says "game in progress"

Boards with an active game cannot be deleted.

• Wait for the match to finish

• Or ask players to resign

Players can use "Leave" in the match UI.