> ## Documentation Index
> Fetch the complete documentation index at: https://docs.awokenlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands

> In-game commands and ace permission setup.

## Ace permission setup

Add this line to your `server.cfg` to grant your admin group access to the admin panel
and the scene creator:

```cfg server.cfg theme={"dark"}
add_ace group.admin awoken.admin allow
```

`awoken.admin` gates the admin panel (the panel won't even open without it - the command asks
the server first) and the scene creator by default. The scene creator's ace can be changed via
`Config.SceneCreator.AcePermission` in `config_scenecreator.lua`.

***

## Player commands

| Command   | Description                                                                                                         |
| --------- | ------------------------------------------------------------------------------------------------------------------- |
| `/logout` | Returns the player to the character select screen. Disable it server-wide with `Config.EnableLogoutCommand = false` |

***

## Admin commands

These are permission-checked server-side and do nothing for regular players.

| Command         | Ace required                                                 | Description                        |
| --------------- | ------------------------------------------------------------ | ---------------------------------- |
| `/awokenadmin`  | `awoken.admin`                                               | Opens the admin panel              |
| `/scenecreator` | `Config.SceneCreator.AcePermission` (default `awoken.admin`) | Opens the in-game scenario creator |

### Scene creator helpers

Only work while the scene creator is open:

| Command     | Default key | Description                                     |
| ----------- | ----------- | ----------------------------------------------- |
| `/scnoclip` | N           | Toggle noclip flight while scouting a location  |
| `/scfocus`  | F5          | Toggle between the panel (cursor) and walk mode |

The scene creator frames a camera, captures a ped spot + animation + time/weather/DOF,
previews the exact select-screen render, then exports a ready-to-paste scenario entry
for `config.lua`.

***

## Admin panel - slot overrides

Opening `/awokenadmin` shows all connected players and their characters. You can add or remove
character slots for any player directly from the panel using the + and - buttons.

**How overrides fit into the slot priority order:**

1. `Slots.List` in `config_slots.lua` - per-license manual override, always wins
2. Admin panel override - set via `/awokenadmin`, stored in the database
3. Discord role - highest `totalSlots` among the player's matching roles
4. `Config.DefaultSlots` - fallback for everyone else

So an admin panel override beats Discord roles but will be ignored for any license that has an
entry in `Slots.List`. The override is capped by `Config.MaxSlots` regardless of what you set.

The override persists across restarts - it is stored in the `multichar_players` table under
`admin_slots`. To clear it, set the player back to `Config.DefaultSlots` using the - button
until the override is removed, or delete the row from `multichar_players` directly.

<Info>
  The admin panel search works on offline players too. Type a name, citizenid, or partial
  identifier and it will pull matching characters from the database.
</Info>