> ## Documentation Index
> Fetch the complete documentation index at: https://thehypixelguardians.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TriBridge

> TriBridge bridges Discord and Hypixel guild chat — start here for members and hosts.

**TriBridge** is a Node.js bot that bridges a Discord channel and Hypixel guild chat. Messages go both ways in
real time: guild chat arrives in Discord as embeds, Discord messages are spoken in guild chat, and slash
commands let admins run guild management commands in-game without opening Minecraft.

One bot can bridge **several Hypixel guilds at once** — one Minecraft account per guild — through the same
Discord channel. Guilds can also be bridged **to each other**, so their members talk in-game without anyone
watching Discord.

> **Two different things are called a "guild" here.** A **Hypixel guild** is one of the Minecraft guilds the
> bot bridges; there can be several. A **Discord server** is the single community the bot serves; there is
> exactly one. These docs never use "guild" for the second.

## Start here

| You are…                                    | Go to                                           |
| ------------------------------------------- | ----------------------------------------------- |
| **In the Discord server, using the bridge** | [Using the bridge](/tribridge/using-the-bridge) |
| **Setting the bot up, or running it**       | [Installation](/tribridge/installation)         |

## What TriBridge does

| Feature                                                       | In one line                                                              |
| ------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [The bridge](/tribridge/using-the-bridge)                     | One Discord channel and Hypixel guild chat, relayed both ways            |
| [Guild tags](/tribridge/guild-tags)                           | `!sb hey` reaches one guild; anything else reaches all of them           |
| [Guild-to-guild bridging](/tribridge/guild-to-guild-bridging) | Chat shared between the bridged guilds, in-game, opt-in per guild        |
| [Officer chat](/tribridge/officer-chat)                       | A two-way Discord channel for officer chat, shared or per guild, opt-in  |
| [Account linking](/tribridge/account-linking)                 | Your messages wear your Minecraft head and name on both sides            |
| [Networth](/tribridge/networth)                               | `!nw <username>` in chat, or `/networth`, from either side of the bridge |
| [Hypixel guilds](/tribridge/hypixel-guilds)                   | Register, edit and sign in guilds entirely from Discord with `/guilds`   |
| [Reconnection](/tribridge/reconnection)                       | Dropped accounts come back on their own, one at a time                   |
| [Admin roles](/tribridge/admin-roles)                         | A flat list of Discord roles that hold bot-admin                         |
| [Admin panel](/tribridge/admin-panel)                         | `/adminpanel` — a button per admin function                              |
| [Global profile change](/tribridge/global-profile-change)     | Everyone wears one member's name and face, for a while                   |
| [Auditing](/tribridge/auditing)                               | Every disguised message recorded with a jump link                        |
| [Link role](/tribridge/link-role)                             | A role handed out automatically to everyone who links                    |
| [Feature requests](/tribridge/feature-requests)               | `/request` opens a form; admins move it through a status                 |

## Quick reference

* **[Commands](/tribridge/commands)** — every slash command and chat command, in one table.
* **[Config files](/tribridge/config-files)** — what the bot writes next to the repository, and what is in each file.
* **[Permissions](/tribridge/permissions)** — every Discord permission and intent, and what breaks without it.
* **[FAQ](/tribridge/faq)** and **[Troubleshooting](/tribridge/troubleshooting)** — when something is not behaving.

## For developers

* **[Architecture](/tribridge/architecture)** — how the two clients, the event handler and the guild registry fit
  together.
* **[Adding a command](/tribridge/adding-a-command)** — the checklist for a change that ships.
* **[Releasing](/tribridge/releasing)** — the two changelogs and the release workflow.
* **[Contributing](/tribridge/contributing)** — commit convention and what a good change looks like.

## Hypixel rules

TriBridge relays chat and runs guild commands an officer could type themselves. It does not automate gameplay.
That said, running any bot account on Hypixel is at your own risk: no third-party tool is officially endorsed
by Hypixel, and the account doing the bridging is a real account subject to the
[server rules](https://hypixel.net/rules) like any other.

## Status

See the [changelog](https://github.com/TheHypixelGuardians/TriBridge/blob/master/CHANGELOG.md) for what changed when, and
[DISCORD\_CHANGELOG.md](https://github.com/TheHypixelGuardians/TriBridge/blob/master/DISCORD_CHANGELOG.md) for the short
version that gets posted in the announcement channel.