# 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 /discocraft get /discocraft set /discocraft events ``` ## Bot And Channel Commands ```text /discocraft bot list /discocraft bot add /discocraft bot remove /discocraft bot clear /discocraft channel list /discocraft channel add /discocraft channel remove /discocraft channel clear ``` Bot tokens are hidden in command output. ## Account Linking In Minecraft: ```text /discord link ``` Then in Discord: ```text !link


```

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

kooyoseb