Set up the bot and server

This page targets discord-mcbe v4 and later

When upgrading from v3 or earlier, back up the existing installation and set up discord-mcbe in a separate directory using the steps below. The old config.json cannot be used with v4.

Requirements

Item	Requirement
Discord	Permission to add a bot
Bot host	Windows x64, Linux x64/arm64, or macOS x64/arm64
Minecraft	Bedrock Edition 1.26.40 or later
Network	Access to services such as Discord and GitHub

The launcher includes its runtime. A normal installation does not require a separate Node.js or Bun installation.

Create a Discord bot

1. Open the Discord Developer Portal, select New Application, and create an application.

2. Open Bot in the sidebar, use Reset Token to issue a bot token, and keep it somewhere secure.

   Treat the token as a password

   Never paste the token into chat, screenshots, or a Git repository. If it is exposed, reset it in the Developer Portal immediately.

3. Under Bot → Privileged Gateway Intents, enable Message Content Intent. Without it, message content cannot be relayed from Discord to Minecraft.

4. In the Guild Install settings under Installation (or OAuth2 → URL Generator), select the bot and applications.commands scopes and grant these bot permissions:

   • View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Read Message History

   Bypass Slowmode is optional for a busy relay channel.

5. Open the generated URL and add the bot to the Discord server you will use.

Copy the Discord IDs

Enable User Settings → Advanced → Developer Mode in Discord. Right-click the target server and the text channel used for chat relay, then copy each ID.

Value	Copy from
GUILD_ID	The Discord server that contains the bot
CHANNEL_ID	The text channel used for Minecraft chat

Check the channel permission overrides as well. They must not deny the bot’s access. If the bot cannot view the channel, it cannot send messages from Minecraft to Discord.

Prepare the discord-mcbe server

discord-mcbe launcher v8

Show downloads for another OS or CPU

• Windows 64-bit41.1 MBwindows-x64
• Linux 64-bit38 MBlinux-x64
• Linux ARM6438 MBlinux-arm64
• Intel Mac29.8 MBdarwin-x64
• Apple silicon Mac27.1 MBdarwin-arm64

View release details

1. Extract the downloaded zip.

2. Open the .env file included in the archive and insert the values you copied:

   DISCORD_TOKEN=your_bot_token
   GUILD_ID=your_discord_server_id
   CHANNEL_ID=your_relay_channel_id
   # SOCKET_PORT=3063
   # BRIDGE_PORT=23191
   # DISCORD_WEBHOOK_URL=url

   Values do not need quotes (""). See configuration for details about each value.

3. Use the updater to install the discord-mcbe server.

   Windows (double-click)

   Double-click updater.exe and select Stable. Windows Defender SmartScreen may warn you when starting the exe, but it is safe to continue. After installation finishes, double-click start.bat to start the server.

   You can instead run the following commands in PowerShell or Command Prompt.

   .\updater.exe stable
   .\start.bat

   Linux / macOS

   chmod +x updater start.sh
   ./updater stable
   ./start.sh

4. The first successful start creates config.json. This part is complete when the bot is online and the configured channel receives its startup message.

Next, install the add-on in your Minecraft world.

For future updates, see Use the launcher.