> ## 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.

# Configuration

> Environment variables and first-run setup.

TriBridge is configured in two places, and the split matters:

| Where              | Holds                                         | Changed by                               |
| ------------------ | --------------------------------------------- | ---------------------------------------- |
| **`.env`**         | Credentials and the two channels it must know | Editing the file and restarting          |
| **`*Config.json`** | Everything else                               | Slash commands, while the bot is running |

If you find yourself editing a `*Config.json` by hand, there is almost certainly a command for it. See
[Config files](/tribridge/config-files).

## The `.env` file

Create it in the project root. It is gitignored; never commit it, and never paste its contents anywhere.

```env theme={null}
DISCORD_TOKEN=your_discord_bot_token
DISCORD_CHANNEL_ID=your_bridge_channel_id
LOG_CHANNEL=your_log_channel_id
MINECRAFT_USERNAME=you@example.com
```

| Variable             | Required  | Description                                                                                            |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------ |
| `DISCORD_TOKEN`      | Yes       | Bot token from the Discord Developer Portal. The bot refuses to start without it                       |
| `DISCORD_CHANNEL_ID` | Yes       | The **bridge channel** — the one channel wired to guild chat                                           |
| `LOG_CHANNEL`        | Yes       | Where connection notices and warnings go. A Hypixel guild can override it with its own channel         |
| `MINECRAFT_USERNAME` | First run | The Microsoft account email for the first Hypixel guild. **Ignored once `guildsConfig.json` exists**   |
| `DISCORD_GUILD_ID`   | No        | The only Discord server the bot accepts commands from. Defaults to the server the bridge channel is in |

To get a channel id: enable **Developer Mode** in Discord's Advanced settings, then right-click the channel →
**Copy Channel ID**.

### About `MINECRAFT_USERNAME`

It only seeds the **first** Hypixel guild on a fresh install. Once `guildsConfig.json` exists the registry is
authoritative and the variable is ignored — if it names an account that is not in the registry, the bot says
so on startup and carries on. Add and change accounts with [`/guilds`](/tribridge/hypixel-guilds), not by editing this.

### About `DISCORD_GUILD_ID`

Slash commands are registered **globally**, but TriBridge serves exactly one Discord server: one bridge
channel, one flat admin role list. Every command dispatch refuses an interaction that came from anywhere else.

Normally the server is resolved at startup from `DISCORD_CHANNEL_ID`, so you can leave this out. Set it
explicitly if the bridge channel is somewhere the bot cannot resolve at startup.

> **This check is load-bearing.** Without it, an administrator of *any other* server the bot was added to
> could `/adminrole add` a role they control and inherit bot-admin over your server — including `/send`, which
> runs arbitrary commands as a Minecraft account. It fails closed: if the server cannot be resolved, every
> command is refused.

## Everything else

| What                              | Command                           | Page                                                          |
| --------------------------------- | --------------------------------- | ------------------------------------------------------------- |
| Which Hypixel guilds are bridged  | `/guilds`                         | [Hypixel guilds](/tribridge/hypixel-guilds)                   |
| Guild-to-guild chat sharing       | `/guilds edit … crossbridge:True` | [Guild-to-guild bridging](/tribridge/guild-to-guild-bridging) |
| Who counts as a bot admin         | `/adminrole`                      | [Admin roles](/tribridge/admin-roles)                         |
| The role given to linked users    | `/linkrole`                       | [Link role](/tribridge/link-role)                             |
| Where audit entries go            | `/auditchannel`                   | [Auditing](/tribridge/auditing)                               |
| Where feature requests are posted | `/requestchannel`                 | [Feature requests](/tribridge/feature-requests)               |
| Per-guild log and audit channels  | `/guilds edit`                    | [Hypixel guilds](/tribridge/hypixel-guilds)                   |

## Restarting

Only `.env` changes need a restart. Everything set through a command takes effect immediately.

## Next

* [Config files](/tribridge/config-files)
* [Permissions](/tribridge/permissions)
* [Hypixel guilds](/tribridge/hypixel-guilds)