> For the complete documentation index, see [llms.txt](https://wiki.incredibleplugins.com/discordbridge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.incredibleplugins.com/discordbridge/setup/discord-configuration.md).

# Discord Configuration

## Discord Configuration

DiscordBridge stores per-Discord-server settings through the Discord `/config` command.

Run these commands inside your Discord server, not in DMs. Use Discord's autocomplete after `/config set` to select the exact key and value type.

Non-list values are set with `/config set <setting> <value-option>`. For example:

```
/config set chat_channel textchannel:#minecraft-chat
```

Values can be removed by running the same `/config set <setting>` command without a value.

List values are managed with their own command groups:

```
/config linking_allowed_roles add role:@Member
/config linking_allowed_roles remove role:@Member
```

## Core Settings

\| Setting | Command shape | Use it for | | --- | --- | | `administrator_role` | `/config set administrator_role role:<role>` | Allows members with this role to configure the Discord bot. Discord administrators can configure it as well. | | `chat_channel` | `/config set chat_channel textchannel:<channel>` | Channel used by the chat module for Discord-to-Minecraft and Minecraft-to-Discord chat. | | `event_channel` | `/config set event_channel textchannel:<channel>` | Channel used by the events module for server and player event messages. |

## Linking Settings

\| Setting | Command shape | Use it for | | --- | --- | | `linking_allowed_roles` | `/config linking_allowed_roles add role:<role>` | Limits account linking to Discord members with one of these roles. Leave empty to allow all members to link. | | `linking_roles` | `/config linking_roles add ingame_permission:<permission> discord_role:<role>` | Gives Discord roles to linked players based on in-game permissions. | | `linking_groups` | `/config linking_groups add discord_role:<role> ingame_group:<group>` | Gives LuckPerms groups in Minecraft based on Discord roles. | | `linking_name_sync_ignore_roles` | `/config linking_name_sync_ignore_roles add role:<role>` | Excludes members with these roles from Discord nickname sync. |

Use the matching `remove` subcommand to remove entries from these lists.

## Lands Settings

\| Setting | Command shape | Use it for | | --- | --- | | `lands_chat_category` | `/config set lands_chat_category category:<category>` | Category where land and nation channels are created. | | `lands_broadcast_channel` | `/config set lands_broadcast_channel textchannel:<channel>` | Channel for Lands broadcast messages, such as land deletions, relationship changes, and war updates. | | `lands_notify_<broadcast_category>` | `/config set lands_notify_<broadcast_category> role:<role>` | Role to mention for one Lands broadcast category. Replace `<broadcast_category>` with the category shown by autocomplete. |

## Ticket Settings

\| Setting | Command shape | Use it for | | --- | --- | | `tickets_category_closed` | `/config set tickets_category_closed category:<category>` | Category where closed tickets are moved before deletion. | | `tickets_creation_channel` | `/config set tickets_creation_channel textchannel:<channel>` | Channel where DiscordBridge posts the ticket creation message. | | `tickets_role_support` | `/config set tickets_role_support role:<role>` | Staff role that can see and work on all tickets. | | `tickets_member_max_tickets` | `/config set tickets_member_max_tickets number:<amount>` | Maximum active tickets per Discord member. | | `tickets_deletion_time` | `/config set tickets_deletion_time time:<time>` | How long closed tickets remain before deletion. Supports `d`, `h`, `m`, and `s`. | | `tickets_remind_submitter` | `/config set tickets_remind_submitter boolean:<true|false>` | Whether the submitter is reminded after staff responds and the submitter has not replied. | | `tickets_staff_unavailable` | `/config set tickets_staff_unavailable text:<message>` | Optional message sent when no support staff is available. |

`tickets_category_open` is deprecated for new setups. Set the open category on each ticket type with `/config type upsert`.

## Ticket Structure Commands

Ticket types decide what users can open. Fields decide what the user must fill out.

| Command                 | What it does                                                                             |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| `/config type upsert`   | Creates or updates a ticket type. This also sets the open-ticket category for that type. |
| `/config type delete`   | Deletes a ticket type.                                                                   |
| `/config field upsert`  | Creates or updates a form field for a ticket type.                                       |
| `/config field delete`  | Deletes a form field from a ticket type.                                                 |
| `/config info create`   | Adds predefined information that staff can request from a ticket submitter.              |
| `/config info delete`   | Deletes predefined requestable information.                                              |
| `/config reason create` | Adds a predefined reason for a ticket action, such as closing a ticket.                  |
| `/config reason delete` | Deletes a predefined reason.                                                             |

## Recommended Setup Order

1. Set `administrator_role`.
2. Configure the channels and roles needed by the modules you enabled.
3. If tickets are enabled, create ticket types and fields.
4. Set `tickets_creation_channel` with `/config set tickets_creation_channel textchannel:<channel>` after ticket types exist, so the ticket creation message can include them.
5. Test with a non-admin account when possible.