BossRules

BossRules

Forsaken powers overhaul, despawn abandoned bosses with offering refunds, hover an altar to see the offering and boss.
Select Forsaken Powers remotely, block duplicate summons, personalize boss stones, and pressure tames near bosses.

You can select Forsaken Powers remotely using radial menu.

You can change the boss despawn range and delay in the config.

Getting away from the boss with also count for despawn.

If you get back in time, despawn would be canceled. If the boss does despawn offerings would be refunded.

Highlights

• Edit boss altars without rebuilding locations by hand.
• Block duplicate boss summons from both altars and CreatureSpawner.
• Despawn abandoned bosses and optionally refund real altar offerings.
• Pressure tamed creatures near bosses so boss arenas stay dangerous.
• Give each player their own boss stone unlock state.
• Let players rotate unlocked Forsaken Powers remotely.
• Rebalance Forsaken Power duration, cooldown, costs, regen, damage, armor, movement, skills, and tooltips.
• Sync server YAML to clients through ServerSync.
• Reload YAML while the game is running.

Why Use BossRules

BossRules focuses on the awkward parts of boss management that usually live across several systems:

• Altars can be edited by prefab name with generated reference data.
• Boss duplicate protection keeps respawn timers honest instead of letting cooldowns finish in the background.
• Altar refunds are tied to actual altar-summoned bosses, not nearby world spawns.
• Boss stones and Forsaken Powers can be customized without turning the mod into a general status-effect editor.
• Dedicated servers remain the source of truth for synced rule files.

Generated Files

BossRules creates its files under:

BepInEx/config/BossRules/

Files:

• BossRules.altar.yml: boss altar and boss item stand overrides.
• BossRules.altar.reference.yml: generated reference for loaded boss altar and boss stone prefabs.
• BossRules.yml: boss despawn and boss tamed pressure rules.
• BossRules.forsakenPowers.yml: Forsaken Power stat edits in a DataForge-compatible row format.
• sighsorry.BossRules.cfg: synced BepInEx feature toggles.

Server admins should edit the YAML on the server or host. Synced YAML is pushed to clients automatically. Optional BossRules.<Language>.yml or .json message translations are discovered recursively under BepInEx. The release package includes BossRules.English.yml as an editable translation template.

Boss Altars

BossRules.altar.yml supports compact altar entries:

• prefab
• enabled
• offeringBowl
• itemStands

Use the generated BossRules.altar.reference.yml to find real prefab names, item stand paths, and current altar values. Copy only the rows you want to override into BossRules.altar.yml.

With More World Locations AIO installed, automatic reference generation skips its location interiors before loading their assets. New partial references are marked in the file; existing full references are preserved. This only limits automatic discovery: MWL overrides in BossRules.altar.yml still apply. If MWL's asset manifest cannot be read, automatic generation is deferred for that world instead of forcing a full scan.

For all locations, run bossrules:reference altar on the host or dedicated-server console after the world has loaded. This explicit full scan can pause the game/server and use substantial memory. Remote clients do not perform location reference scans.

With no altar overrides applied, unconfigured locations skip recursive altar component scans. Once an override begins, BossRules retains its existing restoration path for subsequent locations. Locations remain registered for live YAML changes; a newly configured altar captures its baseline immediately before its first override.

When a location contains multiple OfferingBowl components, the generated reference writes one row per bowl with an offeringBowl.path. Single-bowl locations keep the compact pathless format. Existing pathless overrides remain compatible and select the first bowl, while an explicit missing path skips that row.

BossRules intentionally does not own general location editing, object drops, runestone pins, or vegvisir rewards.

Personal first-victory summons (optional YouAreNotWorthy integration)

With BossRules 1.1.2+ and YouAreNotWorthy 1.0.8+ installed on the host/server and clients, the synced Personal Progression Summons option (default On) enables these inner altars:

| Altar | Free summon condition | | --- | --- | | Queen (offeraltar_queen, inside DG_DvergrBoss) | Personal defeated_queen is missing | | Frozen King (offeraltar_FrozenKing_bossroom) | Personal LastBossGate_Open is present and defeated_frozenking_p3 is missing |

Use the displayed Use interaction (normally E); no offering item in the inventory is required. Using the matching offering item also requests a free summon when eligible. YNW's item progression requirements still apply. The Frozen King final phase key is used, not the first phase's defeated_frozenking. After personal completion, the normal offering and configured amount apply. The exterior Frozen King gate keeps its normal cost and key-grant behavior.

These are free attempts until completion, not a one-use voucher or a location reset. An eligible player can summon for their group. Free summons have no offering refunds, including after despawn, save/reload, or a later setting change. Native spawn delay/effects and existing enabled duplicate/cooldown rules remain. Bowls changed to use item stands, grant a key, spawn an item, or summon a different boss are excluded from this integration.