Config Files

Config files

Everything TriBridge remembers lives in the project root, next to the repository. All of it is gitignored, so a git pull never touches it and nothing secret can be committed by accident.

Each file is created on demand the first time it is needed. A missing file is not an error — it means the feature has not been configured yet.

.env is the exception: it is the one file you write yourself, and the bot will not start without it. Copy the .env.example template in the repository and fill it in — that copy is tracked in git, the .env it produces is not.

File	Holds	Managed with
.env	Token, bridge channel, log channel, first account	Editing it — see Configuration
.minecraft-auth/	Cached Microsoft tokens, one entry per account	The bot
guildsConfig.json	The Hypixel guild registry	/guilds
auditChannelConfig.json	The default audit channel	/auditchannel
globalProfileConfig.json	The running global profile change, and its scope	/adminpanel

Not in a file any more

Bot-admin roles, account links and the link role used to have a config file each. They now live in the THG community bot's PostgreSQL database, which both bots read, and TriBridge reaches it with DATABASE_URL. An install upgrading past that change has to move the contents of the old adminRolesConfig.json, linkedAccountsConfig.json, linkRoleConfig.json and featureRequestsConfig.json across by hand; those files are then dead and can be deleted.

Back these up

guildsConfig.json is the one that costs real work to rebuild — it is the whole bridge setup. Back it up alongside .env. The account links are just as painful to lose, but they live in the community bot's database now, so they are covered by whatever backs that up.

.minecraft-auth/ is worth keeping too: losing it does not lose anything permanent, but every account has to go through a device-code sign-in again.

Things worth knowing

A malformed file degrades to defaults rather than crashing. A guildsConfig.json that will not parse is read as an empty registry, and the bot starts anyway with a warning — /guilds is the only way to repair the registry, so Discord has to come up even when the registry is broken.

key and account in guildsConfig.json are immutable, and the commands enforce it. account is the key prismarine-auth hashes for its token cache: editing it by hand silently starts a fresh device-code flow against a different cache file, against an account nothing is signed in to. Remove the guild and add it again instead.

Per-guild channel overrides live in guildsConfig.json, not in auditChannelConfig.json — so removing a guild cannot leave an orphaned channel setting behind. officerChannelId and crossBridgeOfficer live there too, alongside crossBridge; see Officer chat. officerChannelId is the one channel field guilds may deliberately share — replies typed there are routed by guild tag.

Each file is cached in memory after its first read and written back whole on a change. Hand-editing a file while the bot is running will be overwritten by the next write; stop the process first.

Never print or share these. .env holds a bot token, .minecraft-auth/ holds live Microsoft credentials, and guildsConfig.json holds account addresses — which is why /guilds masks them in every reply.

Next

• Configuration
• Hypixel guilds
• Updating