Description
# 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!* 🚀