@origingame/create-game 0.2.0 → 0.4.0

package/archetypes/tower-defense/project.ogt

@@ -3,7 +3,7 @@ version 1
 ---
 name "Path Guard"
 id "tower-defense"
-engine "0.2.0"
+engine "0.4.0"
 entry "src/main.ts"
 profile "2d"
 tick 60

package/archetypes/tower-defense/src/components.ts

@@ -28,7 +28,7 @@ export const Refusal = { None: 0, Poor: 1, Blocked: 2, Taken: 3 } as const;
 /** The round: the lantern's light, the purse, the waves and the effects' bookkeeping. */
 export const Game = defineResource("Game", {
   phase: u32(Phase.Title, { doc: "Phase.* of src/components.ts." }),
-  leftTitle: bool(false, { doc: "The player has left the title the game opened on: from then on the title enters with the skin's entrance (the opening one is built settled, og.ui.mainMenu's instant: the web draws it behind the play gate)." }),
+  leftTitle: bool(false, { doc: "The player has left the title the game opened on: from then on the title enters with the style's entrance (the opening one is built settled, og.ui.mainMenu's instant: the web draws it behind the play gate)." }),
   paused: bool(false, { doc: "The pause menu is open (the garden holds)." }),
   settingsOpen: bool(false, { doc: "The settings dialog is open." }),
   won: bool(false, { doc: "The last round held every wave." }),

package/archetypes/tower-defense/src/main.ts

@@ -32,11 +32,11 @@ function must<T>(r: { ok: true; value?: T } | { ok: false; reason: string }): T
 
 function start(world: World): void {
   for (const l of LANGUAGES) must(og.i18n.load(world, `strings/${l.code}.ogt`));
-  const skin = must(og.load.skin(world, "skins/pathguard/skin.ogt"));
+  const style = must(og.load.style(world, "styles/pathguard/style.ogt"));
   const sound = (path: string) => must(og.load.sound(world, path));
   must(
     og.ui.configure(world, {
-      skin,
+      style,
       sounds: { press: sound("audio/ui-press.ogt"), open: sound("audio/ui-open.ogt"), close: sound("audio/ui-close.ogt"), error: sound("audio/ui-error.ogt"), success: sound("audio/ui-success.ogt") },
     }),
   );

package/archetypes/tower-defense/src/ui.ts

@@ -1,4 +1,4 @@
-// Path Guard's screens on og.ui and the skin in assets/skins/pathguard:
+// Path Guard's screens on og.ui and the style in assets/styles/pathguard:
 // the title, the HUD (the light and the coins in the top-left corner, the
 // wave and pause in the top-right, the plant tray on the right on a wide
 // screen and along the bottom on a phone), the pause menu, the settings
@@ -30,8 +30,10 @@ type PrefsV = Value<typeof Prefs>;
  * millisecond), so the screens read it from here.
  */
 const SPACE = { xxs: 2, xs: 4, sm: 8, md: 12, lg: 16, xl: 24 } as const;
-type Theme = { readonly space: typeof SPACE };
-const THEME: Theme = { space: SPACE };
+/** The pathguard style's radius block (assets/styles/pathguard/style.ogt), read from here for the same reason. */
+const RADIUS = { bar: 6, panel: 10 } as const;
+type Theme = { readonly space: typeof SPACE; readonly radius: typeof RADIUS };
+const THEME: Theme = { space: SPACE, radius: RADIUS };
 
 /** A string of the active locale (og.i18n). */
 export function say(world: World, key: string, args?: Record<string, string | number>): string {
@@ -193,10 +195,10 @@ function platform(world: World, g: GameV, p: PrefsV): void {
   }
 }
 
-/** One HUD capsule: an icon and a number counting to its value. */
-function capsule(t: Theme, id: string, icon: string, value: number, tone: "accent" | "danger" | "fg"): void {
-  og.ui.row(id, { gap: t.space.xs, cross: "center", padding: { left: t.space.sm, top: t.space.xs, right: t.space.md, bottom: t.space.xs }, frame: "capsule", background: { token: "surface" }, radius: 999 }, () => {
-    og.ui.icon("Icon", icon, { size: 26, tint: { token: tone === "fg" ? "fg" : tone } });
+/** One HUD box: an icon and a number counting to its value. */
+function hudBox(t: Theme, id: string, icon: string, value: number, tone: "gold" | "danger" | "ink"): void {
+  og.ui.row(id, { gap: t.space.xs, cross: "center", padding: { left: t.space.sm, top: t.space.xs, right: t.space.md, bottom: t.space.xs }, frame: "hud", background: { token: "panel" }, radius: t.radius.bar }, () => {
+    og.ui.icon("Icon", icon, { size: 26, tint: { token: tone } });
     og.ui.counter("Value", value, { step: "xl", font: "display", durationMs: 300, width: px(56), align: "center" });
   });
 }
@@ -205,14 +207,14 @@ function hud(world: World, theme: Theme, g: GameV, t: TuneV): void {
   const small = phone();
   og.ui.setNavigation(false);
   og.ui.anchor("Purse", { anchor: "topLeft", gap: theme.space.sm }, () => {
-    capsule(theme, "Light", "heart", g.lives, g.lives <= 3 ? "danger" : "fg");
-    capsule(theme, "Coins", "coin", g.gold, "accent");
+    hudBox(theme, "Light", "heart", g.lives, g.lives <= 3 ? "danger" : "ink");
+    hudBox(theme, "Coins", "coin", g.gold, "gold");
     // A refused placement shakes the purse once, with the error sound (og-ui §6).
     if (g.refusedTick === world.tick) og.ui.shake({ sound: true });
   });
   let paused = false;
   og.ui.anchor("Waves", { anchor: "topRight", gap: theme.space.sm, cross: "center" }, () => {
-    og.ui.row("Wave", { cross: "center", padding: { left: theme.space.md, top: theme.space.xs, right: theme.space.md, bottom: theme.space.xs }, frame: "capsule", background: { token: "surface" }, radius: 999 }, () => {
+    og.ui.row("Wave", { cross: "center", padding: { left: theme.space.md, top: theme.space.xs, right: theme.space.md, bottom: theme.space.xs }, frame: "hud", background: { token: "panel" }, radius: theme.radius.bar }, () => {
       og.ui.label("Label", say(world, "hud.wave", { n: Math.max(1, g.wave), total: WAVES.length }), { step: "lg", font: "display", nowrap: true });
     });
     if (og.ui.actionButton("Pause", say(world, "hud.pause"), { icon: "pause", size: 48 }).clicked) paused = true;
@@ -223,11 +225,11 @@ function hud(world: World, theme: Theme, g: GameV, t: TuneV): void {
     PLANTS.forEach((name, kind) => {
       const price = cost(t, kind);
       const chosen = g.selected === kind;
-      og.ui.column(og.ui.idi("Plant", kind), { cross: "center", gap: theme.space.xxs, padding: { left: theme.space.sm, top: theme.space.xs, right: theme.space.sm, bottom: theme.space.sm }, frame: "card", background: { token: "surface" }, radius: 18 }, () => {
+      og.ui.column(og.ui.idi("Plant", kind), { cross: "center", gap: theme.space.xxs, padding: { left: theme.space.sm, top: theme.space.xs, right: theme.space.sm, bottom: theme.space.sm }, frame: "card", background: { token: "panel" }, radius: theme.radius.panel }, () => {
         og.ui.row("Top", { cross: "center", gap: theme.space.xs }, () => {
           og.ui.image("Picture", { texture: g.sheet as unknown as never, uv: uvOf(PICTURE[kind]!), width: px(small ? 32 : 44), height: px(small ? 32 : 44) });
           // The price: muted when the purse covers it, in danger's ink when it does not.
-          og.ui.label("Price", `${price}`, { step: "lg", font: "display", color: { token: g.gold >= price ? "fgMuted" : "danger" }, nowrap: true, width: px(40), align: "center" });
+          og.ui.label("Price", `${price}`, { step: "lg", font: "display", color: { token: g.gold >= price ? "inkMuted" : "danger" }, nowrap: true, width: px(40), align: "center" });
         });
         if (og.ui.button("Pick", say(world, `tower.${name}`), { variant: chosen ? "primary" : "secondary", size: small ? "medium" : "small", width: px(small ? 86 : 104) }).clicked) g.selected = kind;
       });
@@ -237,7 +239,7 @@ function hud(world: World, theme: Theme, g: GameV, t: TuneV): void {
   // On a phone the call for the next wave sits over the tray, in the thumb's reach.
   if (small) og.ui.anchor("Call", { anchor: "bottom", offsetY: -112 }, () => callButton(world, g, small));
   if (g.wave === 0 && !small) {
-    og.ui.anchor("Hint", { anchor: "bottom", padding: { left: theme.space.md, top: theme.space.xs, right: theme.space.md, bottom: theme.space.xs }, frame: "capsule", background: { token: "surface" }, radius: 999 }, () => {
+    og.ui.anchor("Hint", { anchor: "bottom", padding: { left: theme.space.md, top: theme.space.xs, right: theme.space.md, bottom: theme.space.xs }, frame: "hud", background: { token: "panel" }, radius: theme.radius.bar }, () => {
       og.ui.label("Text", say(world, "hud.hint"), { nowrap: true });
     });
   }
@@ -267,7 +269,7 @@ function settings(world: World, theme: Theme, g: GameV, p: PrefsV): void {
     p.master = slider("Master", "settings.master", p.master);
     p.music = slider("Music", "settings.music", p.music);
     p.effects = slider("Effects", "settings.effects", p.effects);
-    og.ui.label("LanguageLabel", say(world, "settings.language"), { color: { token: "fgMuted" } });
+    og.ui.label("LanguageLabel", say(world, "settings.language"), { color: { token: "inkMuted" } });
     const r = og.ui.radio("Language", LANGUAGES.map((l) => say(world, l.key)), p.language, { horizontal: true });
     if (r.selected !== p.language) setLanguage(world, p, r.selected);
     p.reducedMotion = og.ui.toggle("Motion", p.reducedMotion, say(world, "settings.motion")).on;
@@ -293,15 +295,15 @@ function endCard(world: World, theme: Theme, g: GameV, t: TuneV): "retry" | "men
       for (let k = 0; k < 3; k++) {
         const lit = k < stars && since >= 20 + k * 12;
         og.ui.transition(og.ui.idi("Star", k), true, { kind: "scale" }, () => {
-          og.ui.icon("Mark", "star", { size: 40, tint: { token: lit ? "accent" : "fillStrong" } });
+          og.ui.icon("Mark", "star", { size: 40, tint: { token: lit ? "primary" : "controlStrong" } });
         });
         if (lit && since === 20 + k * 12) og.ui.burst({ count: 10 });
       }
     });
     og.ui.counter("Score", g.score, { from: 0, durationMs: 900, step: "displayMd", font: "display", align: "center", width: grow });
     og.ui.row("BestRow", { width: grow, align: "center", gap: theme.space.sm, cross: "center" }, () => {
-      og.ui.label("Best", say(world, "over.best", { n: g.best }), { color: { token: "fgMuted" }, nowrap: true });
-      if (g.newBest) og.ui.transition("NewBest", since > 50, { kind: "pop" }, () => og.ui.badge("Badge", say(world, "over.newBest"), "accent"));
+      og.ui.label("Best", say(world, "over.best", { n: g.best }), { color: { token: "inkMuted" }, nowrap: true });
+      if (g.newBest) og.ui.transition("NewBest", since > 50, { kind: "pop" }, () => og.ui.badge("Badge", say(world, "over.newBest"), "primary"));
     });
     og.ui.column("Stats", { width: grow, gap: 0 }, () => {
       og.ui.keyValue("Waves", say(world, "over.waves"), `${g.won ? g.wave : Math.max(0, g.wave - 1)}/${WAVES.length}`, true);
@@ -349,7 +351,7 @@ export const Ui = defineSystem("Ui", { reads: [Tuning], writes: [Game, Prefs, og
       ],
       footer: say(world, "title.footer"),
       // The title the game opens on is built settled: the web draws it behind the play gate, where
-      // the skin's entrance would stand part-way until the tap (og-platform-sdk §3). Later titles enter.
+      // the style's entrance would stand part-way until the tap (og-platform-sdk §3). Later titles enter.
       instant: !g.leftTitle,
     });
     if (!g.settingsOpen && r.selected === "play") startRound(world, g, t);

package/bin/create.ts

@@ -47,7 +47,7 @@ export interface CreateOptions {
   readonly name?: string;
   readonly id?: string;
   readonly force?: boolean;
-  /** Start from an archetype (`runner`, `match3`, `topdown`, `tower-defense`, `roguelike`, `idle`, `rhythm`, `third-person`: templates/archetypes/README.md) instead of the project template. */
+  /** Start from an archetype (`runner`, `match3`, `topdown`, `tower-defense`, `roguelike`, `idle`, `rhythm`, `third-person`, `arena`: templates/archetypes/README.md) instead of the project template. */
   readonly archetype?: string;
   /** The template's profile: `2d` writes the 2D starter (templates/game-2d), `3d` the 3D template (templates/game). Unset, a premise that says 2D picks `2d`; else `3d`. Not for an archetype, which has its own. */
   readonly profile?: Profile;
@@ -102,7 +102,7 @@ export interface Style {
   readonly descriptor: string;
   readonly premise: Readonly<Record<string, string>>;
   readonly look: { readonly presetReady: boolean; readonly support: string; readonly missing: readonly string[] };
-  readonly skin: string;
+  readonly ui: string;
 }
 
 /** The style catalogue this copy of the package reads. */
@@ -215,7 +215,10 @@ export function templateDir(archetype?: string, profile: Profile = "3d"): string
   }
   const packed = profile === "2d" ? "template-2d" : "template";
   const source = profile === "2d" ? "game-2d" : "game";
-  for (const candidate of [join(here, "..", packed), join(here, "..", "..", "..", "templates", source)]) {
+  // In the engine repository the live template wins: a ./template/ left by an
+  // earlier prepack is stale as soon as templates/ changes. A published
+  // package has no templates/ beside it, so it scaffolds from its packed copy.
+  for (const candidate of [join(here, "..", "..", "..", "templates", source), join(here, "..", packed)]) {
     if (existsSync(join(candidate, "project.ogt"))) return candidate;
   }
   throw new Error(`no ${profile} project template next to ${here}: expected ../${packed} (published package) or ../../../templates/${source} (engine repository)`);
@@ -281,8 +284,8 @@ function lookText(name: string, style: Style | undefined, slug: string | null, i
     head.push(
       `# It extends the style catalogue's ${slug} preset (${style.name}),`,
       style.look.support === "full" ? "# whose primitives all draw today." : `# support ${style.look.support}: ${style.look.missing.join("; ")}.`,
-      `# The style's UI skin pack is ${style.skin}: copy templates/ui-kit/assets/skins/${style.skin}`,
-      `# to assets/skins/${id}/ and add \`skin "skins/${id}/skin.ogt"\` to dress the UI.`,
+      `# The preset dresses the UI in the built-in ${style.ui} style; a \`ui "<slug>"\``,
+      `# line here picks another, or the game's own assets/styles/<name>/style.ogt.`,
     );
   } else if (slug) head.push(`# It extends ${slug}.`);
   else head.push("# It extends no preset yet: the frame is the engine's defaults plus the lines below.");
@@ -309,11 +312,11 @@ function lookReadme(look: CreatedLook, style: Style | undefined, entry: string,
     "after the first scene spawns and before `start` runs, and sets tone",
     "mapping and exposure, the post stack, the stylisation (`Stylise`),",
     "material defaults (`MaterialStyle`: toon, outlines, flat shading), fog,",
-    "sky, the environment map and the UI skin.",
+    "sky, the environment map and the UI style (its `ui` line).",
     "",
   ];
   if (look.extends && style) {
-    lines.push(`It extends \`${look.extends}\`${how}: "${style.name}" in the style`, `catalogue. ${style.descriptor} Its UI skin pack is \`${style.skin}\`.`, "");
+    lines.push(`It extends \`${look.extends}\`${how}: "${style.name}" in the style`, `catalogue. ${style.descriptor} Its UI style is \`${style.ui}\`.`, "");
   } else if (look.extends) lines.push(`It extends \`${look.extends}\`${how}.`, "");
   else lines.push("It extends no preset yet: the frame is the engine's defaults plus what", "the file sets.", "");
   lines.push(
@@ -481,7 +484,7 @@ Scaffolds an Origin Engine game into dir (default: ./origin-game).
   --name   the game's display name (default: from the id or the directory)
   --id     the game's id, lowercase-hyphen (default: from the name)
   --profile    2d writes the 2D starter (a platformer: sprites, tilemap, 2D physics), 3d the 3D template (default: 2d for a premise that says 2D, platformer, side-scroller, metroidvania or pixel art without saying 3D; else 3d)
-  --archetype  start from a complete archetype game (runner, match3, topdown, tower-defense, roguelike, idle, rhythm, third-person) instead of the template; it has its own profile
+  --archetype  start from a complete archetype game (runner, match3, topdown, tower-defense, roguelike, idle, rhythm, third-person, arena) instead of the template; it has its own profile
   --premise    the game in one line (genre, mood, setting, audience): its look extends the style catalogue's best match (asked for on a terminal when neither this nor --look is given)
   --look   the style catalogue slug the look extends (og-taste §12), such as anime-cel-3d or 16bit-pixel
   --no-prompt  never ask for the premise

package/looks/catalogue.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
-  "about": "Origin Engine's style catalogue: 37 art styles in the engine's own words, each with what a critic checks on a rendered frame, the premises it fits, the look preset it maps to (an .ogt of type look; `extends \"<slug>\"` in a game's own look builds on it), the UI skin pack, palette and asset specs, and an art-bible direction the agent expands per project. `look.support` says how faithfully the engine renders the style today: full (every primitive draws), partial or planned (the primitives in `missing` are still to land), content (the look lives in authored art; the engine frames it). og-taste §12 explains how to use it. The descriptions are original; no game or studio is the reference for a style.",
+  "about": "Origin Engine's style catalogue: 37 art styles in the engine's own words, each with what a critic checks on a rendered frame, the premises it fits, the look preset it maps to (an .ogt of type look; `extends \"<slug>\"` in a game's own look builds on it), the built-in UI style its look's `ui` line names, palette and asset specs, and an art-bible direction the agent expands per project. `look.support` says how faithfully the engine renders the style today: full (every primitive draws), partial or planned (the primitives in `missing` are still to land), content (the look lives in authored art; the engine frames it). og-taste §12 explains how to use it. The descriptions are original; no game or studio is the reference for a style.",
   "categories": {
     "pixel": "Pixel and retro",
     "paint": "Paint and line",
     "shape": "Shape and material",
     "render": "3D rendering"
   },
-  "skins": [
+  "ui": [
     "pixel",
     "cartoon",
     "fantasy",
@@ -15,7 +15,7 @@
     "paper",
     "neon"
   ],
-  "artBibleTemplate": "Art bible for {title}. Premise: {premise}. Camera: {camera}; platform and display size: {platform}. Style: {name} ({descriptor}) Direction: {direction} Palette: {palette}. Asset specs: {assets}. UI: the {skin} skin pack, re-coloured to this palette (og-taste §1). Avoid: {avoid}. Proof: the game's look is assets/looks/{game}.ogt, extending \"{slug}\"; capture the title, play and results screens with og run and check each against: {checks}. Every later asset is made inside this bible; a request for one asset never redesigns the style.",
+  "artBibleTemplate": "Art bible for {title}. Premise: {premise}. Camera: {camera}; platform and display size: {platform}. Style: {name} ({descriptor}) Direction: {direction} Palette: {palette}. Asset specs: {assets}. UI: the {ui} style the preset names (a `ui` line in the game's look picks another, or the game's own styles/<name>/style.ogt), re-coloured to this palette (og-taste §1). Avoid: {avoid}. Proof: the game's look is assets/looks/{game}.ogt, extending \"{slug}\"; capture the title, play and results screens with og run and check each against: {checks}. Every later asset is made inside this bible; a request for one asset never redesigns the style.",
   "styles": [
     {
       "slug": "expressionist-painting",
@@ -47,7 +47,7 @@
           "Stylise.paint* for 3D parts to match the painted art"
         ]
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "free, but 3 to 5 dominant masses per scene",
         "rules": "Complementary clashes in shadows; one dominant temperature per scene; avoid neutral greys."
@@ -96,7 +96,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "20 to 40 colours",
         "rules": "Deep warm or cool shadow colour shared by all materials; accents in one hue family per faction."
@@ -145,7 +145,7 @@
         ],
         "missing": []
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "12 to 24 colours",
         "rules": "Light values dominate; two or three pigments mixed into the rest; no pure black."
@@ -196,7 +196,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "sprites 32 to 64 colours; the set is unconstrained but graded to match",
         "rules": "Grade the 3D set with a LUT towards the sprites' palette so the two read as one world."
@@ -244,7 +244,7 @@
         ],
         "missing": []
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "16 to 32 colours",
         "rules": "Colour per material, gradients only from lighting and fog."
@@ -295,7 +295,7 @@
         ],
         "missing": []
       },
-      "skin": "cartoon",
+      "ui": "cartoon",
       "palette": {
         "size": "warm, slightly desaturated plasticine colours",
         "rules": "Matte surfaces; saturation from the clay, not the light."
@@ -344,7 +344,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "8 to 16 colours",
         "rules": "Ramps of 3 or 4 steps per material; one shared black; no gradients; background colours darker or desaturated against sprites."
@@ -393,7 +393,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "32 to 64 colours (a voxel palette)",
         "rules": "One palette for the whole world; shade by light, not by palette steps."
@@ -444,7 +444,7 @@
           "Stylise.paintCanvas for the vellum grain"
         ]
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "10 to 16 colours",
         "rules": "Parchment ground, iron-gall ink, a few mineral pigments (ultramarine, vermilion, verdigris) and gold."
@@ -495,7 +495,7 @@
           "the look is in frame-by-frame animation (flipbooks); the engine supplies the film treatment"
         ]
       },
-      "skin": "cartoon",
+      "ui": "cartoon",
       "palette": {
         "size": "sepia or muted primaries, 12 to 24 colours",
         "rules": "Inked black lines, flat fills, a warm faded grade over everything."
@@ -544,7 +544,7 @@
         ],
         "missing": []
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "graphite or sepia ramp plus paper, optional single accent",
         "rules": "Value from line density only; the accent marks danger or the goal."
@@ -596,7 +596,7 @@
           "ornament is content; Stylise.depthBands for layered haze"
         ]
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "cool desaturated base with 1 or 2 glowing accents",
         "rules": "Dark blue-grey grounds, pale characters, glows in one hue."
@@ -647,7 +647,7 @@
           "painted backdrops are content; Stylise.paint* for 3D props"
         ]
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "free, organised by warm light and cool shadow",
         "rules": "Saturation highest at the light's edge; value grouping in three planes."
@@ -697,7 +697,7 @@
           "illustration is content; Stylise.ink and paintCanvas"
         ]
       },
-      "skin": "cartoon",
+      "ui": "cartoon",
       "palette": {
         "size": "16 to 32 colours",
         "rules": "Soft saturated hues, coloured line work, patterns from the same palette."
@@ -747,7 +747,7 @@
           "the source paintings and cut-outs are content (public-domain scans or original painting); no engine primitive is missing"
         ]
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "the source paintings' own",
         "rules": "Grade all sources to a common varnish tone with a LUT."
@@ -797,7 +797,7 @@
           "the drawing is content; Stylise.ink can outline 3D props to match"
         ]
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "monochrome ink or 4 to 8 light colours",
         "rules": "White or off-white ground; colour never hides line."
@@ -847,7 +847,7 @@
           "silhouettes are content; Stylise.palette locks the colours"
         ]
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "2 to 4 colours",
         "rules": "Ochre ground, black figures, a lighter line colour, optional red-brown."
@@ -896,7 +896,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "muted 12 to 24 colours plus black",
         "rules": "Desaturated mid-tones, black for every shadow, one blood or fire accent."
@@ -945,7 +945,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "2 colours plus at most 1 accent",
         "rules": "Pick ink and paper first; shading only through dither or pattern; the accent means one thing."
@@ -994,7 +994,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "32 to 64 colours",
         "rules": "Ramps of 4 to 6 steps; hue-shifted shadows (cooler) and highlights (warmer); saturated accents on characters, calmer backgrounds."
@@ -1044,7 +1044,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "48 to 128 colours",
         "rules": "Long hue-shifted ramps; a value plan per scene that keeps the play area mid-value and the foreground darkest."
@@ -1094,7 +1094,7 @@
         ],
         "missing": []
       },
-      "skin": "neon",
+      "ui": "neon",
       "palette": {
         "size": "24 to 48 colours",
         "rules": "A near-black ground with two or three saturated light hues; no mid-grey fills; accents reserved for interactables."
@@ -1143,7 +1143,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "32 to 64 colours",
         "rules": "Floors desaturated and mid-value; walls darker on their faces; characters most saturated."
@@ -1194,7 +1194,7 @@
         ],
         "missing": []
       },
-      "skin": "scifi",
+      "ui": "scifi",
       "palette": {
         "size": "free, but posterised to 32 levels per channel",
         "rules": "Fog colour equals the clear colour; dithered gradients."
@@ -1242,7 +1242,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "6 to 16 colours",
         "rules": "Each scene has one dominant mass colour; detail colour only where the eye should go."
@@ -1293,7 +1293,7 @@
         ],
         "missing": []
       },
-      "skin": "neon",
+      "ui": "neon",
       "palette": {
         "size": "24 to 48 colours",
         "rules": "Two tones per material (lit, shadow) with hue-shifted shadows; highlights as shapes."
@@ -1344,7 +1344,7 @@
         ],
         "missing": []
       },
-      "skin": "scifi",
+      "ui": "scifi",
       "palette": {
         "size": "free, saturated",
         "rules": "Bold local colours, black ink for all shadow edges."
@@ -1394,7 +1394,7 @@
         ],
         "missing": []
       },
-      "skin": "paper",
+      "ui": "paper",
       "palette": {
         "size": "8 to 16 colours",
         "rules": "Colours of real paper stock: muted, slightly warm; white is off-white."
@@ -1444,7 +1444,7 @@
         ],
         "missing": []
       },
-      "skin": "cartoon",
+      "ui": "cartoon",
       "palette": {
         "size": "soft pastel 24 to 48 colours",
         "rules": "Bright but slightly desaturated; warm sunlight, cool shadows."
@@ -1494,7 +1494,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "free, harmonised by a LUT",
         "rules": "Two or three dominant hues per area; graded towards them."
@@ -1546,7 +1546,7 @@
         ],
         "missing": []
       },
-      "skin": "scifi",
+      "ui": "scifi",
       "palette": {
         "size": "free, graded",
         "rules": "One grade per area; avoid oversaturation; skin tones protected."
@@ -1597,7 +1597,7 @@
         ],
         "missing": []
       },
-      "skin": "scifi",
+      "ui": "scifi",
       "palette": {
         "size": "greys and one accent",
         "rules": "Desaturated everything; the accent is red or warm light only where the story points."
@@ -1646,7 +1646,7 @@
         ],
         "missing": []
       },
-      "skin": "neon",
+      "ui": "neon",
       "palette": {
         "size": "1 hue in 4 to 6 values, or black plus a gradient sky",
         "rules": "Value steps per layer; colour only in the far layers or a single accent."
@@ -1695,7 +1695,7 @@
         ],
         "missing": []
       },
