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-chatValues 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:@MemberCore 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.
/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
Set
administrator_role.Configure the channels and roles needed by the modules you enabled.
If tickets are enabled, create ticket types and fields.
Set
tickets_creation_channelwith/config set tickets_creation_channel textchannel:<channel>after ticket types exist, so the ticket creation message can include them.Test with a non-admin account when possible.
Last updated