update_game
Needs sign-in (connect this server with OAuth, or pass an API key as the Authorization: Bearer header). Ships a new build of a game the creator already published, as its next version: same link, same origin, scores and comments kept. Needs the creator's API key. Stage with upload-build.mjs --from <this game's slug> so only changed files are sent. Stage a local build folder with Node 22+: download https://yougame.co/upload-build.mjs, then run node upload-build.mjs with YOUGAME_URL=https://yougame.co and YOUGAME_UPLOAD_TOKEN (from upload_token) or YOUGAME_API_KEY set. It applies the website's path fixes locally and streams files through POST /api/upload/start, PUT /api/upload/file (a file over 100 MB goes up in 64 MB parts through /api/upload/file/parts), and POST /api/upload/complete. The same limits as the website apply: up to 5 GB per build, 512 MB per file, 5,000 files. Pass the build folder or the build's .zip: the helper unpacks a zip on your machine and sends its files the same way. The result includes uploadId, testUrl and the static check report; fix a broken verdict and upload again. When you change a build you already uploaded, add --from <your game's slug or your last uploadId>: files this helper sent before and that haven't changed are copied instead of sent again, so a small change is quick even on a big game. A ROM mod (kind "patch") is its one patch file (.ips, .ups, .bps or .xdelta) and no index.html: pass the file itself to the helper and it is staged as a package with no page to check; a cosmetic's folder is staged with --package (by hand, POST /api/upload/start with package: true beside files). On an "Ideas and test builds only" connection (scope build) the helper works with upload_token's token and stages a private test build; upload_token's reply there gives the steps. Then call this tool (or POST the same fields to https://yougame.co/api/agent/update) with the game's slug (from my_games or its URL), the new uploadId, the kind of update, and patch notes. kind "major" (2.0) is for a big change: everyone who saved or liked the game is notified with the notes, and the home feed features the game for a week. kind "minor" (1.1) is for fixes and small changes: listed in the version history, nobody is pinged. Default to minor unless the creator says the update is big. Optional platform switches the listing between web and desktop_app; native-only games upload their build from Manage → Desktop builds.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"slug": "<slug>",
"uploadId": "<uploadId>"
},
"name": "update_game"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | major (big change, players are notified) or minor (fixes, silent). Default minor. | |
| slug | Yes | The game's slug: the last part of its URL, https://yougame.co/g/<slug>. | |
| notes | No | Patch notes, up to 2000 characters: what changed, for players. Shown on the game page and, for a major update, in the notification. | |
| video | No | Optional: a new preview video, as an MP4/WebM path inside the new build (under 100 MB). Omit to keep the current one. | |
| licence | No | Creator-owned listing licence: all-rights-reserved, MIT, Apache-2.0, CC-BY-4.0 (art and sound), or custom. Omit or use null for not stated. Custom needs an https link in licence_url. Community open-source listings keep YouGame's AGPL licence. Unreal Engine games can't use GPL-family or CC BY-SA licences. | |
| platform | No | Omit to keep the current setting. web: plays in the browser. desktop_app: native build only; upload from Manage → Desktop builds. Forces mobile false. Never ship a web page telling players to download the app. | |
| uploadId | Yes | The new build, from the upload reply (32 hex characters). | |
| upstream | No | For a remix whose build was merged by hand after sync_remix reported conflicts: the original's build id the merge took (origin.upload_id in that reply), recorded as the remix's new base. | |
| base_game | No | Optional replacement rom_patch for this release, including variants. Uses the listing's stored accepted dumps; edit other base-game metadata separately. | |
| thumbnail | No | Optional: a new thumbnail, as a path inside the new build (16:9 PNG/JPG/WebP/GIF under 8 MB). Omit to keep the current one. | |
| licence_url | No | An https link to the creator's licence text; required for custom, optional for other licences. No whitespace or control characters. Omit to keep it on updates; null clears it. | |
| screenshots | No | Optional: new screenshots, as paths inside the new build. Omit to keep the current ones. | |
| match_replays | No | Enable or disable browser match replays; omit to follow yougame.json or retain the listing setting. | |
| whole_game_lobby | No | true when online play is a single lobby that starts the whole game together; false when players pick among several lobby or mode types inside the game (no Play together button on its page). Omit if unsure; null clears the setting. |