Skip to main content
One TriBridge instance can bridge several Hypixel guilds at once — one Minecraft account each — through the same Discord channel. The set of them is the registry, kept in guildsConfig.json and managed entirely from Discord with /guilds. You should not need to edit that file by hand. /guilds is the supported way in, and it is the only way to repair a broken registry — which is why Discord comes up even when no Minecraft account can connect.

​
What a guild has

key and account cannot be changed. account is the key prismarine-auth hashes for its token cache, so editing it later silently starts a fresh device-code flow against a different cache file. Renaming means removing the guild and adding it again — /guilds edit does not offer either field.

​
Adding one

The guild is registered, then a Microsoft sign-in starts and the device code arrives in your own private reply: a link, a code, and the account to sign in as. No console access needed.
Never share a device code. For the life of the flow it is the whole credential — anyone holding it can complete the sign-in with their own Microsoft account and bind the wrong account to your guild. The bot only ever sends it to the admin who asked, or as a DM to whoever registered the guild, or to the console. The log channel gets a notice with the code removed.
Once signed in, the account connects on its own within about ten seconds. /ping confirms it.

​
The default guild

Management commands (/invite, /kick, /promote, /demote, /send, /login) take an optional guild. Leave it out and they act on the default guild:
/login is the exception: with no guild it reconnects every disconnected guild, because after an outage that is almost always what was meant. /send is the other: it never fans out, and always targets exactly one guild, because it runs arbitrary commands as a Minecraft account.

​
Editing one

clear drops a per-guild channel — Log channel, Audit channel or Log and audit channels falls back to the global one again, and Officer channel switches officer chat off, since that one has no global fallback.
⚠️ An officer channel is two-way: everyone who can post in it is speaking in officer chat in-game. Restrict it with Discord’s channel permissions before setting it — see Officer chat.
Several guilds may be pointed at the same officer channel, and usually should be: their officer chat then arrives in one place, tagged, and a reply picks a guild with !tag. Separate channels still work. enabled:False disconnects the guild and stops the reconnect poller trying it, without losing its settings or its cached token. It is the right way to take a guild offline for a while.

​
Removing one

Unregisters the guild and disconnects its bot. Removing the default guild needs confirm:True, since every command with no guild option would otherwise start failing. The cached Microsoft token in .minecraft-auth/ is left alone, so re-adding the same account later does not need a fresh sign-in.

​
Signing in again

Repeats the device-code flow for a guild whose token has expired or been revoked. Same privacy rules as /guilds add.

​
Listing them

Every registered guild with its connection status, its tag and colour, its channels, a 🔁 on the guilds taking part in guild-to-guild bridging and a 🛡️ on those sharing officer chat. Account addresses are masked.

​
With only one guild

Nothing about a single-guild install changes when multi-guild support is present. There are no tags on incoming messages, everything you type goes to the one guild whatever prefix you use, and /ping and /online read exactly as they did.

​
Two accounts in one Hypixel guild

This is a misconfiguration, and the bot survives it rather than fixing it. Each account hears everything the other says, so without a guard every line would be relayed twice. Two guards handle it: a line spoken by any registered account is never relayed, and the same player saying the same thing in two guilds within two seconds is treated as a duplicate. You get one embed. Still, put one account per guild.

​
Next