Skip to content

Commit d1be3dc

Browse files
TMHSDigitalTMHSDigital
committed
Update version to 0.1.0 of Steam Developer Tools plugin, reflecting the addition of 14 skills and 4 rules. Enhanced documentation in CHANGELOG, README, and ROADMAP to outline features and future plans. Adjusted plugin manifest for versioning consistency.
1 parent 0292bad commit d1be3dc

5 files changed

Lines changed: 238 additions & 24 deletions

File tree

‎.cursor-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "steam-cursor-plugin",
33
"displayName": "Steam Developer Tools",
4-
"version": "0.2.0",
4+
"version": "0.1.0",
55
"description": "Integrates Steam and Steamworks APIs for game developers and power users. 14 skills covering store data, multiplayer networking, cloud saves, leaderboards, input, inventory, social features, profile lookups, and game comparisons - plus 3 rules for App ID validation, secrets detection, and Steam Deck compatibility.",
66
"author": {
77
"name": "TMHSDigital",

‎CHANGELOG.md‎

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,16 @@ 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.2.0] - 2026-03-26
8+
## [0.1.0] - 2026-03-26
99

1010
### Added
1111

12+
- **steam-store-lookup** skill: look up any Steam game by name or App ID, returns store page data (price, reviews, tags, system requirements)
13+
- **steamworks-app-config** skill: generate and document depot configs, build VDF files, launch options, and DLC setup
14+
- **steam-api-reference** skill: search Steam Web API and Steamworks SDK documentation with endpoint signatures and code examples
15+
- **steam-player-stats** skill: query current player counts, achievement stats, leaderboards, and user game libraries
16+
- **steam-workshop-helper** skill: look up Workshop items and document UGC integration patterns for game developers
17+
- **steam-achievement-designer** skill: design achievements, generate VDF/JSON config snippets, and get unlock code for C++, C#, and GDScript
1218
- **steam-multiplayer-networking** skill: lobby creation, matchmaking, Steam Networking Sockets relay, dedicated game servers with C++/C#/GDScript examples
1319
- **steam-cloud-saves** skill: ISteamRemoteStorage manual cloud and Auto-Cloud configuration, conflict resolution, quota management
1420
- **steam-leaderboards** skill: create/find leaderboards, upload scores, download entries (global, friends, around-user), Web API queries
@@ -17,21 +23,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1723
- **steam-inventory-economy** skill: ISteamInventory item schema, drops, crafting, ISteamMicroTxn purchase flow, Steam Item Store, Web API queries
1824
- **steam-profile-lookup** skill: resolve vanity URLs, fetch player summaries, owned games, recent activity, Steam level, badges, friend lists
1925
- **steam-game-comparison** skill: side-by-side comparison of price, reviews, player counts, genres, and platforms for multiple Steam games
20-
- **steam-deck-compat** rule: flags common Steam Deck compatibility issues (hardcoded resolutions, mouse-only input, anti-cheat, Windows-only paths, missing controller support)
21-
22-
## [0.1.0] - 2026-03-26
23-
24-
### Added
25-
26-
- **steam-store-lookup** skill: look up any Steam game by name or App ID, returns store page data (price, reviews, tags, system requirements)
27-
- **steamworks-app-config** skill: generate and document depot configs, build VDF files, launch options, and DLC setup
28-
- **steam-api-reference** skill: search Steam Web API and Steamworks SDK documentation with endpoint signatures and code examples
29-
- **steam-player-stats** skill: query current player counts, achievement stats, leaderboards, and user game libraries
30-
- **steam-workshop-helper** skill: look up Workshop items and document UGC integration patterns for game developers
31-
- **steam-achievement-designer** skill: design achievements, generate VDF/JSON config snippets, and get unlock code for C++, C#, and GDScript
3226
- **steam-appid-validation** rule: validates App ID consistency across project files and warns if steam_appid.txt is missing
3327
- **steamworks-secrets** rule: prevents committing API keys, partner credentials, and auth tokens
28+
- **steam-deck-compat** rule: flags common Steam Deck compatibility issues (hardcoded resolutions, mouse-only input, anti-cheat, Windows-only paths, missing controller support)
3429
- Plugin manifest, README, CONTRIBUTING guide, and license
3530

