Discord Chat Integration Addon

**For Minecraft Bedrock Dedicated Servers Only**

A powerful addon that bridges your Minecraft server with Discord, allowing real-time chat integration and player activity notifications.

🎯 What This Addon Does

Real-Time Chat Integration

• In-Game → Discord: Every chat message from players appears in your Discord channel
• Player Join/Leave: Automatic notifications when players connect or disconnect
• Rich Embeds: Beautiful Discord messages with player avatars and server branding

Smart Message Management

• Message Queuing: Batches messages for efficient sending
• Auto-Send: Automatically sends messages every 5 seconds (configurable)
• Manual Control: Send messages on-demand when needed
• Error Handling: Retries failed messages automatically

Easy Configuration

• UI Interface: Beautiful in-game forms for setup (/discord:ui)
• Command Line: Alternative commands for advanced users
• Persistent Storage: Settings saved with your world
• No External Dependencies: Everything runs within Minecraft

🚀 Quick Setup

1. Server Requirements

• Minecraft Bedrock Dedicated Server
• Operator permissions for setup
• Internet connection for Discord webhooks

2. Discord Setup

1. Right-click your Discord channel
2. Go to Edit Channel → Integrations → Webhooks
3. Create a new webhook and copy the URL
4. You only need the part after /webhooks/ (e.g., 1234567890/abcdef123456)

3. In-Game Setup

/discord:ui

• Enter your webhook ID/token (short format)
• Set your server name
• Configure auto-send and logging
• Save and test!

📋 Commands Reference

Main Commands (Admin Only)

• /discord:ui - Open configuration interface ⭐ Recommended
• /discord:setup <id/token> - Set webhook (short format)
• /discord:servername <name> - Set server display name
• /discord:send - Send queued messages now
• /discord:auto - Toggle automatic sending
• /discord:status - Show current configuration
• /discord:test - Add test message to queue
• /discord:logging - Toggle console logging
• /discord:clear - Reset all settings
• /discord:help - Show command help

Webhook Format

Instead of the full Discord URL:

https://discord.com/api/webhooks/1234567890/abcdef123456

Just use the short format:

1234567890/abcdef123456

🔧 Features

Message Types

• 💬 Chat Messages: Player conversations with avatars
• ✅ Join Notifications: When players connect
• ❌ Leave Notifications: When players disconnect
• 🧪 Test Messages: For configuration testing

Discord Embeds

• Player Avatars: Automatic Minecraft head images
• Color Coding: Green for chat/joins, red for leaves
• Server Branding: Your custom server name in footers
• Timestamps: Accurate message timing
• Dimension Info: Shows which world dimension

Smart Controls

• Auto-Send: Sends messages every 5 seconds when enabled
• Manual Send: Send messages on-demand
• Queue Management: Holds up to 50 messages
• Logging Control: Toggle console output on/off

⚙️ Server Configuration

Required Permissions File

Create or update /home/container/config/default/permissions.json:

{
  "allowed_modules": [
    "@minecraft/server-gametest",
    "@minecraft/server",
    "@minecraft/server-ui",
    "@minecraft/server-admin",
    "@minecraft/server-net",
    "@minecraft/server-editor"
  ]
}

Addon Installation

1. Upload the addon to your server's behavior_packs folder
2. Add to your world's behavior_packs in world_behavior_packs.json
3. Restart the server
4. Configure using /discord:ui

🛡️ Security & Permissions

Admin Only Access

• All Discord commands require Operator permissions
• Uses Minecraft's built-in permission system
• Cannot be triggered by command blocks or automation
• Secure webhook URL storage

Data Storage

• Webhook URLs stored securely in world data
• No external files or databases required
• Settings persist with world saves
• Automatic cleanup on configuration reset

🎨 Discord Appearance

Chat Messages

[Player Avatar] PlayerName
Their chat message here
Server Name • overworld | Today at 3:45 PM

Join/Leave Notifications

[Player Avatar] PlayerName joined the game
Server Name | Today at 3:45 PM

🔍 Troubleshooting

Common Issues

• "Not configured": Run /discord:ui to set up webhook
• Messages not sending: Check internet connection and webhook URL
• Permission denied: Ensure you have operator status
• UI not opening: Verify @minecraft/server-ui is in permissions.json

Debug Information

• Use /discord:debug to see configuration details
• Check console logs for detailed error messages
• Use /discord:status to verify setup
• Test with /discord:test before going live

📊 Technical Details

Dependencies

• @minecraft/server (2.0.0-beta) - Core functionality
• @minecraft/server-net (1.0.0-beta) - HTTP requests
• @minecraft/server-ui (2.0.0-beta) - Configuration interface

Performance

• Minimal server impact
• Efficient message batching
• Automatic queue management
• Configurable logging levels

Compatibility

• Bedrock Dedicated Servers Only
• Requires operator permissions for setup
• Works with all Minecraft Bedrock versions supporting script APIs
• No client-side installation required

🎉 Ready to Connect Your Server?

1. Set up Discord webhook in your channel
2. Install the addon on your Bedrock Dedicated Server
3. Configure permissions.json with required modules
4. Run /discord:ui in-game to configure
5. Test with /discord:test and enjoy real-time chat integration!

Your Minecraft server and Discord community are now connected! 🚀