Skip to content

Commit 5d165d4

Browse files
committed
v0.7.0 "Full Power" - add testing sandbox skill, 6 MCP write tools, enhanced App ID validation
New skill: - steam-testing-sandbox: App ID 480 (SpaceWar) dev sandbox, test accounts, Steam console commands, partner test environments, dev-to-production checklist MCP write tools (added to companion steam-mcp v0.3.0): - steam.createLobby (SDK guidance), steam.uploadWorkshopItem (SDK guidance) - steam.updateWorkshopItem, steam.setAchievement, steam.uploadLeaderboardScore, steam.grantInventoryItem (partner API POST) Rule update: - steam-appid-validation.mdc: added MCP live validation via steam.getAppDetails() Plugin now at 29 skills, 9 rules, 16 MCP tools. Made-with: Cursor
1 parent f0a4896 commit 5d165d4

File tree

8 files changed

+252
-17
lines changed

8 files changed

+252
-17
lines changed

.cursor-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"name": "steam-cursor-plugin",
33
"displayName": "Steam Developer Tools",
4-
"version": "0.6.0",
5-
"description": "Integrates Steam and Steamworks APIs for game developers and power users. 28 skills covering store data, multiplayer, cloud saves, leaderboards, input, inventory, social, profiles, comparisons, reviews, pricing, market research, wishlists, CI/CD, release checklists, steamcmd, community, store pages, pricing strategy, DLC, playtesting, bug reporting, and anti-cheat - plus 9 rules. Companion Steam MCP server provides 10 live API tools.",
4+
"version": "0.7.0",
5+
"description": "Integrates Steam and Steamworks APIs for game developers and power users. 29 skills covering store data, multiplayer, cloud saves, leaderboards, input, inventory, social, profiles, comparisons, reviews, pricing, market research, wishlists, CI/CD, release checklists, steamcmd, community, store pages, pricing strategy, DLC, playtesting, bug reporting, anti-cheat, and testing sandbox - plus 9 rules. Companion Steam MCP server provides 16 API tools.",
66
"author": {
77
"name": "TMHSDigital",
88
"url": "https://github.com/TMHSDigital"

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,26 @@ All notable changes to Steam Developer Tools will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.7.0] - 2026-03-28
9+
10+
### Added
11+
12+
- **steam-testing-sandbox** skill: development sandbox guide — App ID 480 (SpaceWar) usage, test account setup, Steam client console commands, partner test environments, and dev-to-production checklist
13+
- **6 new MCP write tools** in companion Steam MCP server (v0.3.0):
14+
- `steam.createLobby` — SDK guidance for ISteamMatchmaking lobby creation (C++/C#/GDScript)
15+
- `steam.uploadWorkshopItem` — SDK guidance for ISteamUGC Workshop uploads (C++/GDScript)
16+
- `steam.updateWorkshopItem` — HTTP POST to update Workshop item metadata via partner API
17+
- `steam.setAchievement` — HTTP POST to set/unlock achievements via partner API (dev/test)
18+
- `steam.uploadLeaderboardScore` — HTTP POST to upload scores via partner API
19+
- `steam.grantInventoryItem` — HTTP POST to grant inventory items via partner API
20+
21+
### Changed
22+
23+
- `steam-appid-validation` rule enhanced with MCP live validation — suggests `steam.getAppDetails()` to verify App IDs exist
24+
- Plugin version bumped to 0.7.0
25+
- Plugin description updated to reflect 29 skills and 16 MCP tools
26+
- All documentation updated: README, CLAUDE.md, CONTRIBUTING.md, ROADMAP.md
27+
828
## [0.6.0] - 2026-03-28
929

1030
### Added
@@ -116,6 +136,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
116136
- **steam-deck-compat** rule: flags common Steam Deck compatibility issues (hardcoded resolutions, mouse-only input, anti-cheat, Windows-only paths, missing controller support)
117137
- Plugin manifest, README, CONTRIBUTING guide, and license
118138

139+
[0.7.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.7.0
119140
[0.6.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.6.0
120141
[0.5.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.5.0
121142
[0.4.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.4.0

CLAUDE.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
**Steam Developer Tools** is a Cursor IDE plugin (v0.6.0) that integrates Steam and Steamworks APIs for game developers and power users. It provides AI-assisted workflows for querying Steam store data, managing Steamworks configurations, building multiplayer networking, implementing cloud saves, leaderboards, input, inventory/economy, social features, looking up API docs, fetching player statistics, integrating Workshop UGC, designing achievements, looking up player profiles, comparing games, analyzing reviews, researching pricing, evaluating market fit, estimating wishlists, automating builds, validating release readiness, scripting steamcmd, managing communities, optimizing store pages, planning pricing strategy, configuring DLC, setting up playtests, creating bug report workflows, and integrating anti-cheat.
7+
**Steam Developer Tools** is a Cursor IDE plugin (v0.7.0) that integrates Steam and Steamworks APIs for game developers and power users. It provides AI-assisted workflows for querying Steam store data, managing Steamworks configurations, building multiplayer networking, implementing cloud saves, leaderboards, input, inventory/economy, social features, looking up API docs, fetching player statistics, integrating Workshop UGC, designing achievements, looking up player profiles, comparing games, analyzing reviews, researching pricing, evaluating market fit, estimating wishlists, automating builds, validating release readiness, scripting steamcmd, managing communities, optimizing store pages, planning pricing strategy, configuring DLC, setting up playtests, creating bug report workflows, integrating anti-cheat, and providing a testing sandbox.
88

9-
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) (separate repo) which provides 10 read-only API tools for live data access. No build system, no npm, no compiled code in this repo.
9+
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) (separate repo) which provides 16 API tools (10 read-only + 6 write/guidance) for live data access. No build system, no npm, no compiled code in this repo.
1010

11-
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.7.0 "Full Power") adds MCP write operations. Subsequent releases add polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
11+
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.8.0 "Polish") adds refinement and gap-filling. Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
1212

1313
## Plugin Architecture
1414

@@ -18,7 +18,7 @@ skills/<skill-name>/SKILL.md - AI workflow definitions (one per skill)
1818
rules/<rule-name>.mdc - Code quality and security rules (applied by Cursor AI)
1919
```
2020

21-
### Skills (28 total)
21+
### Skills (29 total)
2222

2323
Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**, **Required Inputs**, **Workflow**, and **Example**.
2424

@@ -52,6 +52,7 @@ Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**
5252
| `steam-playtest-setup` | Steam Playtest config, open/closed playtests, key distribution |
5353
| `steam-bug-report-template` | Bug report templates, crash dumps, system info, known issues |
5454
| `steam-anticheat-integration` | EAC, BattlEye, VAC setup, Proton/Deck compatibility |
55+
| `steam-testing-sandbox` | App ID 480 sandbox, test accounts, console commands, dev workflow |
5556

5657
### Rules (9 total)
5758

@@ -69,7 +70,7 @@ Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**
6970

7071
### Companion MCP Server
7172

72-
The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 10 read-only tools. Skills reference these tools in their `## MCP Usage` sections. When the MCP server is configured in Cursor, skills prefer MCP tool calls over shell `curl` commands.
73+
The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 16 tools (10 read-only + 6 write/guidance). Skills reference these tools in their `## MCP Usage` sections. When the MCP server is configured in Cursor, skills prefer MCP tool calls over shell `curl` commands.
7374

7475
| MCP Tool | Auth | Maps to |
7576
|----------|------|---------|
@@ -83,6 +84,12 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 10 rea
8384
| `steam.queryWorkshop({ appid })` | Key | `IPublishedFileService/QueryFiles` |
8485
| `steam.getLeaderboardEntries({ appid, leaderboardid })` | Key | `ISteamLeaderboards/GetLeaderboardEntries` |
8586
| `steam.resolveVanityURL({ vanityurl })` | Key | `ResolveVanityURL` |
87+
| `steam.createLobby({ type, max_members, metadata })` | SDK guide | ISteamMatchmaking code examples |
88+
| `steam.uploadWorkshopItem({ appid, title, ... })` | SDK guide | ISteamUGC upload code examples |
89+
| `steam.updateWorkshopItem({ publishedfileid, ... })` | Publisher key | `IPublishedFileService/UpdateDetails` |
90+
| `steam.setAchievement({ steamid, appid, achievement })` | Publisher key | `ISteamUserStats/SetUserStatsForGame` |
91+
| `steam.uploadLeaderboardScore({ appid, leaderboardid, ... })` | Publisher key | `ISteamLeaderboards/SetLeaderboardScore` |
92+
| `steam.grantInventoryItem({ appid, steamid, itemdefid })` | Publisher key | `IInventoryService/AddItem` |
8693

8794
## Development Workflow
8895

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,12 @@ Cursor will pick up changes to skills and rules without restarting.
3636

3737
## Plugin Structure
3838

39-
The plugin currently has **28 skills** and **9 rules**.
39+
The plugin currently has **29 skills** and **9 rules**.
4040

4141
```
4242
.cursor-plugin/
4343
plugin.json # Plugin manifest (name, version, metadata)
44-
skills/ # 28 skill directories
44+
skills/ # 29 skill directories
4545
<skill-name>/
4646
SKILL.md # Skill definition with frontmatter + instructions
4747
rules/ # 9 rule files

README.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<p align="center">
1212
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Steam-Cursor-Plugin/validate.yml?label=CI" alt="CI"></a>
1313
<a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-blue.svg" alt="License: CC BY-NC-ND 4.0"></a>
14-
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.6.0-green.svg" alt="Version"></a>
14+
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.7.0-green.svg" alt="Version"></a>
1515
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/stargazers"><img src="https://img.shields.io/github/stars/TMHSDigital/Steam-Cursor-Plugin?style=flat" alt="GitHub Stars"></a>
1616
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/commits/main"><img src="https://img.shields.io/github/last-commit/TMHSDigital/Steam-Cursor-Plugin" alt="Last Commit"></a>
1717
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin"><img src="https://img.shields.io/badge/Cursor-Plugin-8B5CF6.svg" alt="Cursor Plugin"></a>
@@ -22,7 +22,7 @@
2222
---
2323

2424
<p align="center">
25-
<strong>28 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>10 MCP tools</strong>
25+
<strong>29 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>16 MCP tools</strong>
2626
</p>
2727

2828
Query Steam store data, manage Steamworks app configurations, build multiplayer networking, implement cloud saves, design achievements, compare games, and look up player profiles - all from within Cursor's AI chat. Covers the full Steam &amp; Steamworks ecosystem with live data via the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp).
@@ -78,6 +78,7 @@ flowchart LR
7878
| **Steam Playtest Setup** | Configure Steam Playtest: open vs closed playtests, key distribution, signup pages, feedback collection, and Next Fest integration. |
7979
| **Steam Bug Report Template** | Structured bug report templates with Steam system info, crash dump guidance, known issues tracking, and forum integration. |
8080
| **Steam Anti-Cheat Integration** | Anti-cheat setup: EAC, BattlEye, VAC with Proton/Linux/Steam Deck compatibility matrix and server-side validation. |
81+
| **Steam Testing Sandbox** | Dev sandbox guide: App ID 480 (SpaceWar), test accounts, Steam console commands, testing achievements/leaderboards/inventory. |
8182

8283
### Rules
8384

@@ -131,6 +132,12 @@ The `STEAM_API_KEY` is only required for tools that access user-specific data (p
131132
| `steam.queryWorkshop` | Key | Search/browse Workshop items |
132133
| `steam.getLeaderboardEntries` | Key | Leaderboard scores and rankings |
133134
| `steam.resolveVanityURL` | Key | Convert vanity URL to Steam ID |
135+
| `steam.createLobby` | SDK guide | Code examples for ISteamMatchmaking lobby creation |
136+
| `steam.uploadWorkshopItem` | SDK guide | Code examples for ISteamUGC Workshop uploads |
137+
| `steam.updateWorkshopItem` | Publisher key | Update Workshop item metadata via partner API |
138+
| `steam.setAchievement` | Publisher key | Set/unlock achievements via partner API (dev/test) |
139+
| `steam.uploadLeaderboardScore` | Publisher key | Upload leaderboard scores via partner API |
140+
| `steam.grantInventoryItem` | Publisher key | Grant inventory items via partner API |
134141

135142
## Quick Start
136143

@@ -179,7 +186,7 @@ Compare Hades, Dead Cells, and Hollow Knight - price, reviews, and current playe
179186
```
180187

181188
<details>
182-
<summary><strong>More examples (all 28 skills)</strong></summary>
189+
<summary><strong>More examples (all 29 skills)</strong></summary>
183190

184191
**Store Lookup**
185192
```
@@ -321,6 +328,11 @@ I need to set up bug reporting for my game. Players keep submitting vague report
321328
I'm making a competitive FPS. I need anti-cheat that works on Steam Deck. What should I use?
322329
```
323330

331+
**Testing Sandbox**
332+
```
333+
I want to test Steam achievements in my game but I don't have an App ID yet. How do I get started?
334+
```
335+
324336
</details>
325337

326338
## Configuration
@@ -375,8 +387,8 @@ See [ROADMAP.md](ROADMAP.md) for the full themed release plan toward v1.0.0.
375387
| **v0.3.0** | Insights | Review analysis, price history, market research, wishlist estimates | Done |
376388
| **v0.4.0** | Ship It | CI/CD automation, release checklist, steamcmd helper, build validation rules | Done |
377389
| **v0.5.0** | Grow | Community management, store page optimization, pricing strategy, DLC planning | Done |
378-
| **v0.6.0** | Quality | Playtest setup, bug reporting, anti-cheat, save compat / network security / error handling rules | **Current** |
379-
| v0.7.0 | Full Power | MCP write operations (lobbies, workshop uploads, achievements, inventory) | Planned |
390+
| **v0.6.0** | Quality | Playtest setup, bug reporting, anti-cheat, save compat / network security / error handling rules | Done |
391+
| **v0.7.0** | Full Power | Testing sandbox, 6 MCP write tools (lobbies, workshop, achievements, leaderboards, inventory) | **Current** |
380392
| v0.8.0 | Polish | Cross-references, troubleshooting sections, migration guide | Planned |
381393
| v1.0.0 | Stable | Production release: 30 skills, 9 rules, 20 MCP tools | Planned |
382394

ROADMAP.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Themed release plan toward v1.0.0.
44

5-
**Current:** v0.6.0 - 28 skills, 9 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 10 read-only tools.
5+
**Current:** v0.7.0 - 29 skills, 9 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 16 tools (10 read-only + 6 write/guidance).
66

77
**Target:** v1.0.0 - 30 skills, 9 rules, 20 MCP tools.
88

@@ -13,8 +13,8 @@ Themed release plan toward v1.0.0.
1313
| v0.3.0 | Insights | 4 | 0 | 2 | 18 | 4 |
1414
| v0.4.0 | Ship It | 3 | 2 | 0 | 21 | 6 |
1515
| v0.5.0 | Grow | 4 | 0 | 2 | 25 | 6 |
16-
| v0.6.0 (current) | Quality | 3 | 3 | 0 | 28 | 9 |
17-
| v0.7.0 | Full Power | 1 | 0 | 6 | 29 | 9 |
16+
| v0.6.0 | Quality | 3 | 3 | 0 | 28 | 9 |
17+
| v0.7.0 (current) | Full Power | 1 | 0 | 6 | 29 | 9 |
1818
| v0.8.0 | Polish | 1 | 0 | 0 | 30 | 9 |
1919
| v1.0.0 | Stable | 0 | 0 | 0 | 30 | 9 |
2020

@@ -233,3 +233,6 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
233233
- [x] ~~Save compatibility rule~~ - `steam-save-compat.mdc` added in v0.6.0
234234
- [x] ~~Network security rule~~ - `steam-network-security.mdc` added in v0.6.0
235235
- [x] ~~API error handling rule~~ - `steam-api-error-handling.mdc` added in v0.6.0
236+
- [x] ~~Testing sandbox skill~~ - `steam-testing-sandbox` added in v0.7.0
237+
- [x] ~~MCP write tools~~ - 6 write/guidance tools added to steam-mcp in v0.7.0 (createLobby, uploadWorkshopItem, updateWorkshopItem, setAchievement, uploadLeaderboardScore, grantInventoryItem)
238+
- [x] ~~App ID validation MCP enhancement~~ - `steam-appid-validation.mdc` updated with live validation via MCP in v0.7.0

rules/steam-appid-validation.mdc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,3 +29,5 @@ When editing or reviewing files that reference a Steam App ID:
2929
- Is `0` or negative
3030

3131
4. **Depot ID relationships.** In VDF build configs, depot IDs should typically be `appid + N` (e.g., App ID `1234567`, depots `1234568`, `1234569`). Flag depot IDs that seem unrelated to the App ID.
32+
33+
5. **Live validation via MCP.** When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available, suggest verifying that the App ID exists in the Steam store by calling `steam.getAppDetails({ appid })`. If the API returns no data or `success: false`, the App ID may be invalid, region-locked, or not yet published. This provides a stronger check than static file analysis alone.

0 commit comments

Comments
 (0)