> For the complete documentation index, see [llms.txt](https://documentation.madonnestudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.madonnestudio.com/paid-scripts/madonnadmin/configuration/script-configuration/commands-configuration.md).

# Commands Configuration

The commands configuration is located at `config/module/cfg_commands.lua`. It allows you to enable, disable, and rename every in-game command available to staff members.

***

## 🔤 Command Suggestions

```lua
CommandSuggestions = true,
```

If `true`, all enabled commands will display auto-complete suggestions in the FiveM chat box when a staff member starts typing the command.

***

## 📋 Available Commands

### Admin Chat

```lua
AdminChatCommand = {
    Enabled = true,
    Command = "admin",
    ChatColor = {r = 255, g = 255, b = 255},
}
```

Send a private message visible only to online staff members.

| Option      | Description                                      |
| ----------- | ------------------------------------------------ |
| `Enabled`   | Enable or disable the command                    |
| `Command`   | Command name without `/`. Default: `"admin"`     |
| `ChatColor` | RGB color of admin chat messages in the chat box |

***

### Note

```lua
NoteCommand = {
    Enabled = true,
    Command = "note",
}
```

Add a private internal note to a player's profile. Notes are visible only to staff on the web dashboard and in the admin panel.

Usage: `/note [ID] [reason]`

***

### Commend

```lua
CommendCommand = {
    Enabled = true,
    Command = "commend",
}
```

Add a positive commendation to a player's sanction history.

Usage: `/commend [ID] [reason]`

***

### Warn

```lua
WarnCommand = {
    Enabled = true,
    Command = "warn",
}
```

Issue a formal warning to a player. The warning is saved to their permanent profile and displayed as a splash message.

Usage: `/warn [ID] [reason]`

***

### Kick

```lua
KickCommand = {
    Enabled = true,
    Command = "kick",
}
```

Remove a player from the server immediately.

Usage: `/kick [ID] [reason]`

***

### Ban

```lua
BanCommand = {
    Enabled = true,
    Command = "ban",
}
```

Ban a player for a specified duration or permanently.

Usage: `/ban [ID] [duration] [reason]`

**Duration examples:** `30m`, `2h`, `7d`, `2w`, `1mo`, `p` (permanent), `c` (community ban)

***

### Go To

```lua
GoToCommand = {
    Enabled = true,
    CanBeUsedOnHigherRank = false,
    Command = "goto",
}
```

Teleport to a player's position.

Usage: `/goto [ID]`

| Option                  | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| `CanBeUsedOnHigherRank` | If `false`, staff cannot teleport to players with a higher rank than themselves |

***

### Bring

```lua
BringCommand = {
    Enabled = true,
    CanBeUsedOnHigherRank = false,
    Command = "bring",
    MultiIds = true,
}
```

Teleport one or several players to your position.

Usage: `/bring [ID]` or `/bring [ID1] [ID2] [ID3]` if `MultiIds` is `true`

***

### Return

```lua
ReturnCommand = {
    Enabled = true,
    CanBeUsedOnHigherRank = false,
    Command = "return",
    MultiIds = true,
}
```

Send a player back to their position before the last teleportation.

Usage: `/return [ID]`

***

### Spectate

```lua
SpectateCommand = {
    Enabled = true,
    CanBeUsedOnHigherRank = false,
    Command = "spectate",
    MultiIds = false,
}
```

Discretely spectate a player from their perspective.

Usage: `/spectate [ID]`

Press `F` in-game to exit spectate mode.

***

> 💡 Custom action buttons defined in `cfg_button.lua` with `EnableCommandForThisButton = true` also register their own commands automatically and will appear as suggestions if `CommandSuggestions` is `true`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.madonnestudio.com/paid-scripts/madonnadmin/configuration/script-configuration/commands-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.