Discord Link

Discord Link

Straightforward mod that adds Discord integration to Hytale, letting you connect the in-game chat with a channel on your discord server, enabling bi-directional communication and more!

• Supports both webhooks and direct bot communications
• Invite link to help set Discord-server authorizations for the bot
• 3rd-party Avatar Support for clearer chat logs (at least until Hytale exposes player avatars/skins)
• System-level messaging: server startup/shutdown, player join/leave
• Custom bot status for displaying metrics like player count
• Optional embedded message formatting/customization
• Token and webhook encryption to prevent accidental leaks

More features coming soon!

Installation Instructions

1. Set up the Discord Bot:
   
   1. Go to https://discord.com/developers/applications/
   2. Click the button to create a New Application
   3. Set up General Information
   4. Under the Bot tab, enable Presence, Server, and Message intents
   5. Copy down the Token
2. Prep the Discord Channel:
   1. Right-click > "Copy Channel ID" and note this down (May need to enable Developer Mode under Settings > Advanced > Developer Mode)
   2. (Optional, though preferred) Right-click > Edit Channel > Integrations > Webhooks > New Webhook > "Copy Webhook URL" and note this down
3. Copy the jar to your mods folder
4. Set up the config file:
   1. Launch and stop the server to generate the config file if it doesn't already exist 
   2. Paste your token in the token field
   3. Paste the Channel ID into the channel_id field
   4. (Optional) Paste the Webhook URL into the webhook_url field and set use_for_chat and use_for_events both to "true"
   5. Follow the instructions/examples in the config file to further customize your setup
5. Launch the server
   1. Look for "[DiscordLink|P] Bot invite URL (click to add to your server):" in the server logs -- click this link and follow the prompts to invite the Bot (the application you set up in Step 1) to your Discord server
   2. Once the bot is in your server, make sure it has permissions to see/interact with the channel you set up in Step 2 (which are separate from the authorizations granted in 5.1)