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
The database	Everything else	Slash commands, while the bot is running

If you find yourself editing a setting by hand, there is almost certainly a command for it. See Config files.

The .env file

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

DISCORD_TOKEN=your_discord_bot_token
DISCORD_CHANNEL_ID=your_bridge_channel_id
LOG_CHANNEL=your_log_channel_id
MINECRAFT_USERNAME=[e-mail]
DATABASE_URL=your_postgres_connection_string
HYPIXEL_API_KEY=
RANK_ROLE_SENIOR_OFFICER=
RANK_ROLE_OFFICER=
RANK_ROLE_TRIAL_OFFICER=
RANK_ROLE_VETERAN=
RANK_ROLE_ELITE=
RANK_ROLE_TITAN=

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 a guild registry exists
DATABASE_URL	Yes	The PostgreSQL database shared with the community bot. Holds this bot’s settings; the bot will not start without it
HYPIXEL_API_KEY	No	Hypixel API key. When set, the bot learns each guild’s Hypixel id on connect and stores hypixelGuildId
DISCORD_GUILD_ID	No	The only Discord server the bot accepts commands from. Defaults to the server the bridge channel is in
RANK_ROLE_*	No	The Discord role id for each /promote rank: SENIOR_OFFICER, OFFICER, TRIAL_OFFICER, VETERAN, ELITE, TITAN. Unset, the role named after the rank is used

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 a registry exists — in the database, or in a guildsConfig.json waiting to be imported — it 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, 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 set admin roles for their own server on the community bot and inherit bot-admin here — 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
Guild-to-guild chat sharing	/guilds edit … crossbridge:True	Guild-to-guild bridging
Who counts as a bot admin	/adminrole on the community bot	Admin roles
Where audit entries go	/auditchannel	Auditing
Where feature requests are posted	/requestchannel	Feature requests
Per-guild log and audit channels	/guilds edit	Hypixel guilds

Restarting

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

Next

• Config files
• Permissions
• Hypixel guilds