DiscordIncorporation

🎮 DiscordIncorporation

DiscordIncorporation is a Minecraft plugin for Spigot/Paper that integrates your server with Discord. It allows bidirectional chat, remote command execution from Discord, console command capture, and logs in a Discord channel.

---

✨ Features

- 💬 Messages configurable between Minecraft and Discord - ⚡ Messages configurable from Discord using allowed roles - 🖥️ Messages configurable and send them to a Discord channel - 👥 Messages configurable in Discord to see online players - 🔄 Messages configurable command to reload configuration without restarting the server - 📝 Messages configurable in `messages.yml` (Spanish and English)

---

🛠️ Requirements

- Minecraft 1.17 - 1.20 (Paper/Spigot) - Java 16+ (Java 22 recommended) - Discord Bot (own token) - JDA library included in the plugin

---

📥 Installation

1. Download the `.jar` file and place it in your server's `plugins` folder. 2. Restart the server to generate default configuration. 3. Configure `config.yml`:

```yaml bot-token: "YOUR_BOT_TOKEN" log-channel-id: "DISCORD_CHANNEL_ID" allowed-roles: - "Admin" - "Moderator" ``` Optionally, customize messages in messages.yml to enable/disable messages, chat formats, and permission messages.

🤖 Creating the Discord Bot

1. Go to Discord Developer Portal and create a new application.

2. Create a bot under the Bot section and copy its token.

3. Enable Server Members Intent in Privileged Gateway Intents.

4. Invite the bot to your server using OAuth2 URL Generator:

5. Scopes: bot and applications.commands

6. Bot Permissions: Send Messages, Read Message History, Administrator (optional)

7. Paste the token in config.

---

🚀 Usage

Minecraft Commands ``` /discordinc reload ```

Reloads the plugin configuration and messages.

Discord Slash Commands

/online → Shows online players

/cmd command:<text> → Executes a Minecraft command from Discord (requires allowed role)

⚙️ Configurable Messages (messages.yml)

plugin-enabled-es, plugin-enabled-en → Messages when enabling the plugin

plugin-disabled-es, plugin-disabled-en → Messages when disabling the plugin

chat-mc-format → Format of Minecraft messages sent to Discord

chat-discord-format → Format of Discord messages sent to Minecraft

no-permission → Message when a role does not have permission

---

⚠️ Warnings

Make sure to use a valid Discord token.

Keep the token safe; if leaked, someone could control your bot.

If your server is in offline-mode, anyone can join without Mojang authentication (does not directly affect Discord plugin but is insecure).

---

🎨 Credits

Plugin developed by [YourName]

Inspired by Discord integrations for Minecraft

Library used: JDA

---

📄 License

MIT License – You can modify and redistribute under the license terms.

Enjoy your Discord ↔ Minecraft integration! 🎉