@blazium-games/skills 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium-games/skills",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Agent skills for the Blazium Games platform.",
   "repository": "https://github.com/blazium-games/games_skill",
   "license": "MIT",

package/skills/blazium-games-analytics/SKILL.md

@@ -21,7 +21,7 @@ Summarize store page traffic for one game.
 ## 1. Fetch
 
 1. Resolve the game with `list_games` if the user did not give a `uid`.
-2. Call `get_game_analytics` with `uid` (or read `blazium-games://games/{uid}/analytics`).
+2. Call `get_game_analytics` with `uid` and, when the user names a build, `build` (or read `blazium-games://games/{uid}/analytics`).
 
 ## 2. Interpret
 
@@ -37,6 +37,7 @@ Summarize store page traffic for one game.
 | `downloads.by_source[]` | `website`, `asset_library` (Godot or Blazium editor), `api`, `mcp_player`, `mcp_dev` |
 | `downloads.by_access[]` | `anonymous`, `owner`, `free`, `purchase`, `grant`, `key`, `bundle` |
 | `downloads.by_outcome[]` | Every attempt, including refusals such as `sign_in_required` and `payment_required` |
+| `events[]` | Registered funnel events: `name`, `count`, `unique_devices`, and `daily`. This is not visitor or download analytics |
 
 Analytics are aggregate. Individual visitors are not identifiable through the MCP.
 

package/skills/blazium-games-crash-reporting/SKILL.md

@@ -98,16 +98,7 @@ Ask before adding them if the game has no privacy policy or the user needs playe
 
 ## 4. Custom events (optional)
 
-```http
-POST https://api.blazium.online/api/v1/public/events
-X-App-Id: <game uid>
-X-Build-Id: <build_id>
-Content-Type: application/json
-
-{ "events": [ { "event": "level_complete", "anonymous": true, "device_uid": "<random per install>" } ] }
-```
-
-Up to 100 events per request (more returns `4130`); the response is `202`. Use a random per-install id, not hardware identifiers.
+Register the name first with `set_funnels`. Then record it from the signed-in client, a game server key, or a scripted lobby. Unknown names are refused. See https://docs.blazium.games/docs/progress. The six standard events stay on the public route above.
 
 ## 5. Symbols
 

package/skills/blazium-games-get-started/SKILL.md

@@ -84,6 +84,7 @@ If OAuth is not possible (headless CI, remote agents), use an API key instead. S
 | Add crash reporting to a game | `blazium-games-crash-reporting` |
 | Investigate a crash | `blazium-games-debug-crash` |
 | Read visitor analytics | `blazium-games-analytics` |
+| Set achievements, stats, funnels, or presence writers | `get_achievements`, `set_achievements`, `get_stats`, `set_stats`, `get_funnels`, `set_funnels`, `get_presence_writers`, `set_presence_writers` ([tools](./references/tools.md)) |
 | Rotate MCP or deploy keys | `blazium-games-keys` |
 | Moderate a game's chat channel (guests, bans, mutes) | `get_game_chat`, then `set_chat_guests`, `ban_chat_user`, or `suspend_chat_user` only when the human asks ([tools](./references/tools.md)) |
 | Find, review, or play games as a player, or get a chat token | `blazium-games-player` |

package/skills/blazium-games-get-started/references/tools.md

@@ -10,7 +10,18 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
 | `get_game` | `uid` | | One game's settings and store page fields |
 | `create_game` | `name` (required), `tagline`, `description`, `visibility`, `asset_type`, `vanity_name`, `adult`, `indexable`, `parent` | account, write | Create a store page. Tools, mods and plugins need a `parent` before they can go public. Needs developer mode on the account (`4105`) |
 | `update_game` | `uid` (required), `name`, `tagline`, `description`, `visibility`, `asset_type`, `adult`, `indexable`, `parent` | write | Update a store page; only passed fields change. An empty `parent` object clears it |
-| `get_game_analytics` | `uid` | | Visitor analytics: views, unique visitors, countries, actions, downloads, and browser plays |
+| `get_game_analytics` | `uid`, optional `build` | | Visitor analytics plus registered funnel events: count, unique devices, and a daily series |
+| `get_achievements` | `uid` | | Achievement definitions and writers |
+| `set_achievements` | `uid`, `achievements` | mcp:catalog.write | Replaces the achievement list |
+| `get_stats` | `uid` | | Integer stats, op, and writers |
+| `set_stats` | `uid`, `stats` | mcp:catalog.write | Replaces the stat list |
+| `get_funnels` | `uid` | | Registered analytics events and writers |
+| `set_funnels` | `uid`, `funnels` | mcp:catalog.write | Replaces the funnel list |
+| `get_presence_writers` | `uid` | | Who may set the short presence status |
+| `set_presence_writers` | `uid`, `writers` | mcp:catalog.write | Replaces that list |
+| `list_server_keys` | `uid` | | Game server key prefixes and roles. No secrets |
+| `request_server_key` | `uid`, `role` | | Returns a game_server or private_server secret once |
+| `revoke_server_key` | `uid`, `key_id` | | Revokes one game server key |
 | `get_web_player` | `uid` | | Browser player settings |
 | `set_web_player` | `uid` | `enabled`, `full_build_id`, `demo_build_id` | Choose the full build and an optional demo. Needs mcp:build.write |
 | `list_game_crashes` | `uid` | | Recent crash reports |

package/skills/blazium-games-lobby-pack/SKILL.md

@@ -6,3 +6,10 @@ description: Publish a Luau lobby pack with chauffeur and check it on the Script
 # Lobby packs
 
 `chauffeur lobby publish --dir <path>` packs `.lua` files, refuses any other script, and uploads through the uploader. `chauffeur lobby list` and `chauffeur lobby status` show the stored packs and the checksum the next lobby loads. The game editor Scripted lobby tab shows the same history. The page does not upload the pack.
+
+A seated pack can call these on `lobby`. The host performs them. The pack never sees the host token.
+
+- `unlock_achievement(user, slug)` and `set_stat(user, slug, value)` write progress when that definition lists `scripted_lobby`.
+- `record_event(user, name, fields)` stores one registered funnel event. Slug, event, and status strings that are too long are refused before the call. `fields` is at most 4 KiB.
+- `analytics(name)` reads count, unique devices, and the daily totals for one event that lists `scripted_lobby`. An optional build filter uses the same shape. It does not return visitor or download numbers.
+- `set_presence(user, status)` only notifies that player's lobby connection. The host signs the notice. The launcher applies it.