@blazium-games/skills 0.1.4 → 0.1.6

package/README.md

@@ -34,6 +34,9 @@ A game on Blazium Games does not have to be made with the Blazium engine. The up
 | `blazium-games-debug-crash` | [Reading crashes](https://docs.blazium.games/docs/crash-reporting#reading-crashes) |
 | `blazium-games-analytics` | [Download analytics](https://docs.blazium.games/docs/download-analytics) |
 | `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-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) |
 

package/SKILL_TREE.md

@@ -28,7 +28,10 @@ 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-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-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) |
 
 ## Typical paths
@@ -40,6 +43,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.4",
+  "version": "0.1.6",
   "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

@@ -10,7 +10,9 @@ 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 |
+| `get_game_analytics` | `uid` | | Visitor analytics: views, unique visitors, countries, actions, downloads, and browser plays |
+| `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 |
 | `get_crash` | `uid`, `crash_id` | | One crash with metadata, analysis, and stack availability |
 | `request_crash_download` | `uid`, `crash_id`, `kind` (`dump`, `log`, or `stack`; default `dump`) | | Private download URL valid for 1 hour |
@@ -31,6 +33,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-lobby-pack/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: blazium-games-lobby-pack
+description: Publish a Luau lobby pack with chauffeur and check it on the Scripted lobby tab.
+---
+
+# 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.

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

@@ -0,0 +1,8 @@
+---
+name: blazium-games-module
+description: Blazium engine games call the games module for login, scripted lobbies, and ICE.
+---
+
+# Blazium Games module
+
+Blazium games call the engine module. Official DLL auth stays in the launcher pipe. The other auth is the private login websocket at `wss://login.blazium.online/api/v1/connect` (`getid`, `getlogin`, JWT, then the socket closes). Lobby create and join, and ICE fetch, run only after that token exists.

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

@@ -49,6 +49,8 @@ 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` |

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
 

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

@@ -0,0 +1,8 @@
+---
+name: blazium-games-plugin
+description: Godot-based engines other than Blazium use the public games_plugin addon.
+---
+
+# 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`.