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 customizable 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"

1. Optionally, customize messages in messages.yml for 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:
   • Scopes: bot and applications.commands
     
     
   • Bot Permissions: Send Messages, Read Message History, Administrator (optional)
5. Paste the token in config.yml.

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 ( https://github.com/DV8FromTheWorld/JDA)

License

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

Enjoy your Discord ↔ Minecraft integration!