DiscordIncorporation
PluginMIT

DiscordIncorporation

Make discord a console for your server

16
Downloads
0
Followers
6 months ago
Updated
📦
1
Versions

📖About 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

  • 💬 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! 🎉