Check your Steamworks achievements before your players do.
Steam.setAchievement("ACH_BOSS_DEFEAT") returns false and logs nothing. The achievement silently never unlocks, and you find out from a review six months later.
Steam Schema Lint checks the other way round: it reads your GDScript, finds every Steam call, and compares the names against the achievement definitions from your Steamworks export.
What it catches
- Unknown achievement names, including case mismatches.
setStatIntcalled on a stat declared FLOAT.- Names built at runtime, which cannot be checked.
- Achievements declared but never unlocked anywhere in the code.
What else it does
- Validates the schema itself: 32 achievements per group, duplicate stat IDs, missing English text, stat types and ranges.
- Writes the Stats VDF Steamworks imports, in the exact shape it expects.
- Reads the raw Stats block of a game you already shipped, keeping bit indices and the icon hashes Steam assigned.
Install
Copy the folder addons/steam_schema_lint/ into your project. Nothing to enable, there is no interface.
Use
godot --headless --script res://addons/steam_schema_lint/cli.gd -- check --scan res://game
godot --headless --script res://addons/steam_schema_lint/cli.gd -- export --out res://steam/achievements_VDF.txt
check exits with code 1 when it finds an error, so a CI step fails on a typo before an upload does.
License
MIT. Use it, fork it, ship it in commercial projects, keep the copyright notice.
The editor dock, the icon pipeline and the per-language form are the paid version: Steam Achievements Studio.
Changelog for version 1.0.0
2026-10-21 18:06:34
No changelog provided for this version.