HDiscord Chat Bridge

# Hytale-Discord Chat Bridge

**Synchronize your Hytale server with Discord in real-time!**

## 🌟 Description

Hytale-Discord Chat Bridge is a powerful plugin that connects your Hytale server to Discord, enabling instant bidirectional communication between players and Discord members. Keep your community connected even when they're on different platforms!

## 🔧 Main Features

### 💬 Bidirectional Chat Sync - Game messages automatically appear on Discord - Discord messages appear in-game chat - Customizable prefix system to identify message origins

### 🎮 Automatic Notifications - Real-time alerts when players join/leave the server - Configurable messages for server events - Optional suppression of default server messages

### 🖼️ Full Customization - Custom avatar for server webhook - Fully configurable messages

### 🔧 Technical Features - Automatic reconnection on failures - Detailed logging system for diagnostics - Simple configuration via JSON file

## ⚙️ Configuration

### 1. Installation 1. Place the `.jar` file in your server's `mods` folder 2. Restart the server 3. Configure the generated `config.json` file

### 2. Arquivo de Configuração ```json { "botToken": "TOKEN_DO_SEU_BOT", "channelId": "ID_DO_CANAL_DISCORD", "serverAvatarUrl": "URL_DA_IMAGEM_DO_SERVIDOR", "enableHytaleToDiscord": true, "enableDiscordToHytale": true, "discordMessagePrefix": "[Discord] ", "hytaleMessagePrefix": "[Hytale] ", "hytaleMessageFormat": "[Discord] %s: %s", "playerJoinMessage": "🎮 %s entrou no servidor!", "playerLeaveMessage": "👋 %s saiu do servidor!", "serverStartMessage": "🚀 Servidor iniciado!", "serverStopMessage": "🛑 Servidor desligando... Voltamos já!", "showJoinLeaveMessages": true, "suppressDefaultJoinMessages": true, "reconnectAttempts": 3, "reconnectDelayMs": 5000 } ```

### 3. Getting Credentials - **Bot Token**: Create a bot on [Discord Developer Portal](https://discord.com/developers/applications) - **Channel ID**: Enable developer mode on Discord and copy the channel ID - **Avatar**: Use any public image URL (PNG, JPG, GIF)

## 🎯 Benefits

### For Administrators - Monitor server activity in real-time - Easily communicate with your community - Keep everyone informed about important events

### For Players - Interact with Discord friends while playing - See who is online on the server - Participate in discussions even outside the game

### For the Community - Strengthens sense of community - Facilitates event organization - Keeps everyone connected and engaged

## 🛠️ Requirements - Discord bot with appropriate permissions - Text channel on Discord for synchronization

## 🔒 Required Permissions

Your Discord bot needs the following permissions: - `VIEW_CHANNEL` - View channels - `SEND_MESSAGES` - Send messages - `MANAGE_WEBHOOKS` - Manage webhooks - `READ_MESSAGE_HISTORY` - Read message history

## 📊 Usage Example

With the plugin installed and configured: 1. A player types in chat: "Hello everyone!" 2. The message instantly appears on Discord as: `[Hytale] PlayerName: Hello everyone!` 3. A Discord member responds: "Welcome!" 4. The response appears in-game as: `[Discord] UserName: Welcome!`

## 🆘 Support and Issues

If you encounter problems: 1. Check server logs for error messages 2. Confirm all credentials are correct 3. Test with known avatar URLs 4. Verify bot permissions on Discord

---

*Keep your Hytale community connected with the Discord world!* 🚀