@blazium-games/skills 0.1.17 → 0.1.19

package/README.md

@@ -14,7 +14,7 @@ Cursor: add `blazium-games/games_skill` from **Cursor Settings > Plugins**, then
 
 - Docs: [docs.blazium.games](https://docs.blazium.games) and the map [llms.txt](https://docs.blazium.games/llms.txt)
 - Skills: `npm install @blazium-games/skills`, or Cursor Settings > Plugins > `blazium-games/games_skill`. Index: [SKILL_TREE.md](https://github.com/blazium-games/games_skill/blob/master/SKILL_TREE.md)
-- MCP: [developer server](https://docs.blazium.games/docs/mcp) at `https://mcp.blazium.games/mcp`, and [player server](https://docs.blazium.games/docs/mcp/player) at `https://mcp.blazium.games/player`
+- MCP: [developer server](https://docs.blazium.games/docs/mcp) at `https://mcp.blazium.games/developer` (`/mcp` still reaches it), and [player server](https://docs.blazium.games/docs/mcp/player) at `https://mcp.blazium.games/player`
 - CLI: `npm install -g @blazium-games/cli` (`chauffeur`), guide at [docs.blazium.games/docs/cli](https://docs.blazium.games/docs/cli)
 - Launcher: BlaziumLauncher at `{autopf}\Blazium\Games` on Windows. Shared tools are in `{autopf}\Blazium`. Setup from [Releases](https://github.com/blazium-games/games_launcher/releases), guide at [desktop app](https://docs.blazium.games/docs/storefront/desktop-app)
 - Support: [blazium-games/support](https://github.com/blazium-games/support/issues). Status: [status.blazium.games](https://status.blazium.games)
@@ -36,6 +36,8 @@ A game on Blazium Games does not have to be made with the Blazium engine. The up
 | `blazium-games-keys` | [Access and keys](https://docs.blazium.games/docs/mcp/access-and-keys) |
 | `blazium-games-module` | Blazium engine module login, lobby, and ICE |
 | `blazium-games-plugin` | Godot addon `games_plugin` |
+| `blazium-games-unity` | Unity package `games_unity` |
+| `blazium-games-unreal` | Unreal plugin `games_unreal` |
 | `blazium-games-lobby-pack` | `chauffeur lobby publish` |
 | `blazium-games-player` | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
 | `blazium-games-purchases` | [Agent purchases](https://docs.blazium.games/docs/payments/agent-purchases) |
@@ -46,7 +48,7 @@ A game on Blazium Games does not have to be made with the Blazium engine. The up
 | `blazium-games-player` | Get started, player, purchases |
 | `blazium-games` | Every skill, plus `mcp.json` |
 
-`mcp.json` points at `https://mcp.blazium.games/mcp` and `https://mcp.blazium.games/player`. A token belongs to one server.
+`mcp.json` points at `https://mcp.blazium.games/developer` and `https://mcp.blazium.games/player`. `https://mcp.blazium.games/mcp` still reaches the developer server. A token belongs to one server.
 
 - Claude Code reads `.claude-plugin/marketplace.json`.
 - Cursor reads `.cursor-plugin/marketplace.json`.

package/SKILL_TREE.md

@@ -1,6 +1,6 @@
 # Blazium Games skill tree
 
-Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server: `blazium-games` (developer, `https://mcp.blazium.games/mcp`, keys `bgames_mcp_`) publishes pages, builds, crashes, analytics, and keys. `blazium-games-player` (player, `https://mcp.blazium.games/player`, keys `bgames_play_`) finds, reviews, installs, and buys.
+Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server: `blazium-games` (developer, `https://mcp.blazium.games/developer`, `/mcp` still reaches it, keys `bgames_mcp_`) publishes pages, builds, crashes, analytics, and keys. `blazium-games-player` (player, `https://mcp.blazium.games/player`, keys `bgames_play_`) finds, reviews, installs, and buys.
 
 The guide is [docs.blazium.games](https://docs.blazium.games). This file is the skill index. The docs site remains the source for how the platform works.
 
@@ -30,6 +30,8 @@ New to Blazium Games? Start with [blazium-games-get-started](skills/blazium-game
 | [blazium-games-keys](skills/blazium-games-keys/SKILL.md) | Inspect and rotate MCP and deploy keys | [Access and keys](https://docs.blazium.games/docs/mcp/access-and-keys), [Permissions](https://docs.blazium.games/docs/legal/permissions) |
 | [blazium-games-module](skills/blazium-games-module/SKILL.md) | Blazium engine login, lobby, and ICE | Engine module `games_module` |
 | [blazium-games-plugin](skills/blazium-games-plugin/SKILL.md) | Godot addon for other engines | Public `games_plugin` |
+| [blazium-games-unity](skills/blazium-games-unity/SKILL.md) | Unity package `com.blazium.games` | Public `games_unity` |
+| [blazium-games-unreal](skills/blazium-games-unreal/SKILL.md) | Unreal plugin `BlaziumGames` | Public `games_unreal` |
 | [blazium-games-lobby-pack](skills/blazium-games-lobby-pack/SKILL.md) | Publish a Luau lobby pack | `chauffeur lobby publish` |
 | [blazium-games-player](skills/blazium-games-player/SKILL.md) | Recommendations, catalog search, reviews, bug reports, friends, launcher links, game chat, and chat tokens for IRC clients | [Player MCP](https://docs.blazium.games/docs/mcp/player), [Game chat](https://docs.blazium.games/docs/storefront/chat), [Chat Rules](https://blazium.games/chat-rules) |
 | [blazium-games-purchases](skills/blazium-games-purchases/SKILL.md) | Buy, donate, and top up within a spending limit | [Agent purchases](https://docs.blazium.games/docs/payments/agent-purchases), [Top up](https://docs.blazium.games/docs/payments/top-up), [Buying](https://docs.blazium.games/docs/payments/buying) |

package/package.json

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

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

@@ -1,6 +1,6 @@
 ---
 name: blazium-games-get-started
-description: Connect Cursor to Blazium Games and route to the right skill. Blazium Games is a game publishing platform, with an infrastructure focus. The developer server (mcp.blazium.games/mcp) publishes pages, builds, crashes, analytics, and keys. The player server (mcp.blazium.games/player) finds, reviews, installs, and buys. Use when the user mentions Blazium Games for the first time, asks how to connect, or is unsure whether they want to play or publish.
+description: Connect Cursor to Blazium Games and route to the right skill. Blazium Games is a game publishing platform, with an infrastructure focus. The developer server (mcp.blazium.games/developer) publishes pages, builds, crashes, analytics, and keys. The player server (mcp.blazium.games/player) finds, reviews, installs, and buys. Use when the user mentions Blazium Games for the first time, asks how to connect, or is unsure whether they want to play or publish.
 license: MIT
 ---
 
@@ -8,7 +8,7 @@ license: MIT
 
 Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server:
 
-- Developer server `https://mcp.blazium.games/mcp` (`blazium-games`, keys `bgames_mcp_`): pages, builds, crashes, analytics, and keys. Needs developer mode.
+- Developer server `https://mcp.blazium.games/developer` (`/mcp` still reaches it; `blazium-games`, keys `bgames_mcp_`): pages, builds, crashes, analytics, and keys. Needs developer mode.
 - Player server `https://mcp.blazium.games/player` (`blazium-games-player`, keys `bgames_play_`): find, review, install, and buy. Works for every account.
 
 Never send a player token to the developer server, or a developer token to the player server. Verify the account, then hand off to the skill that matches the user's goal.
@@ -32,7 +32,7 @@ Use these instead of browsing the website. Signed-in pages do not have facts the
 
 ## Prerequisites
 
-- A Blazium Games account (sign up at https://blazium.games/signup)
+- A Blazium Games account. Sign up at https://blazium.games/signup, or call `create_account` on the server you are connected to and `confirm_account` with the email code. The developer server turns developer mode on. The player server leaves the account a player.
 - The `blazium-games` MCP server enabled in Cursor (this plugin ships it in `mcp.json`)
 
 ## 1. Connect
@@ -44,7 +44,7 @@ The plugin registers the server as:
   "mcpServers": {
     "blazium-games": {
       "type": "http",
-      "url": "https://mcp.blazium.games/mcp"
+      "url": "https://mcp.blazium.games/developer"
     }
   }
 }

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

@@ -1,6 +1,6 @@
 # Authentication
 
-The server at `https://mcp.blazium.games/mcp` accepts OAuth 2.1 access tokens or MCP API keys, both sent as `Authorization: Bearer <token>`.
+The server at `https://mcp.blazium.games/developer` accepts OAuth 2.1 access tokens or MCP API keys, both sent as `Authorization: Bearer <token>`. `https://mcp.blazium.games/mcp` still reaches this server.
 
 ## OAuth (recommended)
 
@@ -34,7 +34,7 @@ For headless agents and CI:
   "mcpServers": {
     "blazium-games": {
       "type": "http",
-      "url": "https://mcp.blazium.games/mcp",
+      "url": "https://mcp.blazium.games/developer",
       "headers": { "Authorization": "Bearer bgames_mcp_YOUR_KEY" }
     }
   }

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

@@ -31,6 +31,11 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
 | `request_crash_download` | `uid`, `crash_id`, `kind` (`dump`, `log`, or `stack`; default `dump`) | | Private download URL valid for 1 hour |
 | `get_deploy_info` | `uid` | | Upload, crash, and events URLs, recent builds, env var names, deploy key prefixes. No secrets |
 | `list_game_builds` | `uid` | | Up to 50 builds. Each `build_id` is the `X-Build-Id` for crash reporters |
+| `delete_game_build` | `uid`, `build_id` | write | Deletes one build after the owner approves |
+| `add_game_admin` | `uid`, `invite` | write | Invites an admin. Owner only, and the owner approves |
+| `remove_game_admin` | `uid`, `admin_id` | write | Removes an admin. Owner only |
+| `delete_game` | `uid` | write | Deletes a game the caller owns, after the owner approves |
+| `get_account_analytics` | none | account | Analytics across the account's games |
 | `get_game_build` | `uid`, `build_id` | | One build with its files and crash reporter headers |
 | `list_mcp_keys` | none | account | MCP API key prefixes. Secrets are never returned |
 | `request_mcp_key` | `idempotency_key` | account, write | Issue a new MCP API key and invalidate every previous one. Waits for the human's approval, then returns the secret once |
@@ -51,6 +56,12 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
 | `get_sale_reporter` | `uid` | `mcp:money` | Sale and refund webhooks: enabled, webhook URLs, and that game's signing key. The key is not the review, crash, or bug reporter key |
 | `set_sale_reporter` | `uid`, optional `enabled`, `webhooks`, `refresh_signing_key` | `mcp:money` | Turns sale and refund webhooks on, replaces up to five https URLs, or refreshes the signing key |
 | `get_steam_auth` / `set_steam_auth` | `uid`, and for set: `app_id`, `web_api_key`, `ticket_secret`, `enabled`, `confirm` | `mcp:steam.manage` | Write-only Web API key and ticket secret. Disable deletes both only when `confirm` is true |
+| `unlink_steam` | `uid`, `confirm` | `mcp:steam.manage` | Unlinks Steam. `confirm` only after the human agrees |
+| `rotate_steam_key` | `uid`, `confirm` | `mcp:steam.manage` | Replaces the Web API key. The new key is returned once |
+| `resync_steam` | `uid`, `confirm`, optional `groups`, `web_api_key` | `mcp:steam.manage` | Imports the chosen groups again |
+| `import_steam_game` | `app_id`, `web_api_key`, `confirm`, optional `groups`, `uid` | developer | Imports a Steam page. `confirm` only after the human agrees |
+| `set_anonymous_downloads` | `uid`, `enabled`, `confirm_no_license` | write | Anonymous downloads. Turning them on needs the human's confirm, and a free game |
+| `set_adult_content` | `show`, `confirm_18` | account, write | Adult listings. Turning them on needs the human to confirm they are 18 or older |
 | `list_copyright_notices` | none | | Paid copyright (DMCA) notices about the account's content, with status and how many of its links each names |
 | `get_copyright_notice` | `uid` | | One notice: claimant, work, statements, the account's named links, staff messages, decision, and `reply_to`. Read only; the human replies by email with the reference in the subject |
 | `get_game_chat` | `uid` | | The game's IRC channel (`irc_channel`), whether guests may join (`chat_guests`), and who is banned or muted with when each mute ends |
@@ -109,6 +120,9 @@ Amounts are integer US cents. Agents pay only from the stored balance, and only
 | Tool | Inputs | Access | What it does |
 |------|--------|--------|--------------|
 | `get_account` | none | account | Email verification, timezone, balances, what the account may do (publish, upload, download, buy), and open website sign-in steps (`gate`, `legal_acceptance_required`, `legal_changes`, `setup_required`, `authenticator`) |
+| `create_account` | `email`, `password`, optional `username`, `accept_legal`, `accept_developer_terms` | none | Creates an account. No bearer. On this server, `accept_legal` and `accept_developer_terms` (only after the human agrees) turn developer mode on |
+| `confirm_account` | `email`, `code` | none | Finishes signup with the email code and returns the first `bgames_mcp_` key once. No bearer |
+| `enable_developer_mode` | `accept_terms` | account, write | Turns developer mode on after the human agrees. Turning it off stays on the website |
 | `request_email_code` | none | account, write | Email a verification code to the human |
 | `verify_email` | `code` | account, write | Verify the email with the code the human read from their inbox |
 | `set_timezone` | `timezone` | account, write | Replace the saved timezone with the human's IANA name, when it is empty or the human asks. Do not send the timezone of the machine running the agent. Unknown names: `4085` |

package/skills/blazium-games-player/references/tools.md

@@ -7,6 +7,8 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
 | Tool | Scope | Purpose |
 |------|-------|---------|
 | `get_account` | read | Email verification, timezone, balances, what the account may do, and open website sign-in steps (`gate`, `legal_acceptance_required`, `setup_required`, `authenticator`) |
+| `create_account` | none | Creates an account. No bearer. Send `accept_legal` only after the person agrees. The account stays a player |
+| `confirm_account` | none | Finishes signup with the email code and returns the first `bgames_play_` key once. No bearer |
 | `request_email_code` | write | Email a verification code to the human |
 | `verify_email` | write | Verify the email with the human's code |
 | `set_timezone` | write | Replace the saved timezone with the human's IANA name, when `get_account` timezone is empty or the human asks. Do not use the agent's machine timezone. Unknown names: `4085` |
@@ -44,6 +46,13 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
 | `report_bug` | write | File a bug ticket with the developers (10 per day); `include_dump` / `include_log` return one-time upload URLs |
 | `games_friends_play` | read | What friends are playing now, then what they played in the last 14 days; `live_only` skips the recent list |
 | `list_friends` | read | Friends with presence, plus incoming and sent requests with their `request_uid` |
+| `remove_friend` | write | Removes a friend by username |
+| `get_presence` | read | What you are playing, and whether that is shared |
+| `set_presence_sharing` | write | `share` true shows friends what you are playing |
+| `get_inventory` | read | Items you hold. Page with `cursor` |
+| `list_listings` | read | Your marketplace listings |
+| `create_listing` | write | Lists items for sale: `uid`, `price_cents`, and `item_ids` or `itemdef_id` with `count` |
+| `cancel_listing` | write | Cancels a listing by `listing_id` |
 | `send_friend_request` | write | Send a request by username (20 per day, verified email). Accepts theirs if they already asked |
 | `respond_friend_request` | write | Accept or decline an incoming request |
 | `redeem_key` | write | Redeem a game key or gift link the human gave you; a game they already own leaves the key unused |

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

@@ -1,13 +1,21 @@
 ---
 name: blazium-games-plugin
-description: Godot-based engines other than Blazium use the public games_plugin addon.
+description: Godot addon for Blazium Games login, lobby, ICE, bugs, ownership, progress, and item transfer.
 license: MIT
 ---
 
-# games_plugin
+# Blazium Games plugin
 
-Other Godot engines vendor `addons/blazium_games/`. Auth is the login websocket only. The addon never loads the official DLL. After the JWT arrives, `BlaziumLobby` and `BlaziumIce` use that token. Set project setting `blazium/game/game_uid`.
+Public repo [blazium-games/games_plugin](https://github.com/blazium-games/games_plugin). Install `blazium_games-<version>.zip` from a release, or copy `addons/blazium_games`. Enable the plugin and set the project setting `blazium/game/game_uid` to the project id.
 
-Inside a Discord activity, the addon sends API, login, and lobby traffic through `{applicationId}.discordsays.com`. Unity and Unreal do not.
+The addon talks to Blazium over HTTP. It does not ship or load `blazium_api64.dll` or `libblazium_api.so`.
 
-`transfer_item` can move the signed-in player's items to Steam when that game allows it. `socket_item`, `unsocket_item`, `set_item_stats`, and `use_item` fail locally. Those actions belong to the game owner, an accepted admin, or a mint key on the owner's server, never a player session.
+Sign in on the login websocket, then use that session for the lobby and for ICE. Inside a Discord activity, the addon proxies login, lobby, and API. Unity and Unreal do not.
+
+`server_progress` is the only call that uses `await`. Every other call returns through a signal. `record_standard_events` posts `session_start`, `session_end`, `boot_ok`, `first_input`, `quit`, and `crash` in one request with zero times. It is not a hook for each of those moments.
+
+The in-game bug call sends `X-Build-Id`, the log, and a screenshot. The screenshot path has to be under `user://` and stops at 32 MiB. The service redacts the log before storage. See [Bug reporter](https://docs.blazium.games/docs/bug-reporter).
+
+`transfer_item` is the player call. `socket_item`, `unsocket_item`, `set_item_stats`, and `use_item` fail on a player session. Those need the owner, an accepted admin, or a mint key.
+
+The long guide is [Engines](https://docs.blazium.games/docs/engines).

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

@@ -0,0 +1,19 @@
+---
+name: blazium-games-unity
+description: Unity package com.blazium.games for Blazium Games login, lobby, bugs, progress, and the dedicated server.
+license: MIT
+---
+
+# Blazium Games Unity
+
+Public repo [blazium-games/games_unity](https://github.com/blazium-games/games_unity). Install the release tarball `com.blazium.games-<version>.tgz` with Package Manager (**Add package from tarball**). The package name is `com.blazium.games`.
+
+Put `blazium_api64.dll` from `redistributable-win64.zip`, or `libblazium_api.so` from `redistributable-linux64.zip`, in `Assets/Plugins/x86_64`. Put `game.blaze` beside the built player. Add one `BlaziumTick`. It calls `RunCallbacks` from `Update`. Do not also call `RunCallbacks` every frame.
+
+Do not call `BlaziumApi.Init` and `BlaziumGameServer.Init` in the same process. There is no macOS player library. This package does not proxy a Discord activity. A `templates-*` tag is the engine host, not this library.
+
+The public `ReportBug` method always sends the in-game report. An empty build id and an empty screenshot path omit those parts. The screenshot path check lives in the engine host, not in this package. The service redacts the log before storage.
+
+`record_standard_events` is one batch of launch events with zero times, not a hook for each moment. Item calls are forwarded to the library. The server still rejects `socket_item`, `unsocket_item`, `set_item_stats`, and `use_item` on a player session.
+
+The long guide is [Engines](https://docs.blazium.games/docs/engines).

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

@@ -0,0 +1,19 @@
+---
+name: blazium-games-unreal
+description: Unreal plugin BlaziumGames for Blazium Games login, lobby, bugs, progress, and the dedicated server.
+license: MIT
+---
+
+# Blazium Games Unreal
+
+Public repo [blazium-games/games_unreal](https://github.com/blazium-games/games_unreal). Copy the release zip `BlaziumGames-<version>.zip` into `Plugins/BlaziumGames` and enable Blazium Games. Windows (`Win64`) and Linux are the supported targets.
+
+Put `blazium_api64.dll` from `redistributable-win64.zip`, or `libblazium_api.so` from `redistributable-linux64.zip`, and `game.blaze`, beside the game executable. `UBlaziumSubsystem` is the only callback tick. Do not also call `RunCallbacks` every frame. Blueprint nodes are in the Blazium category.
+
+Do not call client init and dedicated-server init in the same process. There is no macOS player library. This plugin does not proxy a Discord activity. A `templates-*` tag is the engine host, not this library.
+
+`ReportBug` always sends the in-game report. An empty build id and an empty screenshot path omit those parts. The screenshot path check lives in the engine host, not in this plugin. The service redacts the log before storage.
+
+`record_standard_events` is one batch of launch events with zero times, not a hook for each moment. Item calls are forwarded to the library. The server still rejects `socket_item`, `unsocket_item`, `set_item_stats`, and `use_item` on a player session.
+
+The long guide is [Engines](https://docs.blazium.games/docs/engines).