Achievement Sync

Author: LiveriaDevs

Client-side Valheim mod that keeps Steam achievements working while you use mods and console cheats — and that can pull past cheated progress (builds, piece removes, crafts, kills, …) into the clean achievement track so already-completed goals can unlock.

Why this exists

Valheim 1.0 stores stats in two places:

1. A raw track that always counts everything (including cheats / modded sessions)
2. A clean achievement track that only receives increments when achievements are allowed

If you placed hundreds of pieces with nocost / mods while achievements were blocked, Steam never saw that progress. Achievement Sync copies the raw track into the achievement track on character load and re-checks unlocks.

Features

• Allow Steam achievements with mods, devcommands, cheated items, and cheated world modifiers
• Uses Valheim’s official bypass path (s_bypassCheatChecks) plus a hard guarantee on CanGetAchievements
• Treats future placement / destroy / craft / pickup / kill / food stats as non-cheated for achievement counting
• Syncs past stats (builds, BuildPiecesRemoved, named piece stats, etc.) on character load
• Clears the grey “obtained through cheats” item mark (inventory + tooltip)
• Manual resync hotkey: F7 (configurable)

Install

1. Install with r2modman / Thunderstore Mod Manager (profile with BepInExPack_Valheim)
2. Or drop LiveriaDevs.AchievementSync.dll into BepInEx/plugins/
3. Launch the game, load your character — check BepInEx/LogOutput.log for sync messages

Config (BepInEx/config/liveriadevs.valheim.achievementsync.cfg)

Option	Default	Meaning
EnableAchievements	true	Master switch for achievement bypass
SyncPastStats	true	Copy raw → achievement track on load
ClearItemCheatFlags	true	Strip cheated marks from inventory items
ResyncKey	F7	Force another sync + unlock check

Notes

• Client-side only. Works in solo / when you are the host. Dedicated servers don’t need this for your local Steam unlocks.
• Sync recovers progress Valheim already stored in the raw stat track. Actions never recorded at all cannot be invented.
• Steam unlock timestamps are always “now” when Steam receives them — backdating is not possible via the public API.
• Compatible with QoL mods. If you also use another achievement-enabler mod, keep only one enabled to avoid double-patching.

Changelog

See CHANGELOG.md.