36-
[0.2.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.2.0
3731
[0.1.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.1.0

‎CLAUDE.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +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.2.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, and comparing games.
7+
**Steam Developer Tools** is a Cursor IDE plugin (v0.1.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, and comparing games.
88

9-
This is a **static, documentation-only plugin** - no build system, no npm, no compiled code. All plugin logic is expressed in Markdown skill files and MDC rule files.
9+
This is currently a **static, documentation-only plugin** - no build system, no npm, no compiled code. All plugin logic is expressed in Markdown skill files and MDC rule files.
10+
11+
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.2.0 "Live Data") introduces a Steam MCP server with read-only API tools. Subsequent releases add analytics/market research skills (v0.3.0), CI/CD automation (v0.4.0), community/monetization skills (v0.5.0), QA rules (v0.6.0), MCP write operations (v0.7.0), and polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
1012

1113
## Plugin Architecture
1214

‎README.md‎

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010

1111
<p align="center">
1212
<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>
13-
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.2.0-green.svg" alt="Version"></a>
13+
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.1.0-green.svg" alt="Version"></a>
1414
<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>
1515
<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>
1616
<a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin"><img src="https://img.shields.io/badge/Cursor-Plugin-8B5CF6.svg" alt="Cursor Plugin"></a>
@@ -302,12 +302,18 @@ These work immediately without any API key:
302302

303303
## Roadmap
304304

305-
- [ ] Steam MCP server for live, structured API calls
306-
- [x] ~~Steam Deck compatibility checker~~ - added in v0.2.0 as a rule
307-
- [x] ~~Steamworks SDK code generation~~ - covered by multiplayer, cloud, leaderboard, input, and inventory skills
308-
- [ ] Steam review sentiment analysis skill
309-
- [ ] Steam sale / price history tracking
310-
- [ ] SteamVR integration skill
305+
See [ROADMAP.md](ROADMAP.md) for the full themed release plan (v0.2.0 through v1.0.0).
306+
307+
| Version | Theme | Highlights |
308+
|---------|-------|------------|
309+
| **v0.2.0** | Live Data | Steam MCP server with 10 read-only tools, skill updates |
310+
| **v0.3.0** | Insights | Review analysis, price history, market research, wishlist estimates |
311+
| **v0.4.0** | Ship It | CI/CD automation, release checklist, steamcmd helper, build validation rules |
312+
| **v0.5.0** | Grow | Community management, store page optimization, pricing strategy, DLC planning |
313+
| **v0.6.0** | Quality | Playtest setup, anti-cheat integration, save compat / network security / error handling rules |
314+
| **v0.7.0** | Full Power | MCP write operations (lobbies, workshop uploads, achievements, inventory) |
315+
| **v0.8.0** | Polish | Cross-references, troubleshooting sections, migration guide |
316+
| **v1.0.0** | Stable | Production release: 30 skills, 9 rules, 20 MCP tools |
311317

312318
## Contributing
313319

‎ROADMAP.md‎

Lines changed: 212 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,212 @@
1+
# Roadmap
2+
3+
Themed release plan from v0.2.0 through v1.0.0.
4+
5+
**Current:** v0.1.0 - 14 skills, 3 rules, documentation-only plugin.
6+
7+
**Target:** v1.0.0 - 30 skills, 9 rules, 20 MCP tools.
8+
9+
| Version | Theme | New Skills | New Rules | MCP Tools | Total Skills | Total Rules |
10+
|---------|-------|-----------|-----------|-----------|-------------|-------------|
11+
| v0.1.0 (current) | - | - | - | 0 | 14 | 3 |
12+
| v0.2.0 | Live Data | 0 (updates) | 1 | 10 | 14 | 4 |
13+
| v0.3.0 | Insights | 4 | 0 | 2 | 18 | 4 |
14+
| v0.4.0 | Ship It | 3 | 2 | 0 | 21 | 6 |
15+
| v0.5.0 | Grow | 4 | 0 | 2 | 25 | 6 |
16+
| v0.6.0 | Quality | 3 | 3 | 0 | 28 | 9 |
17+
| v0.7.0 | Full Power | 1 | 0 | 6 | 29 | 9 |
18+
| v0.8.0 | Polish | 1 | 0 | 0 | 30 | 9 |
19+
| v1.0.0 | Stable | 0 | 0 | 0 | 30 | 9 |
20+
21+
---
22+
23+
## v0.2.0 - "Live Data" (MCP Server Foundation)
24+
25+
**Theme:** Replace static guidance with live, structured API calls.
26+
27+
### MCP Server
28+
29+
Steam MCP server exposing read-only tools:
30+
31+
| Tool | Description |
32+
|------|-------------|
33+
| `steam.getAppDetails({ appid })` | Store data (price, reviews, tags, platforms) |
34+
| `steam.searchApps({ query })` | App search by name |
35+
| `steam.getPlayerCount({ appid })` | Current concurrent players |
36+
| `steam.getAchievementStats({ appid })` | Global achievement unlock percentages |
37+
| `steam.getPlayerSummary({ steamid })` | Profile data (name, avatar, status) |
38+
| `steam.getOwnedGames({ steamid })` | Game library with playtime |
39+
| `steam.getWorkshopItem({ fileid })` | Workshop item details |
40+
| `steam.queryWorkshop({ appid, query_type, count })` | Workshop search/browse |
41+
| `steam.getLeaderboardEntries({ appid, id, range })` | Leaderboard data |
42+
| `steam.resolveVanityURL({ vanity })` | Vanity URL to 64-bit Steam ID |
43+
44+
### Skill Updates
45+
46+
Update all 14 existing skills to reference MCP tools where applicable. Replace "MCP Integration (Future)" placeholder sections with concrete "MCP Usage" sections.
47+
48+
### New Rule
49+
50+
- `steam-api-key-usage.mdc` - when MCP tools are available, guide users to prefer MCP calls over raw curl commands
51+
52+
---
53+
54+
## v0.3.0 - "Insights" (Analytics and Market Research)
55+
56+
**Theme:** Data-driven decision-making for game developers and analysts.
57+
58+
### New Skills
59+
60+
| Skill | Description |
61+
|-------|-------------|
62+
| `steam-review-analysis` | Fetch and analyze game reviews: sentiment breakdown, common complaints, comparison across updates, language distribution |
63+
| `steam-price-history` | Pricing trends, sale history, regional pricing analysis, price-to-review value scoring |
64+
| `steam-market-research` | Genre trend analysis, tag popularity, competitor identification, market gap analysis using store data |
65+
| `steam-wishlist-estimates` | Estimate wishlists from follower counts and public signals, conversion rate benchmarks |
66+
67+
### New MCP Tools
68+
69+
| Tool | Description |
70+
|------|-------------|
71+
| `steam.getReviews({ appid, filter, language, count })` | Fetch user reviews |
72+
| `steam.getPriceOverview({ appids, cc })` | Batch price check across regions |
73+
74+
---
75+
76+
## v0.4.0 - "Ship It" (CI/CD and Build Pipeline)
77+
78+
**Theme:** Automate the Steam build and release process.
79+
80+
### New Skills
81+
82+
| Skill | Description |
83+
|-------|-------------|
84+
| `steam-build-automation` | SteamPipe CI/CD integration (GitHub Actions, GitLab CI, Jenkins), automated depot uploads, branch management (beta/default) |
85+
| `steam-release-checklist` | Pre-release validation: store page completeness, depot config, achievements uploaded, cloud save tested, Deck compat reviewed |
86+
| `steam-steamcmd-helper` | steamcmd scripting reference, common commands, batch scripts, Docker containerized builds |
87+
88+
### New Rules
89+
90+
| Rule | Description |
91+
|------|-------------|
92+
| `steam-build-config-validation.mdc` | Validate VDF build configs: missing depots, mismatched app IDs, invalid file mappings |
93+
| `steam-launch-options-check.mdc` | Flag launch option issues: missing executables, wrong OS targeting, missing descriptions for multi-launch |
94+
95+
---
96+
97+
## v0.5.0 - "Grow" (Community and Monetization)
98+
99+
**Theme:** Post-launch growth, community management, and revenue.
100+
101+
### New Skills
102+
103+
| Skill | Description |
104+
|-------|-------------|
105+
| `steam-community-management` | Announcements, event creation, discussion forum moderation patterns, update post templates |
106+
| `steam-store-page-optimizer` | Store page best practices: capsule image specs, description structure, tag strategy, trailer guidance, demo setup |
107+
| `steam-pricing-strategy` | Regional pricing recommendations, launch discount planning, sale participation, bundle strategy, free-to-play conversion |
108+
| `steam-dlc-expansion-planning` | DLC roadmap templates, season pass structure, content cadence planning, pricing tiers |
109+
110+
### New MCP Tools
111+
112+
| Tool | Description |
113+
|------|-------------|
114+
| `steam.getAppReviewSummary({ appid })` | Review histogram and summary |
115+
| `steam.getRegionalPricing({ appid, countries })` | Pricing by region |
116+
117+
---
118+
119+
## v0.6.0 - "Quality" (Testing, QA, and Rules)
120+
121+
**Theme:** Catch issues before players do.
122+
123+
### New Skills
124+
125+
| Skill | Description |
126+
|-------|-------------|
127+
| `steam-playtest-setup` | Steam Playtest feature configuration, feedback collection, NDA playtest vs open playtest, key distribution |
128+
| `steam-bug-report-template` | Structured bug report templates with Steam system info integration, crash dump guidance |
129+
| `steam-anticheat-integration` | EAC and BattlEye setup, Proton/Linux compatibility, VAC integration, custom anti-cheat considerations |
130+
131+
### New Rules
132+
133+
| Rule | Description |
134+
|------|-------------|
135+
| `steam-save-compat.mdc` | Flag save file practices that break cross-platform cloud sync: binary endianness, OS-specific paths, hardcoded separators |
136+
| `steam-network-security.mdc` | Flag insecure networking patterns: unvalidated auth tickets, missing encryption, trusting client data |
137+
| `steam-api-error-handling.mdc` | Flag missing error/callback handling for Steamworks SDK calls: unchecked results, missing `StoreStats()`, ignored callbacks |
138+
139+
---
140+
141+
## v0.7.0 - "Full Power" (Advanced MCP - Write Operations)
142+
143+
**Theme:** Expand MCP server with write/mutation capabilities.
144+
145+
### New MCP Tools (Write Operations)
146+
147+
| Tool | Description |
148+
|------|-------------|
149+
| `steam.createLobby({ type, maxPlayers, metadata })` | Create multiplayer lobbies |
150+
| `steam.uploadWorkshopItem({ appid, title, content_path })` | Upload new Workshop items |
151+
| `steam.updateWorkshopItem({ fileid, changes })` | Update existing Workshop items |
152+
| `steam.setAchievement({ steamid, achievement })` | Unlock achievements (dev/test) |
153+
| `steam.uploadLeaderboardScore({ appid, leaderboard, score })` | Upload leaderboard scores |
154+
| `steam.grantInventoryItem({ steamid, itemdef })` | Grant inventory items (dev/test) |
155+
156+
### New Skill
157+
158+
| Skill | Description |
159+
|-------|-------------|
160+
| `steam-testing-sandbox` | Guide for using App ID 480 (SpaceWar) as a development sandbox, test account setup, Steam client developer console commands |
161+
162+
### Rule Updates
163+
164+
- Update `steam-appid-validation.mdc` to integrate with MCP for live validation (check if App ID exists via API)
165+
166+
---
167+
168+
## v0.8.0 - "Polish" (Refinement and Gaps)
169+
170+
**Theme:** Fill gaps, improve consistency, harden everything.
171+
172+
### Improvements
173+
174+
- Audit and improve all skill workflows for clarity and completeness
175+
- Add troubleshooting/error reference sections to every skill
176+
- Add cross-references between related skills (e.g., multiplayer links to friends/social, leaderboards links to player stats)
177+
- Ensure every MCP tool has proper error handling documented
178+
- Add "Common Pitfalls" sections to skills that deal with tricky APIs
179+
180+
### New Skill
181+
182+
| Skill | Description |
183+
|-------|-------------|
184+
| `steam-migration-guide` | Migrating from other platforms (Epic, GOG, itch.io) to Steam, or porting between engines with Steamworks |
185+
186+
### Documentation
187+
188+
- Comprehensive MCP server README with setup instructions
189+
- API rate limiting and best practices guide
190+
- Full skill/rule cross-reference matrix
191+
192+
---
193+
194+
## v1.0.0 - "Stable" (Production Release)
195+
196+
**Theme:** Stable, complete, production-ready plugin.
197+
198+
### Release Checklist
199+
200+
- [ ] All 30 skills reviewed and tested
201+
- [ ] All 20 MCP tools documented and stable
202+
- [ ] All 9 rules validated against real projects
203+
- [ ] CHANGELOG fully up to date
204+
- [ ] README reflects final feature set
205+
- [ ] Version locked at 1.0.0, semver from here on out
206+
207+
---
208+
209+
## Completed
210+
211+
- [x] ~~Steam Deck compatibility checker~~ - added in v0.1.0 as a rule
212+
- [x] ~~Steamworks SDK code generation~~ - covered by multiplayer, cloud, leaderboard, input, and inventory skills

0 commit comments

Comments
 (0)