AchievementSync

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.ItemCheated checks 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 Mod Manager (BepInExPack_Valheim required)
• Or place LiveriaDevs.AchievementSync.dll into BepInEx/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.