@xgamesfun/xcore 0.2.0 → 0.2.1

package/README.md

@@ -523,24 +523,28 @@ games. `GAMESFUN_STUDIO=<origin>` publishes to another xgames.fun (a Studio on y
 
 ### Its plan: `xcore plan`
 
-Hosting the page is free. What the game's server, saves and scores may use is the game's plan:
-
-|                      | Free                                                               | Creator                                                   | Scale                   |
-| -------------------- | ------------------------------------------------------------------ | --------------------------------------------------------- | ----------------------- |
-| For                  | every game, by default                                             | a game in one of your paid game slots (per game, a month) | granted by xgames.fun   |
-| Server               | 50 ms of CPU a request; 600 requests a minute, 120 from one player | 200 ms; 6,000 a minute, 600 from one player               | 1,000 ms; 30,000, 1,200 |
-| Saves and scores     | 10 MB of saves; 8 boards of 10,000 entries                         | 1 GB; 16 boards of 1,000,000                              | 10 GB; 16 of 1,000,000  |
-| Use included a month | $1                                                                 | $10 a slot, shared by your Creator games                  | as granted              |
-| Sites that embed it  | 3 (`xcore embed`)                                                  | 10                                                        | 25                      |
-| Domains of your own  | none                                                               | 1 (`xcore domain`)                                        | 5                       |
+Every game sits in a **slot**. Everyone gets **2 free slots**, whose games run on Free; any more games need a **paid
+slot** ($15 for 30 days), whose game runs on Creator. A new game is refused while both free slots are taken: archive one
+you no longer need (on your console, xgames.fun/console; unpublish it first) or move one to a paid slot. Archived games
+free their slot unless their link is still live. What the game's server, saves and scores may use is its plan:
+
+|                      | Free                                                               | Creator                                              | Scale                   |
+| -------------------- | ------------------------------------------------------------------ | ---------------------------------------------------- | ----------------------- |
+| For                  | a game in one of your 2 free slots                                 | a game in one of your paid slots (per game, a month) | granted by xgames.fun   |
+| Server               | 50 ms of CPU a request; 600 requests a minute, 120 from one player | 200 ms; 6,000 a minute, 600 from one player          | 1,000 ms; 30,000, 1,200 |
+| Saves and scores     | 10 MB of saves; 8 boards of 10,000 entries                         | 1 GB; 16 boards of 1,000,000                         | 10 GB; 16 of 1,000,000  |
+| Use included a month | $1                                                                 | $10 a slot, shared by your Creator games             | as granted              |
+| Sites that embed it  | 3 (`xcore embed`)                                                  | 10                                                   | 25                      |
+| Domains of your own  | none                                                               | 1 (`xcore domain`)                                   | 5                       |
 
 Past what is included, a game is **capped** until the month ends: its server answers at most 60 requests a minute (20
-from one player) and saves and scores slow down, but nothing is lost and the game keeps working. Slots are $15 for 30
-days, prepaid in SOL or USDC in xgames.fun Studio (Plans; no automatic renewal, 7 days' grace after the period ends).
+from one player) and saves and scores slow down, but nothing is lost and the game keeps working. Paid slots are $15 for
+30 days, prepaid in SOL or USDC on xgames.fun (your console → Plans; no automatic renewal, 7 days' grace after the period
+ends; when they end, their games go back to free slots and nothing is taken down).
 Usage credit, bought the same way, lets Creator games go past what their slots include, at twice what xgames.fun pays,
-instead of slowing down. A slot moves between your games at any time
+instead of slowing down. A paid slot moves between your games at any time
 (`xcore plan deactivate <one>`, `xcore plan activate <another>`) without changing the bill. `xcore plan [folder]`
-shows a game's plan, its limits and this month's use; `--all` your slots and every game. A game's server sees a 429
+shows a game's plan, its limits and this month's use; `--all` your free and paid slots and every game. A game's server sees a 429
 with `scope` (`"player"` or `"game"`) and `plan` when it goes past a rate.
 
 ### Your own site and your own domain: `xcore embed`, `xcore domain`

package/commands/plan.mjs

@@ -12,17 +12,18 @@ const usage = `Usage: xcore plan [dir] [--json]
 What a game's backend may use on xgames.fun (its server, saves and scores), and what it used this month.
   Free       every game, by default: a small server (50 ms of CPU a request, 600 requests a minute) and $1 of use a
              month; past that its server is capped (slow) until the month ends
-  Creator    a game in one of your paid game slots: 200 ms a request, 6,000 requests a minute, 1 GB of saves, and
-             $10 of use a month per slot, shared by your Creator games
+  Creator    a game in one of your paid slots: 200 ms a request, 6,000 requests a minute, 1 GB of saves, and
+             $10 of use a month per paid slot, shared by your Creator games
   Scale      granted by xgames.fun for a game that needs more
 Every plan lets sites of yours embed the game (Free 3, Creator 10, Scale 25: ${CMD} embed); Creator and Scale serve
 it on domains of your own (1 and 5: ${CMD} domain).
-A slot is $15 for 30 days, prepaid in SOL or USDC on xgames.fun (Studio → Plans; no automatic renewal), and moves
-between your games at any time without changing the bill. Usage credit, bought the same way, lets Creator games go
-past what their slots include (at twice what xgames.fun pays) instead of slowing down.
-  activate     put this folder's game in a free slot
-  deactivate   take it out (it goes back to Free and the slot is free for another game)
-  --all        your slots and every game's plan`;
+Every game sits in a slot. Everyone gets 2 free slots, whose games run on Free; any more games need a paid slot,
+$15 for 30 days, prepaid in SOL or USDC on xgames.fun (your console → Plans; no automatic renewal), whose game runs on
+Creator. A paid slot moves between your games at any time without changing the bill. Usage credit, bought the same way,
+lets Creator games go past what their slots include (at twice what xgames.fun pays) instead of slowing down.
+  activate     move this folder's game to a paid slot (its free slot opens for another game)
+  deactivate   move it back to a free slot (one must be open; its paid slot opens for another game)
+  --all        your free and paid slots and every game's plan`;
 
 export default {
   name: 'plan',
@@ -57,7 +58,9 @@ export default {
       const r = await setActive(dir, verb === 'activate').catch(e => {
         if (e?.status === 409)
           throw new Error(
-            `${e.message} Free one with ${CMD} plan deactivate <another game>, or buy a slot on xgames.fun (Studio → Plans, in SOL or USDC).`,
+            e.code === 'no-free-slot'
+              ? `${e.message} Archive a game you no longer need on your console (xgames.fun/console), or move another game to a paid slot.`
+              : `${e.message} Open one with ${CMD} plan deactivate <another game>, or buy a paid slot on xgames.fun (your console → Plans, in SOL or USDC).`,
           );
         return plain(e);
       });
@@ -66,11 +69,11 @@ export default {
         const what =
           verb === 'activate'
             ? r.changed
-              ? 'In a slot: Creator from its next request.'
-              : 'Already in a slot.'
+              ? 'In a paid slot: Creator from its next request; its free slot is open for another game.'
+              : 'Already in a paid slot.'
             : r.changed
-              ? 'Out of its slot: Free from its next request, and the slot is free.'
-              : 'It was not in a slot.';
+              ? 'Back in a free slot: Free from its next request, and its paid slot is open for another game.'
+              : 'It was not in a paid slot.';
         console.log(`${what}\n${describeGame(r)}`);
       }
       return 0;

package/commands/publish.mjs

@@ -132,6 +132,16 @@ export function publishCommand({
           newGame: values.new,
           title: values.title ?? null,
           progress: values.json ? () => {} : l => console.error(l),
+        }).catch(e => {
+          // A new game needs one of the account's 2 free slots (xgames.fun's words say so); name the commands that free one.
+          if (e?.code === 'no-free-slot')
+            throw Object.assign(
+              new Error(
+                `${e.message}\n  ${CMD} plan activate <another game's folder>   moves that game to a paid slot\n  ${CMD} plan --all   your slots and games; archive one on ${origin}/console`,
+              ),
+              { status: e.status, code: e.code },
+            );
+          throw e;
         });
         if (values.json) printJson(r);
         else

package/lib/publish/plans.mjs

@@ -1,7 +1,10 @@
 // `xcore plan`'s calls to xgames.fun. A plan is a game's backend tier: Free by default (strict), or
 // Creator when its owner puts it in one of their paid game slots (priced per game slot a month; a slot moves between
 // games at any time without changing the bill), or Scale, which xgames.fun's operator grants.
-//   GET  /api/kit/plan                                  → {ok, slots, used, billing, capCents, monthCents, includedCents, games}
+// Every game sits in a slot: 2 free ones for everyone (their games on Free), any more are paid (their games on Creator).
+//   GET  /api/kit/plan                                  → {ok, slots, used, billing, capCents, monthCents, includedCents, games,
+//                                                          gameSlots?: {free: {slots, used}, paid: {slots, used}, granted, open}}
+//                                                          (slots/used: the paid slots; gameSlots: from xgames.fun 2026-11-08)
 //   GET  /api/kit/games/<gameId>/plan                   → {ok, game, tier, capped, comp, limits, monthCents, includedCents, slots, used}
 //   POST /api/kit/games/<gameId>/plan  {"active": bool} → the same, and changed
 // The game is the folder's own (its .gamesfun/publish.json for this Studio); the credential is publish's.
@@ -69,7 +72,7 @@ export function describeGame(r) {
     lines.push(
       '  capped: its server answers slowly (60 requests a minute) until the month ends, or until it gets more room',
     );
-  if (r.slots !== undefined) lines.push(`  game slots: ${r.used ?? 0} of ${r.slots} in use`);
+  if (r.slots !== undefined) lines.push(`  paid slots: ${r.used ?? 0} of ${r.slots} in use`);
   return lines.join('\n');
 }
 
@@ -78,12 +81,18 @@ export function describeAccount(r) {
   const open = r.payments?.on || r.billing;
   const until = r.periodEnd ? `, paid through ${new Date(r.periodEnd).toISOString().slice(0, 10)}` : '';
   const how = r.payments?.on
-    ? ` (buy or renew on xgames.fun: Studio → Plans, in ${(r.payments.currencies ?? ['SOL', 'USDC']).join(' or ')}${r.payments.cluster === 'devnet' ? ', devnet test payments' : ''})`
+    ? ` (buy or renew on xgames.fun: your console → Plans, in ${(r.payments.currencies ?? ['SOL', 'USDC']).join(' or ')}${r.payments.cluster === 'devnet' ? ', devnet test payments' : ''})`
     : open
       ? ''
       : ' (buying slots is not open on this xgames.fun yet)';
+  const s = r.gameSlots;
   const lines = [
-    `Game slots: ${r.used ?? 0} of ${r.slots ?? 0} in use${until}${how}`,
+    ...(s
+      ? [
+          `Free slots: ${s.free.used} of ${s.free.slots} in use (their games run on Free)${s.open === 0 ? '; a new game needs one: archive a game or move one to a paid slot' : ''}`,
+        ]
+      : []),
+    `${s ? 'Paid slots' : 'Game slots'}: ${r.used ?? 0} of ${r.slots ?? 0} in use${s ? ' (their games run on Creator)' : ''}${until}${how}`,
     `This month: ${dollars(r.monthCents)}${r.includedCents == null ? '' : ` of ${dollars(r.includedCents)} included`}${r.creditCents ? `; usage credit ${dollars(r.creditCents)}` : ''}${r.capCents ? `; spending cap ${dollars(r.capCents)}` : ''}`,
   ];
   for (const g of r.games ?? [])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgamesfun/xcore",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "xgames.fun from the command line: bring a web game you already made, check it as xgames.fun hosts it, give it a backend and a Solana economy, and publish it at a link anyone can play.",
   "keywords": [
     "game",

package/skills/bring-your-own-game/SKILL.md

@@ -165,9 +165,10 @@ nothing checked (their gameplay, their backend's own behaviour).
 
 A game with a `server/`, saves or scores runs under its **plan** (`xcore plan <folder>`): Free by default (50 ms of CPU
 and 600 requests a minute, $1 of use a month, then capped and slow until the month ends). When the game needs more
-(a server that replays play, many players at once), tell them: a paid game slot makes it Creator
-(`xcore plan activate <folder>` once they have a slot), and the slot moves between their games at any time. Never
-activate or deactivate a game without asking.
+(a server that replays play, many players at once), tell them: a paid slot makes it Creator
+(`xcore plan activate <folder>` once they have one), and the paid slot moves between their games at any time. Everyone
+has 2 free slots: a third game is refused on publish (`no-free-slot`) until they archive one on their console
+(xgames.fun/console) or move one to a paid slot. Never activate, deactivate or archive a game without asking.
 
 Their own website can show the game (`xcore embed add https://theirsite.com <folder>` prints the `<iframe>`), and on
 Creator or Scale it can play at their own domain (`xcore domain add play.theirsite.com <folder>` prints two DNS records