SocialBridge

Join my Discord if you run into issues or have ideas https://discord.gg/mKgxyk6qvb

SocialBridge links a Hytale server to Discord. Two way chat, join, leave and death posts, account linking with roles, a live roster and slash commands. No library in the jar. With my other mods installed it adds faction, balance, leaderboard, unlock, stats and map commands.

Setup

1. Drop SocialBridge-0.2.0.jar in mods and start the server once.
2. At https://discord.com/developers/applications create an application, open Bot, Reset Token, and switch on Message Content Intent.
3. Under OAuth2, URL Generator tick bot and applications.commands with View Channels, Send Messages, Embed Links, Read Message History and Manage Webhooks. Open the link and add the bot.
4. In Discord enable Developer Mode, right click your server and your chat channel, Copy ID.
5. Paste the token, the server id and the channel id into mods/Ryvrook_SocialBridge/SocialBridge.json, then run /socialbridge reload.

Players link with /link in game and /link code in Discord. /socialbridge status tells you what to fix if anything is off. Already run a bot? Set mode to external.

Commands

Admin commands need socialbridge.admin. The player commands are open to everyone unless permissions.required is on. The README on GitHub lists all 139 settings.

With my other mods

All optional, and each link has a setting auto, always or never. A slash command that needs a mod is only registered while that mod is installed, so nobody sees a command that answers "not installed".

TrackerAPI feeds the join and death posts, boss kills with everyone who took part, /top leaderboards and profile stats. Coinage adds /balance, /richlist, and /pay and /daily when you switch them on. Dominion Factions adds /faction and /factions top, posts for wars, alliances and sieges, a private Discord thread per faction that carries faction chat both ways, and roles for faction and rank. Feats unlocks are posted with the tier and how rare the feat is, and Feats leaves its own webhook alone while SocialBridge is there. Chronicle Stats adds the week's numbers, a link to the player page and live record posts. Atlas keeps hidden players out of every list and puts the map link in the roster and /server. Lullaby posts skipped nights and adds sleepers to /server. RestAPI adds /api/socialbridge, Discord account links looked up both ways and posts to SocialBridge's channels from a web request.

Coinage, Dominion Factions, RestAPI and SocialBridge itself are not on CurseForge yet, the links above use the pages they will have.

Limits

Needs server 0.7.0 or newer and Java 25. SocialBridge has 380 automated tests against a fake Discord and a fake bot, and boots cleanly with all nine of my mods, but I have not run it against a real Discord server yet. Please report anything that posts twice or not at all.

One bot token per server. Two servers on one token relay every line twice. Faction threads and roles are Discord only and not carried in mode external. The linked role is not given back when someone removes it by hand in Discord.

Links

• More mods by ryvrook https://www.curseforge.com/members/ryvrook/projects
• TrackerAPI, Feats, Chronicle Stats, Atlas, Lullaby
• Coinage, Dominion Factions, RestAPI
• Source, settings and the bot protocol https://github.com/ryvrook/Hytale-SocialBridge
• Discord https://discord.gg/mKgxyk6qvb