Discocraft

Minecraft and Discord bridge. One plugin to end it.

Discocraft links a Paper Minecraft server with Discord chat, server events, account verification, and controlled Discord-side console commands.

Features

• Minecraft chat to Discord
• Discord chat to Minecraft with a visible configurable label
• Join, quit, death, server start, and server stop event forwarding
• Custom event selection with alls, none, chat, join, quit, death, server-start, server-stop
• Multiple Discord bot tokens
• Multiple Discord channel IDs
• Minecraft account to Discord account linking
• Discord-side Minecraft console command execution with allowlists
• Runtime config editing with commands
• Korean and English language setting

Requirements

• Paper server matching the plugin API version
• Java 25 or compatible server runtime
• A Discord bot token
• Discord bot MESSAGE CONTENT INTENT enabled in the Discord Developer Portal

Installation

1. Build the plugin with build.bat or .\gradlew.bat build.
2. Copy build/libs/Discocraft-1.0-SNAPSHOT.jar into your server plugins folder.
3. Start the server once to generate the plugin folder and config.
4. Configure Discord settings in plugins/Discocraft/config.yml or with commands.
5. Run /discocraft reload.

Basic Setup

language: ko_kr

discord:
  enabled: true
  bot-tokens:
    - "YOUR_BOT_TOKEN"
  channel-ids:
    - "YOUR_CHANNEL_ID"

Main Commands

/discocraft status
/discocraft reload
/discocraft reset
/discocraft reset <key>
/discocraft get <key>
/discocraft set <key> <value>
/discocraft events <alls|none|chat|join|quit|death|server-start|server-stop>

Bot And Channel Commands

/discocraft bot list
/discocraft bot add <token>
/discocraft bot remove <token>
/discocraft bot clear

/discocraft channel list
/discocraft channel add <channel-id>
/discocraft channel remove <channel-id>
/discocraft channel clear

Bot tokens are hidden in command output.

Account Linking

In Minecraft:

/discord link

Then in Discord:

!link <code>

Other commands:

/discord status
/discord unlink
!unlink

Linked account data is stored separately in linked-accounts.yml.

Discord Console Commands

Discord console execution is disabled by default.

discord:
  console:
    enabled: false
    command-prefix: "!mc"
    allowed-prefixes:
      - "list"
      - "say"
      - "time"
      - "weather"
    allowed-role-ids: []

Example:

!mc list
!mc say hello
!mc time set day

For safety, only commands matching allowed-prefixes can run. If allowed-role-ids is empty, any Discord user in a configured bridge channel can use allowed console commands while the feature is enabled.

Language

/discocraft language ko_kr
/discocraft language en_us

Supported languages:

• ko_kr
• en_us

Build

Windows:

build.bat

Manual:

.\gradlew.bat clean build

Output:

build/libs/Discocraft-1.0-SNAPSHOT.jar

Upload Assets

Platform upload icon:

assets/discocraft-icon.png

Source vector:

assets/discocraft-icon.svg