Discocraft

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

```yaml language: ko_kr

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

Main Commands

```text /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

```text /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:

```text /discord link ```

Then in Discord:

```text !link <code> ```

Other commands:

```text /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.

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

Example:

```text !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

```text /discocraft language ko_kr /discocraft language en_us ```

Supported languages:

- `ko_kr` - `en_us`

Build

Windows:

```bat build.bat ```

Manual:

```text .gradlew.bat clean build ```

Output:

```text build/libs/Discocraft-1.0-SNAPSHOT.jar ```

Upload Assets

Platform upload icon:

```text assets/discocraft-icon.png ```

Source vector:

```text assets/discocraft-icon.svg ```