View attachment 949281


✦ Features

• Chat bridge - Minecraft chat relayed to Discord; Discord messages broadcast in-game
  
• Item display - typing [item] in chat renders an item tooltip image and attaches it to the Discord message
  
• Join/leave embeds - player join and leave events posted to Discord with their Minecraft avatar
  
• AFK detection - works with CMI or any plugin that broadcasts AFK status messages
  
• Server message relay - forward plugin broadcasts to Discord by prefix filter
  
• Account linking - players link their Minecraft account to Discord via OAuth2; LuckPerms rank synced as a Discord role
  
• Auction House logging - listings, sales, and removals logged to Discord as embeds (currently only supports zAuctionHouse)
  
• Role display - Discord→Minecraft messages show the sender's highest configured role
  
• MiniMessage support - players with permission can use MiniMessage tags and hex colors in chat
  

✦ Installation

1. Download DiscordUtils.jar and drop it into your plugins/ folder alongside Vault and LuckPerms
   
2. Start the server once to generate plugins/DiscordUtils/config.yml, then stop it
   
3. Create a Discord bot at https://discord.com/developers/applications, enable both privileged intents, and paste the token into bot-token
   
4. Enable Developer Mode in Discord, right-click your bridge channel, copy its ID, and paste it into channel-id
   
5. Invite the bot with permissions: Send Messages, Embed Links, Attach Files, Manage Roles
   
6. Start the server- the bot will connect and post a status message to the channel
   

Bot intents required: Enable Message Content Intent AND Server Members Intent in the Discord Developer Portal. Without them the bot cannot read messages or manage roles.

✦ Dependencies

• Paper / Spigot 1.20+ - Required
  
• Vault - Required - provides rank prefixes and group lookup
  
• LuckPerms - Required - other permission plugins may work
  
• CMI - Optional - AFK detection uses native CMI events when present
  
• zAuctionHouse - Optional - Auction House logging only activates if detected
  
  
• I will be adding compatibility for alternate plugins & MC versions in the future.

✦ Commands

• /discordchat allow <all|admins> - Set who can chat from Discord to Minecraft (discordutils.admin)
  
• /discordchat <enable|disable> - Toggle the Discord→Minecraft relay (discordutils.admin)
  
• /discordchat status - Show bot connection and relay status (discordutils.admin)
  
• /discordlink - Link your Minecraft account to Discord (discordutils.link)
  
• /discordunlink - Unlink your Minecraft account from Discord (discordutils.link)
  

✦ Permissions

• discordutils.admin - Access to /discordchat - default: op
  
• discordutils.link - Access to /discordlink and /discordunlink - default: true
  
• discordutils.formatting - Use MiniMessage/hex color tags in chat - default: true