-      "skin": "neon",
+      "ui": "neon",
       "palette": {
         "size": "3 to 6 colours",
         "rules": "One ground, one figure colour, one accent; contrast by hue and value."
@@ -1746,7 +1746,7 @@
         ],
         "missing": []
       },
-      "skin": "neon",
+      "ui": "neon",
       "palette": {
         "size": "black plus 2 to 4 saturated hues",
         "rules": "Each hue one meaning (player, enemy, pickup); white only for the hottest centres."
@@ -1795,7 +1795,7 @@
         ],
         "missing": []
       },
-      "skin": "pixel",
+      "ui": "pixel",
       "palette": {
         "size": "2 to 4 colours",
         "rules": "Ink and paper, optionally one mid-tone and one accent."
@@ -1846,7 +1846,7 @@
         ],
         "missing": []
       },
-      "skin": "fantasy",
+      "ui": "fantasy",
       "palette": {
         "size": "dark cool masses plus warm luminous accents",
         "rules": "Value structure first: dark foreground, mid play plane, glowing background."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origingame/create-game",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Scaffolds an Origin Engine game from the project template: npm create @origingame/game.",
   "license": "MIT",
   "repository": {
@@ -29,6 +29,6 @@
   ],
   "scripts": {
     "prepack": "bun scripts/pack-template.ts",
-    "test": "bun test ${OG_BUN_TEST_TIMEOUT:+--timeout=$OG_BUN_TEST_TIMEOUT} tests/"
+    "test": "bun scripts/pack-template.ts && bun test ${OG_BUN_TEST_TIMEOUT:+--timeout=$OG_BUN_TEST_TIMEOUT} tests/"
   }
 }

