LiveriaDevs-AchievementSync icon

AchievementSync

Keep Steam achievements with mods and cheats. Syncs past progress and clears cheated item marks.

Last updated 3 weeks ago
Total downloads 2735
Total rating 4 
Categories Mods Tweaks Misc Client-side
Dependency string LiveriaDevs-AchievementSync-1.2.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

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

  1. Install with r2modman / Thunderstore Mod Manager (BepInExPack_Valheim required)
  2. Or place LiveriaDevs.AchievementSync.dll into BepInEx/plugins/
  3. 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.