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)

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.

Changelog

1.2.0

• Clear cheated marks from loaded containers and world drops on sync (configurable)
• Strip cheated marks on any Inventory.AddItem (player, chests, transfers)
• Force Inventory.ItemCheated checks to false so CraftFromContainers-style mods do not keep blocked marks
• Clarify README: sync restores previously recorded progress only; one-off unstored events cannot be reconstructed
• Align assembly FileVersion / ProductVersion with plugin version 1.2.0
• Release build without embedded local PDB paths

1.1.1

• Cleaned package readme and short description for Thunderstore

1.1.0

• First Thunderstore release
• Achievement Sync for mods and cheats
• Past-stat sync and unlock re-check on character load
• Manual resync hotkey (F7)
• Clears cheated item marks

1.0.0

• Initial private build