Common Errors

Common Errors — Chess | Quasar Store | Quasar Store

What goes wrong most often, what it actually means, and what to change to fix it. Most of these come down to a permission, the load order, or a table that comes from somewhere other than the creator.

Installation and Access#

"You don't have permission" on /chesscreator

Your identifier does not have the ACE command.chesscreator. Grant it to a group you are in, then restart the server:

bash

add_ace group.admin command.chesscreator allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin

If you renamed the permission in Config.Creator.permission, grant the new name. If you rewrote HasPermission in server/custom/framework/, that function decides, not the ACE.

A table does not appear

Tables render within 45 m (Config.StreamDistance). Closer than that and still missing, the models are not loading: qs-chess streams them itself, so it must be started, and Config.Models must name models that exist. The creator says Failed to load the model. in that case.

There is no [E] prompt at a table

The prompt only shows at a free table, within 2.2 m of its centre (Config.InteractDistance), to a player who is not already seated. If somebody is playing there, wait for the match to end. A map table also has to be detected first — walk right up to it and give it a few seconds.

A table I deleted comes back

It was not a creator table. Tables from Config.Tables are registered again every time a player loads in, and tables from a map every time a player walks near the prop. Remove the config line, or the prop from the map — or set Config.AutoDetect = false if no map table should be playable.

Only some of the tables in my map are playable

Detection registers the closest chess table to each player, every few seconds. In a room full of tables the far ones are picked up as somebody walks past them. To have every one ready from the first second after a restart, open each in the creator and save it — it is then loaded from the database at start.

Moving a map table in the creator left a copy behind

Repositioning saves the table at its new spot, but the prop is still in the map at the old one, so it is detected again there. Move map tables in the map, not in the creator.

Players sit on thin air at a map table

The map has the table but not its chairs. Chess only spawns chairs for tables it spawns itself; a map table needs two chess_chair props in the map — see Map Tables.

My tables did not load after updating

Updating from a version with cx, cy, cz columns runs a one-time migration that rewrites the table with ALTER TABLE. Look for [qs-chess] Migrated N table(s) in the server console. If an SQL error is there instead, the database user lacks the ALTER privilege — grant it and restart.

Message	Means
You don't have enough money to play.	The entry fee or the stake cannot be covered.
That player is busy right now.	They are in a match, or already have an invitation to answer.
You already have a pending challenge.	Wait for the answer, or for it to expire after 30 seconds.
That table is no longer available.	Somebody started a game there first, the table was removed, or the other player could not pay.
Your challenge was declined.	The other player said no, or could not cover the stake.
Your challenge expired.	No answer within 30 seconds.
No players nearby to challenge.	Nobody else is within 15 m of the table.
It's not your turn.	A move was sent during the opponent's turn.
Failed to load the model.	The table model in `Config.Models` is not streamed.
The game has ended.	It ended without a result — most often because an admin deleted the table mid-match. Stakes are refunded.

Common Errors

Installation and Access#

Tables#

Playing#

Money and Bets#

What the Messages Mean#