<p align="center"> <img src="https://github.com/user-attachments/assets/35b66ae1-cfe5-4ecc-ae4a-82d137e3c808" alt="Discord-Chat-Integration-Banner" width="25%"/> </p> <h1 align="center">Discord Chat Integration</h1> <p align="center">Brings your Minecraft chat into Discord with additional automation features. Send messages/commands and listens to Minecraft from Discord without bots. </p> ## What It Does This mod bridges Discord and Minecraft through a local WebSocket connection, allowing you to send messages and execute commands in Minecraft directly from Discord without any bots. It also includes other advanced features like chat delay and automations. - **Botless Discord Integration** - No Discord bot setup required; uses Vencord or BetterDiscord plugins - **Bidirectional Chat** - Send messages/commands from Discord to Minecraft and receive chat feedback in Discord - **(#multi-client-setup)** - Control multiple Minecraft clients from a single Discord interface - **(#sync-groups)** - Achieve tick-perfect synchronization across multiple Minecraft clients - **(#chat-delay)** - Queue and batch-send messages - **(#automations)** - Create trigger-based rules that execute actions when Minecraft chat events occur ### Installing the Discord Plugin > > Both the Discord plugin and the mod are required to be installed. - (https://github.com/aurickk/Discord-Chat-Integration/blob/main/betterdiscord-plugin/README.md) - (https://github.com/aurickk/Discord-Chat-Integration/blob/main/vencord-plugin/README.md) ## Usage ### Quick Start Guide 1. Start Minecraft with the mod installed 2. Join a world or server 3. Open Discord with the Discord plugin enabled 4. The plugin will automatically connect (if "Auto Connect" is enabled and the port number matches) 5. Send messages/commands in the configured Discord channel, they'll appear/execute in Minecraft chat 6. Recieve messages or command feedback in Discord (If "Forward to Discord" is enabled) ## Setup and Configurations ### Quick Settings Access <img width="647" height="73" alt="quick access setttings" src="https://github.com/user-attachments/assets/f96de6ac-4394-458a-a4e5-a7c6663da956" /> A **gear icon** appears next to the chat input box when the plugin is enabled. Click it to quickly access the Minecraft Chat settings without navigating through Discord's settings menu. The icon turns **green** when at least one client is connected. --- ### Adding Minecraft Clients 1. Click **"Add Client"** in quick access menu 2. Configure each client: - **Name**: A friendly name for this client - **Port**: WebSocket port - **Channel ID**: The Discord channel ID to bridge with this client - **Enabled**: Toggle to enable/disable this client connection - **Forward to Discord**: Toggle to enable/disable forwarding Minecraft chat to Discord - **Sync Group**: Assign client to a sync group for tick-perfect synchronization 3. **Getting a Channel ID**: - Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode) - Right-click on the channel you want to use - Click "Copy Channel ID" - Paste into the plugin settings --- ### Multi-Client Setup > > Different Minecraft clients cannot share the same port, you can change the port with a (#minecraft-mod-configuration). You can run multiple Minecraft clients, each connected to different or shared Discord channels: **Different Channels:** 1. **Client 1**: Port `25580` → Discord Channel `123456789` 2. **Client 2**: Port `25581` → Discord Channel `987654321` 3. **Client 3**: Port `25582` → Discord Channel `555555555` **Shared Channel:** Multiple clients can be assigned to the same Discord channel. When this happens: - Messages from Discord are sent to **all** Minecraft clients assigned to that channel - Messages forwarded to Discord include a `` tag to identify the source - If multiple clients are on the same sync group, the message/command will be sent on the same server tick --- Addional configuration can be found in **User Settings → Vencord/BetterDiscord → Plugins → MinecraftChat** | Setting | Description | Default | |---------|-------------|---------| | **Auto Connect** | Automatically connect to all enabled clients when Discord starts | `true` | | **Advanced Features** | Enable advanced features (Chat Delay, Sync Groups, Automations) | `false` | | **Connection Logging Channel** | Discord channel ID where connection/disconnection events are posted (Leave blank to disable) | Empty | | **Enable Console Logging** | Log plugin debug messages to browser console (DevTools F12) | `true` | --- ### Minecraft Mod Configuration The mod uses a default port of `25580`. You can change this using the in-game command: ``` /discordchat port <port_number> ``` The port must be between 1024 and 65535 and match the configured cl