---
name: blazium-steam
description: >
  Integrates Blazium native Steam singleton on 0.8.x / 4.8.x (not GodotSteam):
  session tickets → JWT, achievements, stats, inventory. Use when
  authenticating with Steam or syncing Steamworks runtime data. Not SteamPipe.
when-to-use: >
  Steam, request_web_api_ticket, authenticate_with_server, set_achievement,
  store_stats, steamworks, GodotSteam
metadata:
  author: blazium-games
  short-description: Native Steam tickets, achievements, and stats
---

# Blazium Steam

Native Steamworks (`blazium/modules/steam/` class `Steam`). **Not GodotSteam.**
Baseline: **Blazium 0.8.x (Godot 4.8.x fork, branch `blazium_4.8`)**.

**Nightly caveat:** `LoginClient` methods that wrap Steam tickets live in
script templates and https://docs.blazium.app — not as C++/xml class docs
in the installed editor. The `Steam` singleton **is** in installed Blazium.
Do not invent LoginClient APIs.

**Version drift:** inspect `config_version` / `features` in `project.blazium`
(or `project.godot`). Keep `blazium_4.8`-safe APIs unless the user asks to migrate.

The library loads at runtime. If missing, methods fail gracefully
(`is_available()`). Publishing depots / steamcmd → growth pack
`blazium-steam-publish`.

## When to use

- Use when requesting a Steam Web API ticket and exchanging it for a JWT.
- Use when unlocking achievements, stats, or inventory/promo items.

**When not to use:** JWT storage / Discord login → `blazium-services`.
GodotSteam community APIs → do not use. SteamPipe / steamcmd →
`blazium-steam-publish`.

## Grok host

Load this file plus at most one pin (`blazium-services` after a ticket JWT,
or `blazium-steam-publish` for depots). Spawn `blazium-live-ops-specialist`
for ticket exchange and `security-engineer` if JWT storage is in scope.
Child prompts must include AppID (default Spacewar `480` unless the user
sets `GAME_STEAM_ID`), whether Steam is running, and that Autowork cannot
fake Steamworks. Do not dump the catalog.

Grok `code_execution` is not Steam evidence. Quote a Steam-logged client,
play-mode MCP, or `INCONCLUSIVE`.

## Workflow

1. **Inspect.** `Steam.is_available()`. Confirm app id. Reject GodotSteam
   callables.
2. **Choose.** Ticket → backend JWT for Services; or local Steamworks
   (achievements/stats) without login.
3. **Implement.** `Steam.initialize(app_id)` → `request_web_api_ticket()` →
   `web_api_ticket_ready` → `authenticate_with_server(url, ticket, app_id)` →
   persist JWT via `blazium-services`. Pump `poll_callbacks()`.
4. **Verify.** Ticket path with Steam running. Autowork cannot fake Steamworks
   — use a Steam-logged client or document the gap.
5. **Handoff.** JWT to `blazium-services` / `blazium-lobby`.

## Patterns

### Ticket → JWT

```gdscript
Steam.initialize(app_id)
Steam.web_api_ticket_ready.connect(_on_ticket)
Steam.request_web_api_ticket("blazium")

func _on_ticket(ticket: String) -> void:
	var result: SteamAuthResult = Steam.authenticate_with_server(auth_url, ticket, app_id)
	# persist result JWT in user://blazium.cfg (blazium-services)
```

### Achievements / stats

```gdscript
Steam.request_current_stats()
Steam.set_achievement("FIRST_WIN")
Steam.store_stats()
```

`clear_achievement` / `clear_stat` also need `store_stats()` to persist.
Inventory: `add_promo_item`, `load_item_definitions` as documented on `Steam`.

## Output contract

- AppID used (Spacewar `480` or `GAME_STEAM_ID`)
- Path taken (ticket → JWT vs local achievements)
- `Steam.is_available()` result
- Evidence: Steam-logged client, play-mode MCP, or `INCONCLUSIVE`
- Next skill (`blazium-services`, `blazium-lobby`, `blazium-steam-publish`)

## Pitfalls

- **Used GodotSteam** → wrong module. Use Blazium `Steam` only.
- **Forgot `store_stats()`** → achievement stays in memory.
- **Taught SteamPipe here** → publish adapter.
- **Invented LoginClient Steam methods** → template + nightly only.

Live Steamworks cases are gated. Defaults use Spacewar AppID `480` via
`steam_appid.txt`. Override `GAME_STEAM_ID` locally — do not invent an App ID.

## Resources

- Tests: https://github.com/blazium-games/steam_module_tests
- Module: `blazium/modules/steam/doc_classes/Steam.xml`
- Classes: `Steam`, `SteamAuthResult`, `SteamAchievementInfo`,
  `SteamInventoryItem`, `SteamItemDefinition`
- JustAMCP: `docs_get_class` for `Steam`

## Related skills

- `blazium-services` — persist / parse JWT
- `blazium-discord` — alternate identity
- `blazium-steam-publish` — depots