# This is the config file for EssentialsX Discord.
# This config was generated for version ${full.version}.
# You need to create a bot user in order to connect your server to Discord.
# You can find instructions on this here: https://essentialsx.net/discord-tutorial
# The token for your bot from the Discord Developers site.
# Please make sure to use this site to add the bot to your server as it grants special permissions you may not be familiar with: https://essentialsx.net/discord.html
token:"INSERT-TOKEN-HERE"
# The ID of your server.
guild:000000000000000000
# Defined text channels
# =====================
#
# Channels defined here can be used for two different purposes:
#
# Firstly, channels defined here can be used to give players permission to see messages from said channel.
# This can be done by give your players the permission node "essentials.discord.receive.<channel>".
# For example, if you wanted to let a player see messages from the primary channel, you'd give them "essentials.discord.receive.primary".
#
# Secondly, channels defined here can be used in the section below to specify which channel a message goes to.
# If a defined channel ID is invalid, the primary channel will be used as a fallback.
# If the primary channel is not defined or invalid, the default channel of the server will be used.
# If your server doesn't have any text channels, the plugin will be disabled.
# By default, two channels are defined:
# - primary, which will send basic join/leave/death/chat messages
# - staff, which will send kick/mute messages
# (note: you will need to replace the zeros with the actual channel ID you want to use)
channels:
primary:000000000000000000
staff:000000000000000000
# Should all players receive Discord messages from the primary channel, regardless of their permissions?
# This is intended for use for people without permission plugins. If you have a permission plugin, please give your
# players the essentials.discord.receive.primary permission.
always-receive-primary:false
# Chat relay settings
# General settings for chat relays between Minecraft and Discord.
# To configure the channel Minecraft chat is sent to, see the "message-types" section of the config.
chat:
# The maximum amount of characters messages from Discord should be before being truncated.
discord-max-length:2000
# Whether or not new lines from Discord should be filtered or not.
filter-newlines:true
# A regex pattern which will not send matching messages through to Discord.
# By default, this will ignore messages starting with '!' and '?'.
discord-filter:"^[!?]"
# Whether or not webhook messages from Discord should be shown in Minecraft.
show-webhook-messages:false
# Whether or not bot messages from Discord should be shown in Minecraft.
show-bot-messages:false
# Whether or not to show all Minecraft chat messages that are not shown to all players.
# You shouldn't need to enable this unless you're not seeing all chat messages go through to Discord.
show-all-chat:false
# Console relay settings
# The console relay sends every message shown in the console to a Discord channel.
console:
# The channel ID (or webhook URL) to send the console output to.
# If the channel ID/webhook URL is invalid or set to 'none', the console relay will be disabled.
# Note: If you use a channel ID, the bot must have the "Manage Webhooks" permission in Discord or else the console relay will not work.
channel:000000000000000000
# The format of the console message. The following placeholders can be used:
# - {timestamp}: Timestamp in HH:mm:ss format
# - {level}: The console logging level
# - {message}: The actual message being logged
format:"[{timestamp} {level}] {message}"
# The name of the webhook that will be created, if a channel ID is provided.
webhook-name:"EssentialsX Console Relay"
# Set to true if all messages in the console relay channel should be treated as commands.
# Note: Enabling this means everyone who can send messages in the console channel will be able to send commands as the
# console. It's recommended you stick to the /execute command which has role permission checks (see command configuration below).
# Note 2: This option requires a channel ID and is not supported if you specify a webhook URL above. You'll need to use /execute in Discord if you use a webhook URL.
command-relay:false
# The maximum log level of messages to send to the console relay.
# The following is a list of available log levels in order of lowest to highest.
# Changing the log level will send all log levels above it to the console relay.
# For example, setting this to 'info' will display log messages with info, warn, error, and fatal levels.
# Log Levels:
# - fatal
# - error
# - warn
# - info
# - debug
# - trace
log-level:info
# Configure which Discord channels different messages will be sent to.
# You can either use the names of the channels listed above or just the id of a channel.
# If an invalid channel is used, the primary channel will be used instead.
#
# To disable a message from showing, use 'none' as the channel name.
message-types:
# Join messages sent when a player joins the Minecraft server.
join:primary
# Leave messages sent when a player leaves the Minecraft server.
leave:primary
# Chat messages sent when a player chats on the Minecraft server.
chat:primary
# Death messages sent when a player dies on the Minecraft server.
death:primary
# AFK status change messages sent when a player's AFK status changes.
# - {color}: The minecraft color representative of the user's topmost role color on discord. If the user doesn't have a role color, the placeholder is empty.
# - {message}: The content of the message being sent