@blazium-games/skills 0.1.3 → 0.1.5

package/README.md

@@ -16,7 +16,7 @@ Cursor: add `blazium-games/games_skill` from **Cursor Settings > Plugins**, then
 - 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`
 - CLI: `npm install -g @blazium-games/cli` (`chauffeur`), guide at [docs.blazium.games/docs/cli](https://docs.blazium.games/docs/cli)
-- Launcher: Windows setup from [Releases](https://github.com/blazium-games/games_launcher/releases), guide at [desktop app](https://docs.blazium.games/docs/storefront/desktop-app)
+- 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)
 
 ## This repo

package/SKILL_TREE.md

@@ -28,7 +28,7 @@ New to Blazium Games? Start with [blazium-games-get-started](skills/blazium-game
 | [blazium-games-debug-crash](skills/blazium-games-debug-crash/SKILL.md) | Triage crashes and map them to code | [Reading crashes](https://docs.blazium.games/docs/crash-reporting#reading-crashes) |
 | [blazium-games-analytics](skills/blazium-games-analytics/SKILL.md) | Summarize page traffic and downloads | [Download analytics](https://docs.blazium.games/docs/download-analytics), [MCP reference](https://docs.blazium.games/docs/mcp/reference) |
 | [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-player](skills/blazium-games-player/SKILL.md) | Recommendations, catalog search, reviews, bug reports, friends, launcher links, and game chat | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
+| [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) |
 
 ## Typical paths
@@ -40,6 +40,8 @@ New to Blazium Games? Start with [blazium-games-get-started](skills/blazium-game
 - **Players report crashes:** debug-crash
 - **Find something to play:** player
 - **Leaked key:** keys
+- **Use chat in an IRC client, or a chat token leaked:** player
+- **Moderate a game's chat:** get-started (chat tools)
 
 ## More of the guide
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium-games/skills",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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

@@ -85,7 +85,8 @@ If OAuth is not possible (headless CI, remote agents), use an API key instead. S
 | Investigate a crash | `blazium-games-debug-crash` |
 | Read visitor analytics | `blazium-games-analytics` |
 | Rotate MCP or deploy keys | `blazium-games-keys` |
-| Find, review, or play games as a player | `blazium-games-player` |
+| 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` |
 | Buy a game or donate | `blazium-games-purchases` |
 
 ## References

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

@@ -31,6 +31,12 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
 | `update_bug_ticket` | `uid`, `bug_uid`, `status` (`open`, `fixed`, `closed`) | write | Mark a ticket fixed or closed, or reopen it; covered by `mcp:crash.read` |
 | `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 |
+| `set_chat_guests` | `uid`, `guests` | write | Let people without a license join the channel; they can read but can't talk until they own the game |
+| `ban_chat_user` | `uid`, `username` | write | Ban a user from the channel until unbanned; they are removed right away. The owner, admins, and `blazium` can't be banned. Only when the human asked |
+| `unban_chat_user` | `uid`, `username` | write | Lift a chat ban |
+| `suspend_chat_user` | `uid`, `username`, `minutes` (1-43200) | write | Mute a user for up to 30 days; they can still read. Only when the human asked |
+| `unsuspend_chat_user` | `uid`, `username` | write | Lift a chat mute |
 | `declare_dependency` | `uid`, `target_uid`, `kind`, `remove` | write | Link to another public listing: `uses`, `supports`, or `made_with` |
 | `list_dependents` | `uid` | | What a listing uses and which listings use it, plus license kind and compatibility |
 | `declare_engine_compat` | `uid`, `compat` | write | Replace the engine version ranges (engine, min/max version, renderer, platform) |

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

@@ -49,10 +49,12 @@ The player server acts for one player. It sees the account, wallet, and library,
 | Report a bug | `report_bug` with what happened and how to reproduce it. If they have a crash dump or log, set `include_dump` / `include_log` and upload the file with `PUT` to the returned URL |
 | "What are my friends playing?" | `games_friends_play`; live games come first, then the last 14 days |
 | Add or answer a friend | `send_friend_request` with the username they gave you, or `list_friends` then `respond_friend_request`. Only send requests the human asked for |
+| Use game chat in their own IRC client | `get_chat_token_status` for the client settings. Only if they ask for a token, `request_chat_token` with `confirm: true` and give it to them straight away; it can't be shown again, and replacing it disconnects clients using the old one. Username is their Blazium Games username, password is the token, SASL PLAIN on `irc.blazium.online:6697` with TLS, then `/quote GAMEJOIN <game uid>`. Chat follows https://blazium.games/chat-rules |
+| Revoke a leaked chat token | `revoke_chat_token` with `confirm: true` when they ask |
 | Redeem a key or gift link | `redeem_key` with the code or link they gave you. `4084` means they already own it and the key is still unused |
 | Install a game they own or a free game | `why_should_i_trust_this` first. Pass its facts on, and do not call a file safe. Then `install_build` and give them the `blazium://install/<uid>` link. If it fails because the scan isn't clean, don't offer another way to download that file |
 | Join or leave a beta | `set_channel` (`beta` or `stable`), then `install_build` |
-| Play a game | `launch_game`, then give them the `blazium://game/<uid>` link. The desktop launcher you can download today is Windows and listens on port 39220. Hand over the link; do not fetch the installer unless they ask. `blazium://buy/<uid>` opens the store page and does not install. Game chat is IRC on `irc.blazium.online` port 6697 |
+| Play a game | `launch_game`, then give them the `blazium://game/<uid>` link. BlaziumLauncher is the Windows program and listens on port 39220. It installs under the shared Blazium folder. Hand over the link; do not fetch the installer unless they ask. `blazium://buy/<uid>` opens the store page and does not install. Game chat is IRC on `irc.blazium.online` port 6697 |
 | Download a game they own or a free game | Step 5 (Download) of [purchases](../blazium-games-purchases/SKILL.md) |
 
 ## Errors

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

@@ -47,6 +47,10 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
 | `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 |
+| `get_chat_connection` | write | Sign in to game chat yourself: host, TLS port 6697, the browser websocket, and a SASL PLAIN token that works for 10 minutes. Then `GAMEJOIN <game uid>`. Chat follows https://blazium.games/chat-rules |
+| `get_chat_token_status` | read | Whether the human has a chat token for IRC clients (prefix and times, never the token), whether the account is locked out of chat, and the client settings |
+| `request_chat_token` | write | Only when the human asks, with `confirm: true`: creates or replaces their IRC client chat token. It comes back once; hand it straight to the human. Replacing it disconnects clients using the old one. Up to 10 changes an hour (`4290`) |
+| `revoke_chat_token` | write | Only when the human asks, with `confirm: true`: revokes the chat token and disconnects clients using it |
 
 ## Resources
 
@@ -61,7 +65,7 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
 | `ui://blazium-games/wallet.html` | Balance, ledger, spending limit, and a card top-up link |
 | `ui://blazium-games/approval.html` | Approval status, confirm link, and the emailed code |
 | `ui://blazium-games/library.html` | Owned games, redeem, and download links |
-| `ui://blazium-games/handoff.html` | `blazium://` hand-off for the Windows launcher |
+| `ui://blazium-games/handoff.html` | `blazium://` hand-off for BlaziumLauncher |
 | `ui://blazium-games/account.html` | Verification, timezone, and links to finish sign-in on the website |
 | `ui://blazium-games/feedback.html` | Reviews, bug reports, taste, and tag suggestions. Send only what the human wrote |
 | `ui://blazium-games/friends.html` | Friends and requests. Send and answer only from a click |