Lockstep

The next boss stays sealed until every player on the server has defeated the previous one. Fast players wait for the group; nobody skips ahead. Server synced, live config reload.

Features

• Each boss altar only works once everyone in the group has defeated the boss before it. The altar says who the group is still waiting for.
• Credit is per player: everyone who hit the boss is credited, plus everyone within a configurable distance when it dies. Admins can grant or revoke credit.
• The roster fills itself as players log in. Players who have been away for a configurable number of days stop holding the group back, and admins can ignore or forget players.
• New players catch up automatically with everything the world has already cleared (configurable).
• Installing mid-playthrough is safe: bosses the world had already defeated count as cleared for everyone.
• The chain is a YAML file, so modded bosses can be added and the order changed.
• Server enforces its settings for all connected players; "Lock Configuration" prevents clients from overriding them

How to Install

1. Install BepInEx for Valheim.
2. Install this mod on the server and on every client. Clients without it are rejected by the server.

For manual install, drag Lockstep.dll into the BepInEx/plugins folder.

Console commands

Run from the in-game console (F5). The changes are made on the server and answered there.

lockstep status                    every stage: open or waiting for whom, and the roster
lockstep grant <player> <stage>    credit a player with a boss           (admin)
lockstep revoke <player> <stage>   take that credit away                 (admin)
lockstep ignore <player>           the player never holds the group back (admin)
lockstep unignore <player>         count the player again                (admin)
lockstep forget <player>           remove the player from the roster     (admin)

<player> is a name or a player ID, <stage> is a stage name from the chain (Eikthyr, TheElder, Bonemass, Moder, Yagluth, TheQueen, Fader) or its global key.

Files

• Lockstep.cfg: credit radius, inactive days, late joiner mode, gate options. Hot reloaded, synced.
• LockstepChain.yml: the chain of stages, one entry per boss with its order, global key and boss prefab. Hot reloaded, synced.
• Lockstep.<world>.roster.yml: written by the server, one entry per player with last seen, ignored flag and cleared stages. Hot reloaded when an admin edits it.

Building

Requirements: .NET SDK 8, Valheim installed with BepInEx, and the ValheimModLibs repository checked out next to this one. pack.ps1 builds the mod and creates a Thunderstore zip in thunderstore/.

dotnet build Lockstep/Lockstep.csproj -c Release

Bugs and feature requests

The source lives on GitHub. Found a bug or want a feature? Open an issue at https://github.com/geraldjglasgow/ValheimMods/issues and name the mod, its version and what happened.

License

MIT. Copy it, change it, build on it, ship it, free of charge. The only condition is keeping the copyright and license notice from the LICENSE file.