@nano133/nanoterra 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.14.0 (2026-11-02)
+
+- **"Free play" in /admin (Wes, 2026-11-02):** the Game card's fifth setting, a switch, On by default. Off says that the game has no free play: a player must pay in
+  the game to play. The switch only says so; the game asks for the payment. `freePlay` ("on" or "off") is in `GameSettings`, `GamePatch` and `GameState` (with
+  `fromAdmin.freePlay`), `POST {base}/game` takes `{ "freePlay": "on" | "off" }`, and the memory, D1 and Firestore stores keep it as `setting:freePlay`, with a
+  store conformance case. `freePlayOn(settings)` gives the listing file's word, `"freePlay": true` or `false`: Nanoterra's listing then says "Paid" in place of
+  "Free to play". The game's paid play, its prices and its risk are the creator's. The Overview lists the switch too.
+
 ## 0.13.0 (2026-11-01)
 
 - **The camera's distance on one curve (`createZoom`, `listenZoom` in `@nano133/nanoterra/input`):** one number, the camera's distance from the eyes, moved by

package/README.md

@@ -536,7 +536,7 @@ import { createAdminHandler } from "@nano133/nanoterra/admin";
 
 const admin = createAdminHandler({
   store,                                   // your database: readSettings(), saveSettings(patch, now), summary(now)  (a memory store is in the package, for tests)
-  defaults: { character: "nanoterra", signin: "exchange", friends: "nanoterra", emotes: "on" },   // what the switches are until /admin sets them (your game.config.json; friends and emotes may be left out)
+  defaults: { character: "nanoterra", signin: "exchange", friends: "nanoterra", emotes: "on", freePlay: "on" },   // what the switches are until /admin sets them (your game.config.json; friends, emotes and freePlay may be left out)
   owner: ownerAddress,                     // "nano_..." lowercase, its checksum checked by you; null when none is set
   session: (req, now) => readAdminSession(req, now),          // YOUR admin login: its own cookie; return { address, createdAt, via: "wallet" } or null
   status: (now, summary) => ({ address: ownerAddress, testMode, warnings }),   // what only your game knows (the store's numbers come too, for a warning like "2 payments came late")
@@ -562,11 +562,21 @@ neither header (curl) and the browser's own address bar (`Sec-Fetch-Site: none`)
 **The handler** sends every request under the base path (`/api/admin` by default) through the guard first, before the route is looked up: a visitor who is not the owner
 gets 401 or 403 for any path, so nothing about the routes leaks. A POST must come from the game's own page (`Origin`, else `Sec-Fetch-Site: same-origin`). It sets no CORS
 header, always sends `Cache-Control: no-store`, reads at most 512 bytes of a press, and limits presses to 30 a minute. A fault in your store gives a plain 500 that shows
-nothing of the fault (`onError` hears it). The only writes are the four settings (and, when the game turns on the sign-in list, the deletion of the admin sessions), **never a look, a price or an order**: a change of looks stays a change of your repository.
+nothing of the fault (`onError` hears it). The only writes are the five settings (and, when the game turns on the sign-in list, the deletion of the admin sessions), **never a look, a price or an order**: a change of looks stays a change of your repository.
 
-**Your own routes read the switches** with `loadGameSettings(store, defaults)` (for the listing file's `signin` word, the character, the friends list and the emotes): the stored word, else your default,
+**Your own routes read the switches** with `loadGameSettings(store, defaults)` (for the listing file's `signin` and `freePlay` words, the character, the friends list and the emotes): the stored word, else your default,
 and your defaults when the store fails.
 
+**Free play** (since 0.14.0). The Game card's switch "Free play" is On by default. Off says that the game has no free play: a player must pay in the game to play. The switch only
+says so, and your game asks for the payment. Your listing file carries it as `"freePlay": freePlayOn(settings)` (`true` or `false`; a file without it is a free game), and
+Nanoterra's listing then says "Paid" in place of "Free to play". Like the sign-in word, a change of a listed game's file waits for Nanoterra's review. Your paid game, its prices
+and its risk are yours, and every payment goes to a wallet that you hold the key for.
+
+```ts
+const settings = await loadGameSettings(store, defaults);
+const listing = { nanoGame: 1, /* name, line, play, art, creator, ... */ signin: settings.signin, freePlay: freePlayOn(settings) };
+```
+
 **The conformance suite** proves your whole chain, not only the guard: the cookie you read, the session lookup, the owner you pass.
 
 ```ts
@@ -614,8 +624,8 @@ the package's own sign-in, `/admin-signin`, passes it): only a wallet signature
 
 ### The store (an adapter for your database)
 
-`createAdminHandler` needs a store: three calls, `readSettings()`, `saveSettings(patch, now)` and `summary(now)`. Two adapters come with the package, and **both write only the four settings** (the D1 store also deletes the admin sessions, but only when the game turns on the sign-in list: see below)
-(`setting:character`, `setting:signin`, `setting:friends` and `setting:emotes`); every other call they make is a read. Both must pass the same **store contract**, `adminStoreConformance(make)` in
+`createAdminHandler` needs a store: three calls, `readSettings()`, `saveSettings(patch, now)` and `summary(now)`. Two adapters come with the package, and **both write only the five settings** (the D1 store also deletes the admin sessions, but only when the game turns on the sign-in list: see below)
+(`setting:character`, `setting:signin`, `setting:friends`, `setting:emotes` and `setting:freePlay`); every other call they make is a read. Both must pass the same **store contract**, `adminStoreConformance(make)` in
 `@nano133/nanoterra/admin/conformance`: the settings are kept and accumulate, saving changes no order, no owned look and no other row, an open order past its expiry counts as expired,
 the money is totalled right, the newest 500 orders come first, and a bad rate row is ignored. A game with another database writes its own store and runs the same contract.
 
@@ -677,7 +687,7 @@ status warnings, one banner); four numbers (Earned, Open now, To send back, Play
 looks with their share of the money, the last five orders, the switches as On or Off (and the friends list's choice) and the shelf in numbers (a game with no order yet gets three first steps).
 **Cosmetics**: the **Shelf** (below). **Orders**: a filter by status with its count, a search (a look, an address or a block), "Check payments now" when the game gave a
 check, "Paid late" with the address to send the money back to, 20 orders at a time; a card each on a phone, a table on a wide panel. **Players**: each player who owns a
-look, with their looks. **Settings**: the **Game** card (the character and sign-in switches, the friends list's three-way choice and "Allow Nanoterra emotes"), the Sign-ins card and the facts (the address, the mode, the nodes, the last price). The tabs are
+look, with their looks. **Settings**: the **Game** card (the character and sign-in switches, the friends list's three-way choice, "Allow Nanoterra emotes" and "Free play"), the Sign-ins card and the facts (the address, the mode, the nodes, the last price). The tabs are
 real tabs (the arrow keys, Home and End work); every tab is made once, so a draft, a search and a switch keep their state, and the panel never writes the page's address.
 A visitor who is signed out gets the game's sign-in; a wrong wallet, a Nanoterra sign-in and a missing owner address each get their own screen and see no data (a sign-out
 takes the drawn data off the page). Options: `api` (the handler's base path), `noAddressHelp`, `lookPicture(look)` (your own picture of a look for the Shelf), `repoHelp`,
@@ -714,7 +724,7 @@ flat picture stays. `createLookPreview({ size?, body?, record?, background?, key
 
 **The Shelf never writes.** It edits a draft in the owner's browser and gives text to copy (`looks.json`, or a message for an AI assistant): there is no call in the panel that
 changes a look, a price or an order, and a test proves that editing the Shelf sends no request. A change of looks is a change of your repository. The **Game** card writes only the
-three settings. The stylesheet is scoped under `.n133-admin`, so it cannot leak into your page; to theme it set `--n133-ink`, `--n133-ink-soft`, `--n133-paper`, `--n133-line`,
+five settings. The stylesheet is scoped under `.n133-admin`, so it cannot leak into your page; to theme it set `--n133-ink`, `--n133-ink-soft`, `--n133-paper`, `--n133-line`,
 `--n133-gem`, `--n133-gem-dark`, `--n133-sea`, `--n133-radius`, `--n133-font`, `--n133-ground` (the wells inside a card), `--n133-warn`, `--n133-bad` or `--n133-shadow` on the
 element that holds it. The keys, inputs, switches, swatches and price steps are 44 px or more; the tabs, filter keys and copy keys 40 px. The layout follows the panel's own
 width (a container query), not the window's: on a phone two cards a row and the five tabs as icons over their words; three cards a row and the orders as a table from

package/dist/admin/adapters/d1.d.ts

@@ -17,6 +17,7 @@ export declare const D1_KEYS: {
     readonly signin: "setting:signin";
     readonly friends: "setting:friends";
     readonly emotes: "setting:emotes";
+    readonly freePlay: "setting:freePlay";
 };
 /**
  * The admin store for D1. With `logins: true` it also lists the last admin sign-ins (the table `admin_logins`: at, country, browser) and can sign the owner out everywhere

package/dist/admin/adapters/d1.js

@@ -1,11 +1,11 @@
 // The admin store for a game on Cloudflare D1, with the tables of the game starter (migrations/0001_init.sql): `meta`, `orders` and `owned`.
-// It writes ONLY the four settings (`setting:character`, `setting:signin`, `setting:friends`, `setting:emotes` in `meta`); everything else it does is a read, except when the game turns the sign-in list on
+// It writes ONLY the five settings (`setting:character`, `setting:signin`, `setting:friends`, `setting:emotes`, `setting:freePlay` in `meta`); everything else it does is a read, except when the game turns the sign-in list on
 // (`logins: true`): then the one other write is `DELETE FROM sessions WHERE scope = 'admin'` ("sign out everywhere").
 //
 //   import { createD1Store } from "@nano133/nanoterra/admin/d1";
 //   const store = createD1Store(env.DB);
 import { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers } from "../summary.js";
-export const D1_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes" };
+export const D1_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes", freePlay: "setting:freePlay" };
 /**
  * The admin store for D1. With `logins: true` it also lists the last admin sign-ins (the table `admin_logins`: at, country, browser) and can sign the owner out everywhere
  * (`DELETE FROM sessions WHERE scope = 'admin'`, and `UPDATE signin_requests SET delivered = 1, expires_at = 0 WHERE scope = 'admin' AND delivered = 0` so that a request signed a moment ago
@@ -15,9 +15,9 @@ export const D1_KEYS = { character: "setting:character", signin: "setting:signin
 export function createD1Store(db, options = {}) {
     const store = {
         async readSettings() {
-            const rows = (await db.prepare("SELECT key, value FROM meta WHERE key IN (?, ?, ?, ?)").bind(D1_KEYS.character, D1_KEYS.signin, D1_KEYS.friends, D1_KEYS.emotes).all()).results;
+            const rows = (await db.prepare("SELECT key, value FROM meta WHERE key IN (?, ?, ?, ?, ?)").bind(D1_KEYS.character, D1_KEYS.signin, D1_KEYS.friends, D1_KEYS.emotes, D1_KEYS.freePlay).all()).results;
             const row = (key) => rows.find((r) => r.key === key)?.value;
-            return { character: row(D1_KEYS.character), signin: row(D1_KEYS.signin), friends: row(D1_KEYS.friends), emotes: row(D1_KEYS.emotes) };
+            return { character: row(D1_KEYS.character), signin: row(D1_KEYS.signin), friends: row(D1_KEYS.friends), emotes: row(D1_KEYS.emotes), freePlay: row(D1_KEYS.freePlay) };
         },
         async saveSettings(patch, now) {
             const write = (key, value) => db.prepare("INSERT INTO meta (key, value, at) VALUES (?, ?, ?) ON CONFLICT (key) DO UPDATE SET value = excluded.value, at = excluded.at").bind(key, value, now);
@@ -30,6 +30,8 @@ export function createD1Store(db, options = {}) {
                 batch.push(write(D1_KEYS.friends, patch.friends));
             if (patch.emotes)
                 batch.push(write(D1_KEYS.emotes, patch.emotes));
+            if (patch.freePlay)
+                batch.push(write(D1_KEYS.freePlay, patch.freePlay));
             if (batch.length)
                 await db.batch(batch);
         },

package/dist/admin/adapters/firestore.d.ts

@@ -34,6 +34,7 @@ export declare const FIRESTORE_KEYS: {
     readonly signin: "setting:signin";
     readonly friends: "setting:friends";
     readonly emotes: "setting:emotes";
+    readonly freePlay: "setting:freePlay";
 };
 export declare function createFirestoreStore(db: FirestoreLike, collections?: {
     meta?: string;

package/dist/admin/adapters/firestore.js

@@ -1,15 +1,15 @@
 // The admin store for a game on Firestore (the Admin SDK). The package has no Firebase dependency: the adapter uses the small interface below, which the
-// Admin SDK's `Firestore` fits. It writes ONLY the four settings; everything else it does is a read.
+// Admin SDK's `Firestore` fits. It writes ONLY the five settings; everything else it does is a read.
 //
 // The data model (the names a game must have; only the three collection names can be changed):
-//   meta/{key}          { value: string, at: number }          keys "setting:character", "setting:signin", "setting:friends", "setting:emotes", "rate" (value is JSON { usd, sources })
+//   meta/{key}          { value: string, at: number }          keys "setting:character", "setting:signin", "setting:friends", "setting:emotes", "setting:freePlay", "rate" (value is JSON { usd, sources })
 //   orders/{id}         { player, lookId, usd, amount, status, createdAt, expiresAt, paidAt, payer, hash }   `amount` is the raw amount as text
 //   owned/{player__lookId}  { player, lookId, orderId, grantedAt }
 //
 // The summary reads the newest 5000 orders (the counts and the totals are over those) and every owned look: for a small game. A big game should keep running totals.
 import { parseRate, summarize } from "../summary.js";
 export const FIRESTORE_SCAN_LIMIT = 5000;
-export const FIRESTORE_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes" };
+export const FIRESTORE_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes", freePlay: "setting:freePlay" };
 const text = (v, fallback = "") => (typeof v === "string" ? v : fallback);
 const num = (v, fallback = 0) => (typeof v === "number" && Number.isFinite(v) ? v : fallback);
 const orNull = (v) => (typeof v === "string" ? v : null);
@@ -23,8 +23,14 @@ export function createFirestoreStore(db, collections = {}) {
     };
     return {
         async readSettings() {
-            const [character, signin, friends, emotes] = await Promise.all([valueOf(FIRESTORE_KEYS.character), valueOf(FIRESTORE_KEYS.signin), valueOf(FIRESTORE_KEYS.friends), valueOf(FIRESTORE_KEYS.emotes)]);
-            return { character: character?.value, signin: signin?.value, friends: friends?.value, emotes: emotes?.value };
+            const [character, signin, friends, emotes, freePlay] = await Promise.all([
+                valueOf(FIRESTORE_KEYS.character),
+                valueOf(FIRESTORE_KEYS.signin),
+                valueOf(FIRESTORE_KEYS.friends),
+                valueOf(FIRESTORE_KEYS.emotes),
+                valueOf(FIRESTORE_KEYS.freePlay),
+            ]);
+            return { character: character?.value, signin: signin?.value, friends: friends?.value, emotes: emotes?.value, freePlay: freePlay?.value };
         },
         async saveSettings(patch, now) {
             const batch = db.batch();
@@ -37,6 +43,8 @@ export function createFirestoreStore(db, collections = {}) {
                 (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.friends), { value: patch.friends, at: now }), n++);
             if (patch.emotes)
                 (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.emotes), { value: patch.emotes, at: now }), n++);
+            if (patch.freePlay)
+                (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.freePlay), { value: patch.freePlay, at: now }), n++);
             if (n)
                 await batch.commit();
         },

package/dist/admin/conformance.d.ts

@@ -78,7 +78,7 @@ export type StoreHarness = {
             at: number;
         };
     }): Promise<void>;
-    /** Every row that the store could change by mistake, as one text: the orders, the owned looks and the meta rows that are NOT the four settings. Same rows, same text. */
+    /** Every row that the store could change by mistake, as one text: the orders, the owned looks and the meta rows that are NOT the five settings. Same rows, same text. */
     snapshot(): Promise<string>;
     /** Only for a store with `recentLogins` and `signOutEverywhere`: put admin sign-ins in the game's database (the store only reads them). */
     seedLogins?(rows: {

package/dist/admin/conformance.js

@@ -42,7 +42,7 @@ async function read(res) {
 /** A refusal carries words and a reason and nothing else: no data of the game. */
 const REFUSAL_KEYS = new Set(["error", "reason", "signedInAs"]);
 /** Words of the game's data that a refusal or an answer to a visitor must never hold. */
-const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"emotes"|"warnings"/;
+const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"emotes"|"freePlay"|"warnings"/;
 export function adminConformance(host) {
     const cases = [];
     const add = (name, run, timeoutMs) => cases.push(timeoutMs ? { name, run, timeoutMs } : { name, run });
@@ -263,7 +263,7 @@ export function adminStoreConformance(make) {
     const order = (id, over) => ({ id, player: A, lookId: "mint-cap", usd: "0.25", amountRaw: rawOf(0.25), status: "paid", createdAt: NOW - 1000, expiresAt: NOW + 1000, paidAt: NOW - 500, payer: A, hash: `H${id}`, ...over });
     add("a new store has no settings of its own", async ({ store }) => {
         const s = await store.readSettings();
-        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, `expected no settings, got ${JSON.stringify(s)}`);
+        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined && s.freePlay === undefined, `expected no settings, got ${JSON.stringify(s)}`);
     });
     add("the friends list is kept as its own setting: each of its three words, and a patch of it leaves the other two", async ({ store }) => {
         await store.saveSettings({ signin: "none", character: "own" }, NOW);
@@ -281,6 +281,14 @@ export function adminStoreConformance(make) {
             check(s.emotes === emotes && s.signin === "none" && s.character === "own" && s.friends === "off", `after emotes ${emotes}: ${JSON.stringify(s)}`);
         }
     });
+    add("the free play switch is kept as its own setting: off and on, and a patch of it leaves the other four", async ({ store }) => {
+        await store.saveSettings({ signin: "none", character: "own", friends: "off", emotes: "off" }, NOW);
+        for (const [i, freePlay] of ["off", "on"].entries()) {
+            await store.saveSettings({ freePlay }, NOW + 1 + i);
+            const s = await store.readSettings();
+            check(s.freePlay === freePlay && s.signin === "none" && s.character === "own" && s.friends === "off" && s.emotes === "off", `after freePlay ${freePlay}: ${JSON.stringify(s)}`);
+        }
+    });
     add("a patch saves only what it names; the next patch keeps the rest", async ({ store }) => {
         await store.saveSettings({ signin: "none" }, NOW);
         let s = await store.readSettings();
@@ -295,12 +303,12 @@ export function adminStoreConformance(make) {
     add("an empty patch writes nothing and does not fail", async ({ store }) => {
         await store.saveSettings({}, NOW);
         const s = await store.readSettings();
-        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, "an empty patch must save nothing");
+        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined && s.freePlay === undefined, "an empty patch must save nothing");
     });
     add("saving changes nothing but the settings: no order, no owned look, no other meta row", async (h) => {
         await h.seed({ orders: [order("1", {}), order("2", { status: "open" })], owned: [{ player: A, lookId: "mint-cap", at: NOW }], rate: { value: JSON.stringify({ usd: 1.2, sources: ["x"] }), at: NOW } });
         const before = await h.snapshot();
-        await h.store.saveSettings({ character: "own", signin: "none", friends: "off", emotes: "off" }, NOW + 5);
+        await h.store.saveSettings({ character: "own", signin: "none", friends: "off", emotes: "off", freePlay: "off" }, NOW + 5);
         check((await h.snapshot()) === before, "the rows of the game changed after saving the settings");
     });
     add("the summary counts the orders by status, reads an open order past its expiry as expired, and totals the money", async ({ store, seed }) => {

package/dist/admin/handler.d.ts

@@ -59,5 +59,5 @@ export declare const ADMIN_LIMITS: {
     readonly gameBodyMax: 512;
 };
 export declare function createAdminHandler(options: AdminHandlerOptions): AdminHandler;
-/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes): the stored words, or the game's defaults. A fault in the store gives the defaults. */
+/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes, free play): the stored words, or the game's defaults. A fault in the store gives the defaults. */
 export declare function loadGameSettings(store: Pick<AdminStore, "readSettings">, defaults: GameSettings): Promise<GameState>;

package/dist/admin/handler.js

@@ -2,7 +2,7 @@
 //
 //   GET  {base}/summary   the numbers: status, orders, the looks that players own
 //   GET  {base}/game      the game switches
-//   POST {base}/game      a press: { character }, { signin }, { friends } or { emotes } (only the known words)
+//   POST {base}/game      a press: { character }, { signin }, { friends }, { emotes } or { freePlay } (only the known words)
 //   POST {base}/check     the payment check, when the game gives one
 //
 // EVERY request under the base goes through `adminAccess` first, before the route is even looked up: a visitor who is not the owner gets 401 or 403
@@ -159,7 +159,7 @@ export function createAdminHandler(options) {
     }
     return { routes, basePath: options.basePath ?? "/api/admin", handle };
 }
-/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes): the stored words, or the game's defaults. A fault in the store gives the defaults. */
+/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes, free play): the stored words, or the game's defaults. A fault in the store gives the defaults. */
 export async function loadGameSettings(store, defaults) {
     try {
         return mergeSettings(await store.readSettings(), defaults);

package/dist/admin/index.d.ts

@@ -9,5 +9,5 @@ export type { AdminLogin, AdminOrder, AdminPlayer, AdminStatus, AdminStore, Admi
 export { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers, statusOf, summarize } from "./summary.js";
 export type { OrderRow } from "./summary.js";
 export { RAW_PER_XNO, xnoText } from "./amount.js";
-export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isEmotes, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
-export type { Character, Emotes, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";
+export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FREE_PLAY, DEFAULT_FRIENDS, FREE_PLAY_NOTE, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, freePlayOn, isCharacter, isEmotes, isFreePlay, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
+export type { Character, Emotes, FreePlay, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";

package/dist/admin/index.js

@@ -11,4 +11,4 @@ export { createMemoryStore } from "./memory.js";
 export { ADMIN_LOGINS_SHOWN } from "./store.js";
 export { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers, statusOf, summarize } from "./summary.js";
 export { RAW_PER_XNO, xnoText } from "./amount.js";
-export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isEmotes, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
+export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FREE_PLAY, DEFAULT_FRIENDS, FREE_PLAY_NOTE, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, freePlayOn, isCharacter, isEmotes, isFreePlay, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";

package/dist/admin/memory.js

@@ -14,7 +14,7 @@ export function createMemoryStore(seed = {}) {
         pendingAdminRequests: 0,
         pendingGameRequests: 0,
         async readSettings() {
-            return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends"), emotes: store.rows.get("setting:emotes") };
+            return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends"), emotes: store.rows.get("setting:emotes"), freePlay: store.rows.get("setting:freePlay") };
         },
         async saveSettings(patch) {
             if (patch.character)
@@ -25,6 +25,8 @@ export function createMemoryStore(seed = {}) {
                 store.rows.set("setting:friends", patch.friends);
             if (patch.emotes)
                 store.rows.set("setting:emotes", patch.emotes);
+            if (patch.freePlay)
+                store.rows.set("setting:freePlay", patch.freePlay);
             store.writes++;
         },
         async summary(now) {

package/dist/admin/panel/gameCard.js

@@ -1,8 +1,8 @@
 // The "Game" card of /admin: two switches, "Players can play as their Nanoterra character" and "Players can sign in with Nanoterra", one three-way
-// choice, "Friends list: Nanoterra / The game's own / Off", and the switch "Allow Nanoterra emotes". A press saves at once (POST {api}/game, behind the
-// same admin guard as every admin call) and the game reads the setting at run time, so the creator pushes and deploys nothing. The words are in
-// ../switches.ts. The card changes ONLY these four settings: never a look, a price or an order.
-import { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, pressOf, signinOn, stateOf } from "../switches.js";
+// choice, "Friends list: Nanoterra / The game's own / Off", and the switches "Allow Nanoterra emotes" and "Free play". A press saves at once (POST
+// {api}/game, behind the same admin guard as every admin call) and the game reads the setting at run time, so the creator pushes and deploys nothing.
+// The words are in ../switches.ts. The card changes ONLY these five settings: never a look, a price or an order.
+import { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, FREE_PLAY_NOTE, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, pressOf, signinOn, stateOf } from "../switches.js";
 import { ApiError } from "./api.js";
 import { h } from "./dom.js";
 /**
@@ -15,7 +15,7 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
     /** Under the character switch: it works only through sign-in, so it says so, and says what a player gets while sign-in is Off. */
     const needs = h("p", { class: "fine switch-needs" });
     const card = h("section", { class: "admin-card game-card", "aria-labelledby": "game-title" }, h("div", { class: "card-head" }, h("h2", { id: "game-title" }, "Game")));
-    card.append(h("p", { class: "fine card-intro" }, `Four choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
+    card.append(h("p", { class: "fine card-intro" }, `Five choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
     /** The friends choice: a radio group of three keys (arrow keys move between them, as a radio group does). */
     const friendsKeys = new Map();
     const friendsNote = h("p", { class: "switch-note", id: "switch-friends-note" });
@@ -108,6 +108,9 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
     }
     card.append(h("div", { class: "switch-row friends-row" }, h("div", { class: "switch-head" }, h("span", { class: "switch-title", id: "switch-friends-label" }, FRIENDS_TITLE), group), friendsNote, friendsStatus));
     switchRow("emotes");
+    // Free play is a word of the listing file too: Nanoterra's review decides what its listing says ("Free to play" or "Paid").
+    switchRow("freePlay");
+    card.append(h("p", { class: "fine switch-review" }, FREE_PLAY_NOTE, " ", h("a", { href: REVIEW_LINK, target: "_blank", rel: "noopener noreferrer" }, "Open the launch page")));
     draw();
     return card;
 }

package/dist/admin/panel/overview.js

@@ -31,7 +31,7 @@ export function overviewView(looks, colourOf, go) {
     const el = h("div", { class: "overview" }, main, side);
     const linkKey = (words, to) => h("button", { class: "btn btn-small btn-quiet link-key", type: "button", onclick: to }, words, h("span", { "aria-hidden": "true" }, "→"));
     function drawGame() {
-        const rows = ["character", "signin", "emotes"].map((id) => {
+        const rows = ["character", "signin", "emotes", "freePlay"].map((id) => {
             const on = game ? stateOf(id, game) : null;
             return h("li", {}, h("span", {}, SWITCHES[id].title), on === null ? h("span", { class: "pill" }, "Unknown") : h("span", { class: `pill ${on ? "pill-on" : "pill-off"}` }, on ? "On" : "Off"));
         });

package/dist/admin/store.d.ts

@@ -71,7 +71,7 @@ export type AdminLogin = {
 /** How many sign-ins the panel lists. */
 export declare const ADMIN_LOGINS_SHOWN = 10;
 /**
- * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the four settings and, when the game turns it on, the deletion of the admin sessions
+ * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the five settings and, when the game turns it on, the deletion of the admin sessions
  * (`signOutEverywhere`). Nothing else.
  * (There is no call that writes a look, a price or an order: the Shelf gives text to copy, and a change of looks is a change of the repository.)
  */
@@ -82,6 +82,7 @@ export interface AdminStore {
         signin?: unknown;
         friends?: unknown;
         emotes?: unknown;
+        freePlay?: unknown;
     }>;
     /** Saves a checked patch: all of it or none of it. */
     saveSettings(patch: GamePatch, now: number): Promise<void>;

package/dist/admin/switches.d.ts

@@ -9,12 +9,18 @@ export type Signin = "exchange" | "ticket" | "none";
 export type Friends = "nanoterra" | "own" | "off";
 /** Whether the game shows Nanoterra's emotes ("@nano133/nanoterra/emotes"): the wheel's Nanoterra emotes and the other players' on their characters. Off leaves the game's own emotes. */
 export type Emotes = "on" | "off";
-/** The game's own words for the switches. `friends` and `emotes` may be left out: "nanoterra" and "on" then (on by default). */
+/**
+ * Whether the game has free play. "off": a player pays in the game to play (the game asks for the payment; the switch does not). The listing file says it
+ * (`"freePlay": false`), and Nanoterra's listing then says "Paid" in place of "Free to play". The game's paid play, its prices and its risk are the creator's.
+ */
+export type FreePlay = "on" | "off";
+/** The game's own words for the switches. `friends`, `emotes` and `freePlay` may be left out: "nanoterra", "on" and "on" then (on by default). */
 export type GameSettings = {
     character: Character;
     signin: Signin;
     friends?: Friends;
     emotes?: Emotes;
+    freePlay?: FreePlay;
 };
 /** What a press can set: sign-in is on ("exchange": a game with a server) or off ("none"). */
 export type GamePatch = {
@@ -22,6 +28,7 @@ export type GamePatch = {
     signin?: "exchange" | "none";
     friends?: Friends;
     emotes?: Emotes;
+    freePlay?: FreePlay;
 };
 /** The settings as they are now, and which ones /admin has set (the others still have the game's default). */
 export type GameState = {
@@ -29,11 +36,13 @@ export type GameState = {
     signin: Signin;
     friends: Friends;
     emotes: Emotes;
+    freePlay: FreePlay;
     fromAdmin: {
         character: boolean;
         signin: boolean;
         friends: boolean;
         emotes: boolean;
+        freePlay: boolean;
     };
 };
 export declare const isCharacter: (v: unknown) => v is Character;
@@ -41,13 +50,18 @@ export declare const isSigninChoice: (v: unknown) => v is "exchange" | "none";
 export declare const isSignin: (v: unknown) => v is Signin;
 export declare const isFriends: (v: unknown) => v is Friends;
 export declare const isEmotes: (v: unknown) => v is Emotes;
+export declare const isFreePlay: (v: unknown) => v is FreePlay;
 /** The friends list a game shows while neither its own words nor /admin say: Nanoterra's. */
 export declare const DEFAULT_FRIENDS: Friends;
 /** Nanoterra's emotes are on while neither the game's own words nor /admin say. */
 export declare const DEFAULT_EMOTES: Emotes;
+/** Free play is on while neither the game's own words nor /admin say. */
+export declare const DEFAULT_FREE_PLAY: FreePlay;
+/** The listing file's word for free play (`"freePlay": true` or `false`), from the settings. */
+export declare const freePlayOn: (s: Pick<GameSettings, "freePlay">) => boolean;
 /** The sign-in switch is on for any way but "none". */
 export declare const signinOn: (s: Signin) => boolean;
-/** A request body for a press: only the two known words, at least one. Anything else is refused, with the reason in words. */
+/** A request body for a press: only the known words, at least one. Anything else is refused, with the reason in words. */
 export declare function parsePatch(body: unknown): {
     ok: true;
     patch: GamePatch;
@@ -61,6 +75,7 @@ export declare function mergeSettings(stored: {
     signin?: unknown;
     friends?: unknown;
     emotes?: unknown;
+    freePlay?: unknown;
 }, defaults: GameSettings): GameState;
 /** The friends choice of the card: its title, and for each choice its short name (the card's three keys) and one plain sentence. Nanoterra's is the default. */
 export declare const FRIENDS_TITLE = "Friends list";
@@ -69,7 +84,7 @@ export declare const FRIENDS_CHOICES: Record<Friends, {
     note: string;
 }>;
 /** One switch of the card: its title, and one plain sentence for each state. */
-export type SwitchId = "character" | "signin" | "emotes";
+export type SwitchId = "character" | "signin" | "emotes" | "freePlay";
 export declare const SWITCHES: Record<SwitchId, {
     title: string;
     on: string;
@@ -85,6 +100,8 @@ export declare const CHARACTER_SIGNIN_OFF = "Sign-in from Nanoterra is Off, so e
 /** What to tell the creator under the sign-in switch about Nanoterra's review. A game cannot see that review: it says so. */
 export declare const REVIEW_NOTE = "Your choice is saved here at once. The sign-in word is part of your listing file, and Nanoterra's review decides what Nanoterra shows for a game that is listed. This page cannot see that review. Check it on Nanoterra's launch page (step 6).";
 export declare const REVIEW_LINK = "https://nano133.com/build/nanoterra/launch";
+/** Under the free play switch: the word is part of the listing file, as the sign-in word is, so Nanoterra's review decides what Nanoterra shows. */
+export declare const FREE_PLAY_NOTE = "Your choice is saved here at once. Free play is part of your listing file too, and Nanoterra's review decides what Nanoterra's listing says for a game that is listed.";
 /** The state of a switch from the settings, and the patch that a press sends (the other state). */
 export declare const stateOf: (id: SwitchId, s: GameSettings) => boolean;
 export declare function pressOf(id: SwitchId, s: GameSettings): GamePatch;

package/dist/admin/switches.js

@@ -1,20 +1,25 @@
 // The switches of the "Game" card in /admin, and the words that say what each does. The handler checks a press with `parsePatch`; the panel
-// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these four settings; never a look, a price or an order.
+// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these five settings; never a look, a price or an order.
 export const isCharacter = (v) => v === "nanoterra" || v === "own";
 export const isSigninChoice = (v) => v === "exchange" || v === "none";
 export const isSignin = (v) => v === "exchange" || v === "ticket" || v === "none";
 export const isFriends = (v) => v === "nanoterra" || v === "own" || v === "off";
 export const isEmotes = (v) => v === "on" || v === "off";
+export const isFreePlay = (v) => v === "on" || v === "off";
 /** The friends list a game shows while neither its own words nor /admin say: Nanoterra's. */
 export const DEFAULT_FRIENDS = "nanoterra";
 /** Nanoterra's emotes are on while neither the game's own words nor /admin say. */
 export const DEFAULT_EMOTES = "on";
+/** Free play is on while neither the game's own words nor /admin say. */
+export const DEFAULT_FREE_PLAY = "on";
+/** The listing file's word for free play (`"freePlay": true` or `false`), from the settings. */
+export const freePlayOn = (s) => (s.freePlay ?? DEFAULT_FREE_PLAY) === "on";
 /** The sign-in switch is on for any way but "none". */
 export const signinOn = (s) => s !== "none";
-/** A request body for a press: only the two known words, at least one. Anything else is refused, with the reason in words. */
+/** A request body for a press: only the known words, at least one. Anything else is refused, with the reason in words. */
 export function parsePatch(body) {
     if (!body || typeof body !== "object" || Array.isArray(body))
-        return { ok: false, error: 'Send an object with "character", "signin", "friends" or "emotes".' };
+        return { ok: false, error: 'Send an object with "character", "signin", "friends", "emotes" or "freePlay".' };
     const patch = {};
     for (const [key, value] of Object.entries(body)) {
         if (key === "character" && isCharacter(value))
@@ -25,10 +30,14 @@ export function parsePatch(body) {
             patch.friends = value;
         else if (key === "emotes" && isEmotes(value))
             patch.emotes = value;
+        else if (key === "freePlay" && isFreePlay(value))
+            patch.freePlay = value;
         else if (key === "friends")
             return { ok: false, error: '"friends" must be "nanoterra", "own" or "off".' };
         else if (key === "emotes")
             return { ok: false, error: '"emotes" must be "on" or "off".' };
+        else if (key === "freePlay")
+            return { ok: false, error: '"freePlay" must be "on" or "off".' };
         else if (key === "character")
             return { ok: false, error: '"character" must be "nanoterra" or "own".' };
         else if (key === "signin")
@@ -37,7 +46,7 @@ export function parsePatch(body) {
             return { ok: false, error: `"${key}" is not a game switch.` };
     }
     if (!Object.keys(patch).length)
-        return { ok: false, error: 'Send "character", "signin", "friends" or "emotes".' };
+        return { ok: false, error: 'Send "character", "signin", "friends", "emotes" or "freePlay".' };
     return { ok: true, patch };
 }
 /** The settings from what the store kept and the game's defaults. A stored value that is not one of the known words is ignored. */
@@ -47,7 +56,8 @@ export function mergeSettings(stored, defaults) {
         signin: isSigninChoice(stored.signin) ? stored.signin : defaults.signin,
         friends: isFriends(stored.friends) ? stored.friends : isFriends(defaults.friends) ? defaults.friends : DEFAULT_FRIENDS,
         emotes: isEmotes(stored.emotes) ? stored.emotes : isEmotes(defaults.emotes) ? defaults.emotes : DEFAULT_EMOTES,
-        fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends), emotes: isEmotes(stored.emotes) },
+        freePlay: isFreePlay(stored.freePlay) ? stored.freePlay : isFreePlay(defaults.freePlay) ? defaults.freePlay : DEFAULT_FREE_PLAY,
+        fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends), emotes: isEmotes(stored.emotes), freePlay: isFreePlay(stored.freePlay) },
     };
 }
 /** The friends choice of the card: its title, and for each choice its short name (the card's three keys) and one plain sentence. Nanoterra's is the default. */
@@ -79,6 +89,11 @@ export const SWITCHES = {
         on: "On: players can play Nanoterra's emotes (Wave, Dance, Sit and more) from the Emotes wheel, and see the other players' emotes.",
         off: "Off: the game shows no Nanoterra emote. The game's own emotes, if it has any, stay on the wheel.",
     },
+    freePlay: {
+        title: "Free play",
+        on: "On: players can play without paying. Nanoterra's listing says “Free to play”.",
+        off: "Off: there is no free play. A player must pay in your game to play, and Nanoterra's listing says “Paid”. Your game asks for the payment: this switch only says so. Your paid game, its prices and its risk are yours.",
+    },
 };
 /**
  * The character comes through the sign-in: only a player who signs in from Nanoterra brings one. So the character switch is shown with its dependency. With sign-in Off the
@@ -90,12 +105,16 @@ export const CHARACTER_SIGNIN_OFF = "Sign-in from Nanoterra is Off, so every pla
 /** What to tell the creator under the sign-in switch about Nanoterra's review. A game cannot see that review: it says so. */
 export const REVIEW_NOTE = "Your choice is saved here at once. The sign-in word is part of your listing file, and Nanoterra's review decides what Nanoterra shows for a game that is listed. This page cannot see that review. Check it on Nanoterra's launch page (step 6).";
 export const REVIEW_LINK = "https://nano133.com/build/nanoterra/launch";
+/** Under the free play switch: the word is part of the listing file, as the sign-in word is, so Nanoterra's review decides what Nanoterra shows. */
+export const FREE_PLAY_NOTE = "Your choice is saved here at once. Free play is part of your listing file too, and Nanoterra's review decides what Nanoterra's listing says for a game that is listed.";
 /** The state of a switch from the settings, and the patch that a press sends (the other state). */
-export const stateOf = (id, s) => (id === "character" ? s.character === "nanoterra" : id === "emotes" ? (s.emotes ?? DEFAULT_EMOTES) === "on" : signinOn(s.signin));
+export const stateOf = (id, s) => id === "character" ? s.character === "nanoterra" : id === "emotes" ? (s.emotes ?? DEFAULT_EMOTES) === "on" : id === "freePlay" ? freePlayOn(s) : signinOn(s.signin);
 export function pressOf(id, s) {
     if (id === "character")
         return { character: s.character === "nanoterra" ? "own" : "nanoterra" };
     if (id === "emotes")
         return { emotes: stateOf("emotes", s) ? "off" : "on" };
+    if (id === "freePlay")
+        return { freePlay: freePlayOn(s) ? "off" : "on" };
     return { signin: signinOn(s.signin) ? "none" : "exchange" };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano133/nanoterra",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Nanoterra for a creator's game, in one package: the player's sign-in ticket, the player's character (a toon body on the island's skeleton), the looks ladder, the admin and its wallet sign-in, the friends list, an options menu, emotes, the player's sign-in (a passkey or a wallet app) and a shop that sells looks for Nano with no key on the server.",
   "type": "module",
   "main": "dist/index.js",

package/src/admin/adapters/d1.ts

@@ -1,5 +1,5 @@
 // The admin store for a game on Cloudflare D1, with the tables of the game starter (migrations/0001_init.sql): `meta`, `orders` and `owned`.
-// It writes ONLY the four settings (`setting:character`, `setting:signin`, `setting:friends`, `setting:emotes` in `meta`); everything else it does is a read, except when the game turns the sign-in list on
+// It writes ONLY the five settings (`setting:character`, `setting:signin`, `setting:friends`, `setting:emotes`, `setting:freePlay` in `meta`); everything else it does is a read, except when the game turns the sign-in list on
 // (`logins: true`): then the one other write is `DELETE FROM sessions WHERE scope = 'admin'` ("sign out everywhere").
 //
 //   import { createD1Store } from "@nano133/nanoterra/admin/d1";
@@ -21,7 +21,7 @@ export interface D1Like {
   batch(statements: D1StatementLike[]): Promise<unknown[]>;
 }
 
-export const D1_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes" } as const;
+export const D1_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes", freePlay: "setting:freePlay" } as const;
 
 type Row = { id: string; player: string; look_id: string; usd: string; amount: string; status: string; created_at: number; expires_at: number; paid_at: number | null; payer: string | null; hash: string | null };
 
@@ -34,9 +34,9 @@ type Row = { id: string; player: string; look_id: string; usd: string; amount: s
 export function createD1Store(db: D1Like, options: { logins?: boolean } = {}): AdminStore {
   const store: AdminStore = {
     async readSettings() {
-      const rows = (await db.prepare("SELECT key, value FROM meta WHERE key IN (?, ?, ?, ?)").bind(D1_KEYS.character, D1_KEYS.signin, D1_KEYS.friends, D1_KEYS.emotes).all<{ key: string; value: string }>()).results;
+      const rows = (await db.prepare("SELECT key, value FROM meta WHERE key IN (?, ?, ?, ?, ?)").bind(D1_KEYS.character, D1_KEYS.signin, D1_KEYS.friends, D1_KEYS.emotes, D1_KEYS.freePlay).all<{ key: string; value: string }>()).results;
       const row = (key: string) => rows.find((r) => r.key === key)?.value;
-      return { character: row(D1_KEYS.character), signin: row(D1_KEYS.signin), friends: row(D1_KEYS.friends), emotes: row(D1_KEYS.emotes) };
+      return { character: row(D1_KEYS.character), signin: row(D1_KEYS.signin), friends: row(D1_KEYS.friends), emotes: row(D1_KEYS.emotes), freePlay: row(D1_KEYS.freePlay) };
     },
 
     async saveSettings(patch: GamePatch, now: number) {
@@ -47,6 +47,7 @@ export function createD1Store(db: D1Like, options: { logins?: boolean } = {}): A
       if (patch.signin) batch.push(write(D1_KEYS.signin, patch.signin));
       if (patch.friends) batch.push(write(D1_KEYS.friends, patch.friends));
       if (patch.emotes) batch.push(write(D1_KEYS.emotes, patch.emotes));
+      if (patch.freePlay) batch.push(write(D1_KEYS.freePlay, patch.freePlay));
       if (batch.length) await db.batch(batch);
     },
 

package/src/admin/adapters/firestore.ts

@@ -1,8 +1,8 @@
 // The admin store for a game on Firestore (the Admin SDK). The package has no Firebase dependency: the adapter uses the small interface below, which the
-// Admin SDK's `Firestore` fits. It writes ONLY the four settings; everything else it does is a read.
+// Admin SDK's `Firestore` fits. It writes ONLY the five settings; everything else it does is a read.
 //
 // The data model (the names a game must have; only the three collection names can be changed):
-//   meta/{key}          { value: string, at: number }          keys "setting:character", "setting:signin", "setting:friends", "setting:emotes", "rate" (value is JSON { usd, sources })
+//   meta/{key}          { value: string, at: number }          keys "setting:character", "setting:signin", "setting:friends", "setting:emotes", "setting:freePlay", "rate" (value is JSON { usd, sources })
 //   orders/{id}         { player, lookId, usd, amount, status, createdAt, expiresAt, paidAt, payer, hash }   `amount` is the raw amount as text
 //   owned/{player__lookId}  { player, lookId, orderId, grantedAt }
 //
@@ -33,7 +33,7 @@ export interface FirestoreLike {
 }
 
 export const FIRESTORE_SCAN_LIMIT = 5000;
-export const FIRESTORE_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes" } as const;
+export const FIRESTORE_KEYS = { character: "setting:character", signin: "setting:signin", friends: "setting:friends", emotes: "setting:emotes", freePlay: "setting:freePlay" } as const;
 
 const text = (v: unknown, fallback = ""): string => (typeof v === "string" ? v : fallback);
 const num = (v: unknown, fallback = 0): number => (typeof v === "number" && Number.isFinite(v) ? v : fallback);
@@ -49,8 +49,14 @@ export function createFirestoreStore(db: FirestoreLike, collections: { meta?: st
   };
   return {
     async readSettings() {
-      const [character, signin, friends, emotes] = await Promise.all([valueOf(FIRESTORE_KEYS.character), valueOf(FIRESTORE_KEYS.signin), valueOf(FIRESTORE_KEYS.friends), valueOf(FIRESTORE_KEYS.emotes)]);
-      return { character: character?.value, signin: signin?.value, friends: friends?.value, emotes: emotes?.value };
+      const [character, signin, friends, emotes, freePlay] = await Promise.all([
+        valueOf(FIRESTORE_KEYS.character),
+        valueOf(FIRESTORE_KEYS.signin),
+        valueOf(FIRESTORE_KEYS.friends),
+        valueOf(FIRESTORE_KEYS.emotes),
+        valueOf(FIRESTORE_KEYS.freePlay),
+      ]);
+      return { character: character?.value, signin: signin?.value, friends: friends?.value, emotes: emotes?.value, freePlay: freePlay?.value };
     },
 
     async saveSettings(patch: GamePatch, now: number) {
@@ -60,6 +66,7 @@ export function createFirestoreStore(db: FirestoreLike, collections: { meta?: st
       if (patch.signin) (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.signin), { value: patch.signin, at: now }), n++);
       if (patch.friends) (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.friends), { value: patch.friends, at: now }), n++);
       if (patch.emotes) (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.emotes), { value: patch.emotes, at: now }), n++);
+      if (patch.freePlay) (batch.set(db.collection(meta).doc(FIRESTORE_KEYS.freePlay), { value: patch.freePlay, at: now }), n++);
       if (n) await batch.commit();
     },
 

package/src/admin/conformance.ts

@@ -104,7 +104,7 @@ async function read(res: Response): Promise<{ status: number; text: string; json
 const REFUSAL_KEYS = new Set(["error", "reason", "signedInAs"]);
 
 /** Words of the game's data that a refusal or an answer to a visitor must never hold. */
-const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"emotes"|"warnings"/;
+const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"emotes"|"freePlay"|"warnings"/;
 
 export function adminConformance(host: ConformanceHost): ConformanceCase[] {
   const cases: ConformanceCase[] = [];
@@ -337,7 +337,7 @@ export function adminConformance(host: ConformanceHost): ConformanceCase[] {
 export type StoreHarness = {
   store: AdminStore;
   seed(data: { orders?: OrderRow[]; owned?: { player: string; lookId: string; at: number }[]; rate?: { value: string; at: number } }): Promise<void>;
-  /** Every row that the store could change by mistake, as one text: the orders, the owned looks and the meta rows that are NOT the four settings. Same rows, same text. */
+  /** Every row that the store could change by mistake, as one text: the orders, the owned looks and the meta rows that are NOT the five settings. Same rows, same text. */
   snapshot(): Promise<string>;
   /** Only for a store with `recentLogins` and `signOutEverywhere`: put admin sign-ins in the game's database (the store only reads them). */
   seedLogins?(rows: { at: number; country: string | null; browser: string }[]): Promise<void>;
@@ -363,7 +363,7 @@ export function adminStoreConformance(make: () => Promise<StoreHarness>): Confor
 
   add("a new store has no settings of its own", async ({ store }) => {
     const s = await store.readSettings();
-    check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, `expected no settings, got ${JSON.stringify(s)}`);
+    check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined && s.freePlay === undefined, `expected no settings, got ${JSON.stringify(s)}`);
   });
 
   add("the friends list is kept as its own setting: each of its three words, and a patch of it leaves the other two", async ({ store }) => {
@@ -384,6 +384,15 @@ export function adminStoreConformance(make: () => Promise<StoreHarness>): Confor
     }
   });
 
+  add("the free play switch is kept as its own setting: off and on, and a patch of it leaves the other four", async ({ store }) => {
+    await store.saveSettings({ signin: "none", character: "own", friends: "off", emotes: "off" }, NOW);
+    for (const [i, freePlay] of (["off", "on"] as const).entries()) {
+      await store.saveSettings({ freePlay }, NOW + 1 + i);
+      const s = await store.readSettings();
+      check(s.freePlay === freePlay && s.signin === "none" && s.character === "own" && s.friends === "off" && s.emotes === "off", `after freePlay ${freePlay}: ${JSON.stringify(s)}`);
+    }
+  });
+
   add("a patch saves only what it names; the next patch keeps the rest", async ({ store }) => {
     await store.saveSettings({ signin: "none" }, NOW);
     let s = await store.readSettings();
@@ -399,13 +408,13 @@ export function adminStoreConformance(make: () => Promise<StoreHarness>): Confor
   add("an empty patch writes nothing and does not fail", async ({ store }) => {
     await store.saveSettings({}, NOW);
     const s = await store.readSettings();
-    check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, "an empty patch must save nothing");
+    check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined && s.freePlay === undefined, "an empty patch must save nothing");
   });
 
   add("saving changes nothing but the settings: no order, no owned look, no other meta row", async (h) => {
     await h.seed({ orders: [order("1", {}), order("2", { status: "open" })], owned: [{ player: A, lookId: "mint-cap", at: NOW }], rate: { value: JSON.stringify({ usd: 1.2, sources: ["x"] }), at: NOW } });
     const before = await h.snapshot();
-    await h.store.saveSettings({ character: "own", signin: "none", friends: "off", emotes: "off" }, NOW + 5);
+    await h.store.saveSettings({ character: "own", signin: "none", friends: "off", emotes: "off", freePlay: "off" }, NOW + 5);
     check((await h.snapshot()) === before, "the rows of the game changed after saving the settings");
   });
 

package/src/admin/handler.ts

@@ -2,7 +2,7 @@
 //
 //   GET  {base}/summary   the numbers: status, orders, the looks that players own
 //   GET  {base}/game      the game switches
-//   POST {base}/game      a press: { character }, { signin }, { friends } or { emotes } (only the known words)
+//   POST {base}/game      a press: { character }, { signin }, { friends }, { emotes } or { freePlay } (only the known words)
 //   POST {base}/check     the payment check, when the game gives one
 //
 // EVERY request under the base goes through `adminAccess` first, before the route is even looked up: a visitor who is not the owner gets 401 or 403
@@ -190,7 +190,7 @@ export function createAdminHandler(options: AdminHandlerOptions): AdminHandler {
   return { routes, basePath: options.basePath ?? "/api/admin", handle };
 }
 
-/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes): the stored words, or the game's defaults. A fault in the store gives the defaults. */
+/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes, free play): the stored words, or the game's defaults. A fault in the store gives the defaults. */
 export async function loadGameSettings(store: Pick<AdminStore, "readSettings">, defaults: GameSettings): Promise<GameState> {
   try {
     return mergeSettings(await store.readSettings(), defaults);

package/src/admin/index.ts

@@ -17,5 +17,5 @@ export type { AdminLogin, AdminOrder, AdminPlayer, AdminStatus, AdminStore, Admi
 export { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers, statusOf, summarize } from "./summary.js";
 export type { OrderRow } from "./summary.js";
 export { RAW_PER_XNO, xnoText } from "./amount.js";
-export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isEmotes, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
-export type { Character, Emotes, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";
+export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FREE_PLAY, DEFAULT_FRIENDS, FREE_PLAY_NOTE, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, freePlayOn, isCharacter, isEmotes, isFreePlay, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
+export type { Character, Emotes, FreePlay, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";

package/src/admin/memory.ts

@@ -35,13 +35,14 @@ export function createMemoryStore(seed: { orders?: OrderRow[]; owned?: { player:
     pendingAdminRequests: 0,
     pendingGameRequests: 0,
     async readSettings() {
-      return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends"), emotes: store.rows.get("setting:emotes") };
+      return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends"), emotes: store.rows.get("setting:emotes"), freePlay: store.rows.get("setting:freePlay") };
     },
     async saveSettings(patch: GamePatch) {
       if (patch.character) store.rows.set("setting:character", patch.character);
       if (patch.signin) store.rows.set("setting:signin", patch.signin);
       if (patch.friends) store.rows.set("setting:friends", patch.friends);
       if (patch.emotes) store.rows.set("setting:emotes", patch.emotes);
+      if (patch.freePlay) store.rows.set("setting:freePlay", patch.freePlay);
       store.writes++;
     },
     async summary(now: number): Promise<StoreSummary> {

package/src/admin/panel/gameCard.ts

@@ -1,9 +1,9 @@
 // The "Game" card of /admin: two switches, "Players can play as their Nanoterra character" and "Players can sign in with Nanoterra", one three-way
-// choice, "Friends list: Nanoterra / The game's own / Off", and the switch "Allow Nanoterra emotes". A press saves at once (POST {api}/game, behind the
-// same admin guard as every admin call) and the game reads the setting at run time, so the creator pushes and deploys nothing. The words are in
-// ../switches.ts. The card changes ONLY these four settings: never a look, a price or an order.
+// choice, "Friends list: Nanoterra / The game's own / Off", and the switches "Allow Nanoterra emotes" and "Free play". A press saves at once (POST
+// {api}/game, behind the same admin guard as every admin call) and the game reads the setting at run time, so the creator pushes and deploys nothing.
+// The words are in ../switches.ts. The card changes ONLY these five settings: never a look, a price or an order.
 
-import { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, pressOf, signinOn, stateOf, type Friends, type GameState, type SwitchId } from "../switches.js";
+import { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, FREE_PLAY_NOTE, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, pressOf, signinOn, stateOf, type Friends, type GameState, type SwitchId } from "../switches.js";
 import { ApiError, type Api } from "./api.js";
 import { h } from "./dom.js";
 
@@ -17,7 +17,7 @@ export function gameCard(api: Api, initial: GameState, defaultsFile = "the game'
   /** Under the character switch: it works only through sign-in, so it says so, and says what a player gets while sign-in is Off. */
   const needs = h("p", { class: "fine switch-needs" });
   const card = h("section", { class: "admin-card game-card", "aria-labelledby": "game-title" }, h("div", { class: "card-head" }, h("h2", { id: "game-title" }, "Game")));
-  card.append(h("p", { class: "fine card-intro" }, `Four choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
+  card.append(h("p", { class: "fine card-intro" }, `Five choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
   /** The friends choice: a radio group of three keys (arrow keys move between them, as a radio group does). */
   const friendsKeys = new Map<Friends, HTMLButtonElement>();
   const friendsNote = h("p", { class: "switch-note", id: "switch-friends-note" });
@@ -112,6 +112,9 @@ export function gameCard(api: Api, initial: GameState, defaultsFile = "the game'
   }
   card.append(h("div", { class: "switch-row friends-row" }, h("div", { class: "switch-head" }, h("span", { class: "switch-title", id: "switch-friends-label" }, FRIENDS_TITLE), group), friendsNote, friendsStatus));
   switchRow("emotes");
+  // Free play is a word of the listing file too: Nanoterra's review decides what its listing says ("Free to play" or "Paid").
+  switchRow("freePlay");
+  card.append(h("p", { class: "fine switch-review" }, FREE_PLAY_NOTE, " ", h("a", { href: REVIEW_LINK, target: "_blank", rel: "noopener noreferrer" }, "Open the launch page")));
   draw();
   return card;
 }

package/src/admin/panel/overview.ts

@@ -47,7 +47,7 @@ export function overviewView(looks: readonly Look[], colourOf: (lookId: string)
   const linkKey = (words: string, to: () => void) => h("button", { class: "btn btn-small btn-quiet link-key", type: "button", onclick: to }, words, h("span", { "aria-hidden": "true" }, "→"));
 
   function drawGame() {
-    const rows = (["character", "signin", "emotes"] as const).map((id) => {
+    const rows = (["character", "signin", "emotes", "freePlay"] as const).map((id) => {
       const on = game ? stateOf(id, game) : null;
       return h("li", {}, h("span", {}, SWITCHES[id].title), on === null ? h("span", { class: "pill" }, "Unknown") : h("span", { class: `pill ${on ? "pill-on" : "pill-off"}` }, on ? "On" : "Off"));
     });

package/src/admin/store.ts

@@ -48,13 +48,13 @@ export type AdminLogin = { at: number; country: string | null; browser: string }
 export const ADMIN_LOGINS_SHOWN = 10;
 
 /**
- * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the four settings and, when the game turns it on, the deletion of the admin sessions
+ * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the five settings and, when the game turns it on, the deletion of the admin sessions
  * (`signOutEverywhere`). Nothing else.
  * (There is no call that writes a look, a price or an order: the Shelf gives text to copy, and a change of looks is a change of the repository.)
  */
 export interface AdminStore {
   /** The settings that /admin has saved. A value that is not a known word is ignored by the handler, so an adapter returns what it holds. */
-  readSettings(): Promise<{ character?: unknown; signin?: unknown; friends?: unknown; emotes?: unknown }>;
+  readSettings(): Promise<{ character?: unknown; signin?: unknown; friends?: unknown; emotes?: unknown; freePlay?: unknown }>;
   /** Saves a checked patch: all of it or none of it. */
   saveSettings(patch: GamePatch, now: number): Promise<void>;
   summary(now: number): Promise<StoreSummary>;

package/src/admin/switches.ts

@@ -1,5 +1,5 @@
 // The switches of the "Game" card in /admin, and the words that say what each does. The handler checks a press with `parsePatch`; the panel
-// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these four settings; never a look, a price or an order.
+// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these five settings; never a look, a price or an order.
 
 /** Which character the player is: Nanoterra's island character (the one the player has there) or the game's own. */
 export type Character = "nanoterra" | "own";
@@ -12,52 +12,72 @@ export type Signin = "exchange" | "ticket" | "none";
 export type Friends = "nanoterra" | "own" | "off";
 /** Whether the game shows Nanoterra's emotes ("@nano133/nanoterra/emotes"): the wheel's Nanoterra emotes and the other players' on their characters. Off leaves the game's own emotes. */
 export type Emotes = "on" | "off";
-/** The game's own words for the switches. `friends` and `emotes` may be left out: "nanoterra" and "on" then (on by default). */
-export type GameSettings = { character: Character; signin: Signin; friends?: Friends; emotes?: Emotes };
+/**
+ * Whether the game has free play. "off": a player pays in the game to play (the game asks for the payment; the switch does not). The listing file says it
+ * (`"freePlay": false`), and Nanoterra's listing then says "Paid" in place of "Free to play". The game's paid play, its prices and its risk are the creator's.
+ */
+export type FreePlay = "on" | "off";
+/** The game's own words for the switches. `friends`, `emotes` and `freePlay` may be left out: "nanoterra", "on" and "on" then (on by default). */
+export type GameSettings = { character: Character; signin: Signin; friends?: Friends; emotes?: Emotes; freePlay?: FreePlay };
 /** What a press can set: sign-in is on ("exchange": a game with a server) or off ("none"). */
-export type GamePatch = { character?: Character; signin?: "exchange" | "none"; friends?: Friends; emotes?: Emotes };
+export type GamePatch = { character?: Character; signin?: "exchange" | "none"; friends?: Friends; emotes?: Emotes; freePlay?: FreePlay };
 /** The settings as they are now, and which ones /admin has set (the others still have the game's default). */
-export type GameState = { character: Character; signin: Signin; friends: Friends; emotes: Emotes; fromAdmin: { character: boolean; signin: boolean; friends: boolean; emotes: boolean } };
+export type GameState = {
+  character: Character;
+  signin: Signin;
+  friends: Friends;
+  emotes: Emotes;
+  freePlay: FreePlay;
+  fromAdmin: { character: boolean; signin: boolean; friends: boolean; emotes: boolean; freePlay: boolean };
+};
 
 export const isCharacter = (v: unknown): v is Character => v === "nanoterra" || v === "own";
 export const isSigninChoice = (v: unknown): v is "exchange" | "none" => v === "exchange" || v === "none";
 export const isSignin = (v: unknown): v is Signin => v === "exchange" || v === "ticket" || v === "none";
 export const isFriends = (v: unknown): v is Friends => v === "nanoterra" || v === "own" || v === "off";
 export const isEmotes = (v: unknown): v is Emotes => v === "on" || v === "off";
+export const isFreePlay = (v: unknown): v is FreePlay => v === "on" || v === "off";
 /** The friends list a game shows while neither its own words nor /admin say: Nanoterra's. */
 export const DEFAULT_FRIENDS: Friends = "nanoterra";
 /** Nanoterra's emotes are on while neither the game's own words nor /admin say. */
 export const DEFAULT_EMOTES: Emotes = "on";
+/** Free play is on while neither the game's own words nor /admin say. */
+export const DEFAULT_FREE_PLAY: FreePlay = "on";
+/** The listing file's word for free play (`"freePlay": true` or `false`), from the settings. */
+export const freePlayOn = (s: Pick<GameSettings, "freePlay">): boolean => (s.freePlay ?? DEFAULT_FREE_PLAY) === "on";
 /** The sign-in switch is on for any way but "none". */
 export const signinOn = (s: Signin): boolean => s !== "none";
 
-/** A request body for a press: only the two known words, at least one. Anything else is refused, with the reason in words. */
+/** A request body for a press: only the known words, at least one. Anything else is refused, with the reason in words. */
 export function parsePatch(body: unknown): { ok: true; patch: GamePatch } | { ok: false; error: string } {
-  if (!body || typeof body !== "object" || Array.isArray(body)) return { ok: false, error: 'Send an object with "character", "signin", "friends" or "emotes".' };
+  if (!body || typeof body !== "object" || Array.isArray(body)) return { ok: false, error: 'Send an object with "character", "signin", "friends", "emotes" or "freePlay".' };
   const patch: GamePatch = {};
   for (const [key, value] of Object.entries(body as Record<string, unknown>)) {
     if (key === "character" && isCharacter(value)) patch.character = value;
     else if (key === "signin" && isSigninChoice(value)) patch.signin = value;
     else if (key === "friends" && isFriends(value)) patch.friends = value;
     else if (key === "emotes" && isEmotes(value)) patch.emotes = value;
+    else if (key === "freePlay" && isFreePlay(value)) patch.freePlay = value;
     else if (key === "friends") return { ok: false, error: '"friends" must be "nanoterra", "own" or "off".' };
     else if (key === "emotes") return { ok: false, error: '"emotes" must be "on" or "off".' };
+    else if (key === "freePlay") return { ok: false, error: '"freePlay" must be "on" or "off".' };
     else if (key === "character") return { ok: false, error: '"character" must be "nanoterra" or "own".' };
     else if (key === "signin") return { ok: false, error: '"signin" must be "exchange" or "none".' };
     else return { ok: false, error: `"${key}" is not a game switch.` };
   }
-  if (!Object.keys(patch).length) return { ok: false, error: 'Send "character", "signin", "friends" or "emotes".' };
+  if (!Object.keys(patch).length) return { ok: false, error: 'Send "character", "signin", "friends", "emotes" or "freePlay".' };
   return { ok: true, patch };
 }
 
 /** The settings from what the store kept and the game's defaults. A stored value that is not one of the known words is ignored. */
-export function mergeSettings(stored: { character?: unknown; signin?: unknown; friends?: unknown; emotes?: unknown }, defaults: GameSettings): GameState {
+export function mergeSettings(stored: { character?: unknown; signin?: unknown; friends?: unknown; emotes?: unknown; freePlay?: unknown }, defaults: GameSettings): GameState {
   return {
     character: isCharacter(stored.character) ? stored.character : defaults.character,
     signin: isSigninChoice(stored.signin) ? stored.signin : defaults.signin,
     friends: isFriends(stored.friends) ? stored.friends : isFriends(defaults.friends) ? defaults.friends : DEFAULT_FRIENDS,
     emotes: isEmotes(stored.emotes) ? stored.emotes : isEmotes(defaults.emotes) ? defaults.emotes : DEFAULT_EMOTES,
-    fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends), emotes: isEmotes(stored.emotes) },
+    freePlay: isFreePlay(stored.freePlay) ? stored.freePlay : isFreePlay(defaults.freePlay) ? defaults.freePlay : DEFAULT_FREE_PLAY,
+    fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends), emotes: isEmotes(stored.emotes), freePlay: isFreePlay(stored.freePlay) },
   };
 }
 
@@ -76,7 +96,7 @@ export const FRIENDS_CHOICES: Record<Friends, { name: string; note: string }> =
 };
 
 /** One switch of the card: its title, and one plain sentence for each state. */
-export type SwitchId = "character" | "signin" | "emotes";
+export type SwitchId = "character" | "signin" | "emotes" | "freePlay";
 export const SWITCHES: Record<SwitchId, { title: string; on: string; off: string }> = {
   character: {
     title: "Players can play as their Nanoterra character",
@@ -93,6 +113,11 @@ export const SWITCHES: Record<SwitchId, { title: string; on: string; off: string
     on: "On: players can play Nanoterra's emotes (Wave, Dance, Sit and more) from the Emotes wheel, and see the other players' emotes.",
     off: "Off: the game shows no Nanoterra emote. The game's own emotes, if it has any, stay on the wheel.",
   },
+  freePlay: {
+    title: "Free play",
+    on: "On: players can play without paying. Nanoterra's listing says “Free to play”.",
+    off: "Off: there is no free play. A player must pay in your game to play, and Nanoterra's listing says “Paid”. Your game asks for the payment: this switch only says so. Your paid game, its prices and its risk are yours.",
+  },
 };
 
 /**
@@ -107,11 +132,15 @@ export const CHARACTER_SIGNIN_OFF = "Sign-in from Nanoterra is Off, so every pla
 export const REVIEW_NOTE =
   "Your choice is saved here at once. The sign-in word is part of your listing file, and Nanoterra's review decides what Nanoterra shows for a game that is listed. This page cannot see that review. Check it on Nanoterra's launch page (step 6).";
 export const REVIEW_LINK = "https://nano133.com/build/nanoterra/launch";
+/** Under the free play switch: the word is part of the listing file, as the sign-in word is, so Nanoterra's review decides what Nanoterra shows. */
+export const FREE_PLAY_NOTE = "Your choice is saved here at once. Free play is part of your listing file too, and Nanoterra's review decides what Nanoterra's listing says for a game that is listed.";
 
 /** The state of a switch from the settings, and the patch that a press sends (the other state). */
-export const stateOf = (id: SwitchId, s: GameSettings): boolean => (id === "character" ? s.character === "nanoterra" : id === "emotes" ? (s.emotes ?? DEFAULT_EMOTES) === "on" : signinOn(s.signin));
+export const stateOf = (id: SwitchId, s: GameSettings): boolean =>
+  id === "character" ? s.character === "nanoterra" : id === "emotes" ? (s.emotes ?? DEFAULT_EMOTES) === "on" : id === "freePlay" ? freePlayOn(s) : signinOn(s.signin);
 export function pressOf(id: SwitchId, s: GameSettings): GamePatch {
   if (id === "character") return { character: s.character === "nanoterra" ? "own" : "nanoterra" };
   if (id === "emotes") return { emotes: stateOf("emotes", s) ? "off" : "on" };
+  if (id === "freePlay") return { freePlay: freePlayOn(s) ? "off" : "on" };
   return { signin: signinOn(s.signin) ? "none" : "exchange" };
 }