🎮 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

• 💬 Bidirectional chat between Minecraft and Discord
• ⚡ Execute server commands from Discord using allowed roles
• 🖥️ Capture all console commands and send them to a Discord channel
• 👥 /online command in Discord to see online players
• 🔄 /discordinc reload 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:

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: → 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! 🎉