Repository navigation
Personal Progression
New in 2.1.0. On by default.
In vanilla Valheim, boss progress belongs to the world. The moment anyone defeats Eikthyr, every player on the server - including one who joined five minutes ago - gets Haldor's and Hildir's later stock, the harder spawns and the later raids. On a busy server a new player walks straight into content tuned for your veterans.
ServerGuard makes that progress belong to each character instead.
| Vanilla | With ServerGuard | |
|---|---|---|
| Who earns a boss | Everyone on the server | Players who damaged the boss and were within 50 m when it died |
| Trader stock (Haldor, Hildir) | Server-wide progress | Your own progress |
| Key-gated spawns | Server-wide progress | Your own progress (see Limits) |
| Raids | Server-wide progress | The targeted player's own progress |
| Hildir's quests | Any player's chest unlocks her stock for everyone | Only the player who returned the chest |
| Start-temple altars | One shared set of trophies | Each player sees only the trophies they offered |
| Forsaken powers | Anyone can pick any power once a trophy is up | Only from an altar you filled yourself |
World modifiers - no map, combat and resource rates, and so on - are unaffected and stay shared.
-
Bosses: every player who hit the boss at least once and was within
progressionCreditRadius(default 50 m) when it died. Standing nearby without fighting doesn't count; neither does fighting and then running off. - Trolls, surtlings, bats, the Serpent and the Writhan (not bosses in the game data, but their keys unlock raids or stock): the same rule, except that a creature killed in a single hit falls back to "within 50 m", because the game may not have recorded the hit yet.
- The Deep North boss (Kall Fimbulbringer) is a three-phase fight: phase 1 records its own key, and the boss counts as defeated when the final phase dies.
- Hildir's quests: the player who handed in the chest.
- Killing a boss you have already beaten changes nothing; a newcomer in the group earns it.
- An altar lights up only for a character who offered that boss's trophy there. Other players see it empty.
- You can only offer a trophy for a boss you have defeated (
personalAltarsRequireKill) - a trophy handed to you by a friend won't take hold. - A forsaken power can only be chosen from an altar you filled. A power picked earlier from someone else's trophy is cleared when you log in, with a message saying why.
- Trophies that were already on the shared altars before the update are hidden, not destroyed. Turn the feature off and they are visible again.
When the ledger is first created for your world, everyone registered at that moment (plus your owners and moderators) may import the boss kills their character file already records. Vanilla gives those to every player who was near a boss when it died. The import happens once per character, on their next login, and only covers bosses this world has actually seen. Their altars are lit for the bosses they bring across.
Everyone else starts from scratch - including characters created later and characters brought over from single-player or another server. Progress the server never granted is removed from the character and reported to the admin channel.
| Command | What it does |
|---|---|
sg progress |
Status: on/off, how many characters are recorded, which bosses the world has seen, whether player-based raids are on. |
sg progress <player> |
One character's progress and altars. |
sg progress grant <player> <boss|key|all> |
Give a boss (or a key such as hildir1). all = every boss the world has seen. |
sg progress revoke <player> <boss|key|all> |
Take it away again (also clears that boss's altar). |
sg progress altar <player> <boss> [on|off] |
Light or clear one start-temple altar. |
sg progress reset <player> |
Clear everything; the character starts from scratch. |
<player> is a character name (spaces are fine), a SteamID if that account has one character, or steamid:name. Boss names: eikthyr, elder, bonemass, moder, yagluth, queen, fader, frozenking (also kall, fimbulbringer), frozenkingp1 (the phase-1 key only), hive, serpent, writhan. Changes reach the player's game immediately and are posted to the admin channel.
| Setting | Default | |
|---|---|---|
enablePersonalProgression |
true |
Master switch. false restores shared vanilla progress at once - nothing is lost. |
progressionKeys |
defeated_*, killedtroll, killed_surtling, killedbat, hildir*
|
Which world keys count as progress. A trailing * matches anything. |
progressionCreditRadius |
50 |
Metres. |
progressionRequireDamage |
true |
false = anyone within the radius earns it. |
progressionSeedFromCharacters |
true |
The one-time import described above. |
progressionForcePlayerRaids |
true |
Keeps the Player based raids world modifier on. If ServerGuard switched it on, it switches it off again when you disable the feature. |
enablePersonalTemple |
true |
Personal start-temple altars. |
personalAltarsRequireKill |
true |
Trophies only take hold for players who defeated that boss. |
progressionDiscordPosts |
true |
See below. |
Everything hot-reloads.
- Public: "Alice and Bob defeated The Elder for the first time!" - first-time kills of real bosses only (the creature is flagged as a boss in the game data); staff are left out, as with every public post. Since 2.2.0 the Serpent, the Writhan, the Hive and the first phase of Kall Fimbulbringer are posted to the admin channel only.
- Admin: every credit with the players involved (and anyone who was nearby without damaging the boss), bosses that died with nobody qualifying, one-time imports, and players arriving with progress the server never granted.
Progress lives in BepInEx/config/ServerGuard/conf/progress.yaml, one entry per character. It belongs to one world: start a new world and the old file is archived as progress.<worldid>.yaml.bak and a fresh one begins. Prefer the sg progress commands, but hand edits work and hot-reload. If the file can't be read, the feature switches itself off (shared progress) and nothing is written until you fix it, so a typo can't wipe everyone's progress.
Staff can try the feature without fighting: sg test kill [player] <boss> credits a kill through the same code as a real one, and sg test reset <keys...> [altars] confirm wipes chosen keys from every character (a dry run without confirm). See Admin Commands.
- Spawns in a mixed group. Valheim decides spawns on the game of whichever player "owns" that area. When a new and a veteran player play side by side, the owner's progress decides the key-gated spawns there. Alone, everyone gets their own.
- Everyone must run 2.1.0 or later. The altars, raid checks and character sync run on each player's game.
- Only progress keys are personal. Items, buildings and portals are shared as in vanilla - a veteran can still hand a newcomer iron.