Skip to content

Commands and features

Example of Minecraft chat relay

Normal chat from players in a connected world is sent to CHANNEL_ID. Join, leave, world-connect, and disconnect events are sent as embeds.

  • When multiple worlds are connected, the world name is added to identify the source.
  • Minecraft § color codes are removed by default.
  • Switch to webhook mode to show the player name as the sender of the Discord message.

Example of Minecraft chat relay

Messages from users in CHANNEL_ID are broadcast to every connected world.

  • Messages sent by this bot or other bots are not relayed.
  • The member’s Discord display name is used as the sender.
  • Replies include the source author’s name and a short content preview.
  • Messages with attachments show the file count.
  • Message filters can shorten long messages or replace or reject content matching a regular expression.

discord-mcbe can connect multiple Minecraft worlds at the same time. Give each world a unique name so that messages can be identified by their source. See world setup for connection instructions.

After setting a world name with /dmc:setname <name>, specify world in Discord’s /list or /command to target one world. Omitting world targets every connected world.

Example of multiple connected worlds

When a player dies, discord-mcbe sends the Minecraft death message for the cause of death to Discord. When multiple worlds are connected, the source world name is also shown.

Use bot.show_death_messages in config.json to control death logs. It defaults to true; set it to false to disable them. See configuration for details.

Example of a death log

At startup, the bot registers commands in the Discord server specified by GUILD_ID.

Command Permission Description
/ping Everyone Show latency for the bot and every connected world
/list [silent] [world] Everyone Show player counts and names
/command <command> [raw] [world] [silent] Administrator Execute a Minecraft command and display its result
/panel create Administrator Create the status panel in the current channel
/panel show Administrator Show a link to the stored status panel

Enter the Minecraft command in command without a leading slash.

/command time set day world:survival silent:true
  • Omitting world executes the command in every connected world.
  • raw displays the raw result as JSON.
  • A result longer than the embed threshold is attached as results.txt.
  • silent makes the response visible only to the person who ran it.

/panel create posts an embed that periodically refreshes with:

  • Discord bot ping and uptime
  • World name, host type, latency, and connection time
  • Player count and player names
  • The discord-mcbe version

Only one panel is stored. Creating another removes the old panel. Change the refresh interval in configuration.

By default, commands marked as requiring Administrator permission can only be run by users with the server’s Administrator permission. To change access for individual commands, open Server Settings > Apps > Integrations > [Bot name] > Commands.

Command Permission Description
/dmc:discord-mcbe Operator Open the settings form
/dmc:dmc Operator Alias for /dmc:discord-mcbe
/dmc:setname <name> Operator Change the world name
/dmc:disconnect Host Disconnect from discord-mcbe

Type a Minecraft command into the terminal running discord-mcbe to execute it in every connected world.

ターミナルウィンドウ
say Server maintenance starts in 10 minutes