> For the complete documentation index, see [llms.txt](https://organized-chaos.gitbook.io/organized-chaos-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://organized-chaos.gitbook.io/organized-chaos-docs/chess/commands-and-permissions.md).

# Commands and permissions

The Chess commands and who may use them.

| Command               | Who      | What it does                                                                                                                                                                   |
| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `/chess_stats`        | Everyone | Tells the player their rating with wins, draws and losses                                                                                                                      |
| `/chess_top`          | Everyone | Lists the five best players by rating in the chat                                                                                                                              |
| `/chess_pickup`       | Everyone | Picks up the nearest table the player put up with the table item                                                                                                               |
| `/chess_place [look]` | Admins   | Puts up a table two metres in front of you. You are standing on White's side. With a look of `Config.TableSkins`, for example `/chess_place marble`, the table is in that look |
| `/chess_remove`       | Admins   | Takes away the nearest table that was placed with `/chess_place` or the item                                                                                                   |

The names can be changed in `config.lua` with `Config.CommandStats`, `Config.CommandTop`, `Config.CommandPlace`, `Config.CommandRemove` and `Config.Item.PickUp.Command`.

## Permissions

`/chess_place` and `/chess_remove` are restricted commands. A player needs the ace `command.chess_place` or `command.chess_remove`.

Most servers already have this line in their `server.cfg`, which gives admins every restricted command:

```cfg
add_ace group.admin command allow
```

To give the two commands to another group only:

```cfg
add_ace group.moderator command.chess_place allow
add_ace group.moderator command.chess_remove allow
```

If you rename a command, the ace changes with it: `command.<new name>`.

`/chess_pickup` is for everyone, but only takes down a table of the table item, by default only the player's own, and never while someone sits there. See [Table item](/organized-chaos-docs/chess/table-item.md).

Looks kept for VIPs use aces of your own choice as well, for example `add_ace group.vip chess.vip allow`. See [Board, pieces and sounds](/organized-chaos-docs/chess/board-pieces-and-sounds.md).

## Placed tables

Tables placed in game, with the command or the item, are saved in `tables.json` with their look and come back after a restart. `/chess_remove` only removes those tables; a table of the item is then not given back as an item. A table from `Config.Tables` is removed by deleting its line in `config.lua`.
