BossGate

💬 Join the Discord

💡 Suggestions, bugs and questions: https://discord.gg/aMkN89Cuas — when reporting a bug, attach your BepInEx LogOutput.log and say what you expected to happen.

Lock boss summoning by game day. Put the offering on the altar before the boss is unlocked and you get a message on your screen instead of a fight. The offering is not consumed.

⭐ Recommended companion: Ultimate Server Configuration Manager (Ultimate SCM), by the same author. Change every BossGate setting inside the game and the whole server gets it live. 👉 Open it on Thunderstore

Features


Per-boss unlock day	One setting per boss. `0` = disabled (default), up to `9999`. The boss can be summoned from that day onwards.
Master lock	`LockAllBosses` (default `false`). When `true`, no boss can be summoned, on any day.
On-screen message	A short message in the middle of the player's screen, on two lines: "Boss unlocks on day X" and "Current day: Y" (or "Boss summoning is not possible right now."). Nothing is written to the text chat.
15 languages	The message follows each player's own game language.
Server-controlled	The server's config is the only one that counts.
Live changes	Change a setting with Ultimate SCM while the server runs and every connected player gets it at once.

Bosses: Eikthyr, The Elder, Bonemass, Moder, Yagluth, The Queen, Fader and Kall Fimbulbringer (Deep North, Valheim 1.0).

⭐ Recommended: change it in-game with Ultimate Server Configuration Manager

BossGate works on its own, but it is built to go together with Ultimate Server Configuration Manager, a panel that shows the settings of all your BepInEx mods in one place.

Everything is synchronized in real time, inside the game. When the admin applies a change in the panel, the server updates BossGate right away and BossGate sends the new rule to every connected player. The next offering placed on any altar already uses the new rule. Nobody has to relog, and the server does not restart.

How to use it:

Open the panel (ESC → Mod Settings, or F1). As an admin, type devcommands in the console (F5) first. If F1 is already used by ConfigurationManager, change the key of one of the two.
Pick BossGate in the mod list.
Set 1 - Eikthyr, 2 - The Elder... 8 - Kall Fimbulbringer, or turn LockAllBosses on.
Apply. Every connected player gets the new rule instantly.

Why it fits well:

Every BossGate setting is tagged scm:live, so the panel shows the LIVE badge: the change really takes effect immediately.
Undo (Ctrl+Z), draft mode (change several bosses, apply them all at once), admin notes and a "who changed what, and when" history come with the panel.
You choose what players see: Hidden (default), View only (they can see the unlock days, but not change them) or Can edit. For BossGate the server's value is enforced for everyone in all three cases; Can edit does not let a player change their own rule.
Install Ultimate SCM on the server and on every client.

Without Ultimate SCM BossGate still works: the server uses its BepInEx/config/Igao.BossGate.cfg and sends the values to every player when they join. See Known limitations about editing that file by hand.

Configuration

File: BepInEx/config/Igao.BossGate.cfg — edit it on the server. The values on a player's own .cfg are ignored (and never overwritten) when the player is connected to a server running BossGate.

[1 - General]

Setting	Default	Values	What it does
`LockAllBosses`	`false`	`true` / `false`	Blocks every boss on every day, ignoring the unlock days below. Players see "Boss summoning is not possible right now."
`KickClientsWithoutMod`	`false`	`true` / `false`	Disconnects players who join without BossGate (or with an incompatible BossGate version) about 20 seconds after joining. Without it, a client that does not have the mod can still summon bosses.

[2 - Boss Unlock Day]

All eight settings work the same way: default 0, range 0–9999. 0 means no restriction. Any other value means the boss can be summoned only when the current game day (the day number shown by the game) is equal to or greater than the value. Example: 3 - Bonemass = 20 blocks Bonemass until the game shows day 20.

Setting	Boss
`1 - Eikthyr`	Eikthyr
`2 - The Elder`	The Elder
`3 - Bonemass`	Bonemass
`4 - Moder`	Moder
`5 - Yagluth`	Yagluth
`6 - The Queen`	The Queen
`7 - Fader`	Fader
`8 - Kall Fimbulbringer`	Kall Fimbulbringer

Multiplayer

Install the mod on the server and on every client.
When a player joins, the server sends its config; the player's own .cfg is ignored.
If the server does not run BossGate, the client does nothing.
Singleplayer and the host of a listen server use their own .cfg.

Known limitations

The rule is checked on the player's own game, not by the server. A client without BossGate can still summon bosses unless KickClientsWithoutMod is on, and a player running a modified client can get around any client-side check. KickClientsWithoutMod cannot stop modified clients.
BossGate does not watch its .cfg file. If you edit Igao.BossGate.cfg by hand while the server is running, restart the server for the change to apply, or make the change in Ultimate SCM instead. (Ultimate SCM can also reload edited .cfg files on its own: it checks every 60 seconds.)
A player removed by KickClientsWithoutMod gets a plain disconnect; no explanation is sent.
The rule applies to every player, admins included. Bosses spawned with console commands are not affected, and bosses that are already alive are not touched: only placing the offering is blocked.
The Queen has no offering on her first fight, so BossGate gates the Sealbreaker instead: while The Queen is locked (6 - The Queen day, or LockAllBosses), the Infested Citadel door cannot be opened with the Sealbreaker and the player gets the on-screen message. Summoning her again with Seeker soldier trophies on the hive seat is gated by the same setting. The Sealbreaker is detected by the key item of the door (item id DvergrKey), so any door that uses that key follows The Queen's setting. Each door used is written once to LogOutput.log (Door used). The door is also blocked from being closed again while the lock is active.
Fader is summoned with 3 Bells on the coliseum's item stands: placing the bells is allowed, activating the altar is what gets blocked.
Bosses are recognized by the names of the altar's boss and offering item. If a game update renames them, that boss stops being gated until BossGate is updated.

Languages

English, Portuguese (Brazil), Portuguese (Portugal), Spanish, French, German, Italian, Dutch, Polish, Swedish, Turkish, Russian, Japanese, Korean, Chinese. The files are in plugins/Translations/ and can be edited; keys are msg_locked_day ({boss}, {day}, {current}) and msg_locked.

Installation

Install with a mod manager (Thunderstore / r2modman), or copy BossGate.dll and the Translations folder to BepInEx/plugins/.

_{AI tools were used to help review the code and hunt down bugs. All features were designed by the author.}

Found a bug? Got an idea for BossGate?
💬 https://discord.gg/aMkN89Cuas