Description
Changelog
Reviews (0)

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.
  • setStatInt called 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.

Reviews

Steam Schema Lint has no reviews yet.

Login to write a review.

Consider supporting the creators!

If you enjoyed this asset consider supporting its creator. Follow the link below.