AchievementSync
Keep Steam achievements with mods and cheats. Syncs past progress and clears cheated item marks.Achievement Sync
Client-side Valheim mod that keeps Steam achievements working while using mods and console cheats, and syncs previously recorded progress into the achievement track so already completed goals can unlock.
Features
- Steam achievements work with mods,
devcommands, cheated items, and cheated world modifiers - Syncs previously recorded progress (builds, piece removes, crafts, kills, pickups, food, etc.) on character load
- Re-checks achievement unlocks after sync
- Clears the “obtained through cheats” mark from player inventory, loaded containers, and world drops
- Blocks
Inventory.ItemCheatedchecks used by CraftFromContainers-style mods - Manual resync hotkey: F7 (configurable)
What sync can and cannot restore
Can restore: cumulative stats Valheim already saved — builds, kills, crafts, pickups, food, piece names, etc.
Cannot reconstruct: one-off events that were never written to a persistent marker while achievements were blocked. If Valheim never stored that progress, the mod has nothing to sync.
Install
- Install with r2modman / Thunderstore Mod Manager (
BepInExPack_Valheimrequired) - Or place
LiveriaDevs.AchievementSync.dllintoBepInEx/plugins/ - Load your character in-game
Config
BepInEx/config/liveriadevs.valheim.achievementsync.cfg
| Option | Default | Description |
|---|---|---|
EnableAchievements |
true |
Allow achievements with mods/cheats |
SyncPastStats |
true |
Sync previously recorded stats into the achievement track on load |
ClearItemCheatFlags |
true |
Clear cheated marks on player inventory and on any inventory add |
ClearContainerCheatFlags |
true |
On sync, clear cheated marks in loaded chests / ship storage / tombstones |
ClearWorldDropCheatFlags |
true |
On sync, clear cheated marks on loaded world ItemDrops |
ResyncKey |
F7 |
Force sync and unlock check |
Notes
- Client-side only
- Keep only one achievement-enabler / sync mod enabled (do not stack with Unshamed, AchievementEnabler, FixAchievements, etc.)
Changelog
See CHANGELOG.md.