package/template/README.md

@@ -8,7 +8,7 @@ through the wall, raises the alarm, chases, searches and goes back.
 
 ```sh
 og run .     # headless with the probe; og dev . reloads on save
-og test .    # tests/smoke.og.ts and tests/guard.og.ts
+og test .    # tests/smoke.og.ts, tests/guard.og.ts and tests/intro.og.ts
 og polish .  # the taste and feel scores of those playtests
 og build .   # the play page
 ```
@@ -25,6 +25,7 @@ og build .   # the play page
 | Every word the menu shows from a string table, the base one in the source language | `assets/strings/en.ogt`, `Menu` | og-i18n §1, §2 |
 | A guard as data: a state machine on og.ai, a navmesh cooked from the yard, sight cones against the wall | `assets/ai/guard.ogt`, `assets/nav/yard.ogt` | og-ai §1–§5 |
 | Commands with their usage in `help`, facts for playtests | `commands`, `commandHelp`, `facts` | og-game §3; og-build §1 |
+| A cutscene as data: a camera on a rail, the trickster's clips and walk, narration from an `.srt`, sounds, an event key running `spawn_wave`, fades and markers, played by `timeline:play:intro` | `assets/timelines/intro.ogt`, `narration.srt`, `tests/intro.og.ts` | og-game §9 "Cutscenes" |
 | Playtests that assert on dumps and facts, never on the code | `tests/` | og-build §3, §4 |
 
 `og polish .` (2026-10-19): taste 100, feel 87 (tests/evidence/E7/polish/

package/template/assets/audio/sting.ogt

@@ -0,0 +1,10 @@
+type sfx
+version 1
+---
+# The intro's music (timelines/intro.ogt's music track): a level-up
+# jingle looped under the drop, faded in and out by the timeline.
+preset "levelup"
+seed 0
+pitch 1
+length 1
+volume 1