@origingame/create-game 0.1.1 → 0.3.0

package/bin/create.ts

@@ -2,13 +2,16 @@
 // `npm create @origingame/game` (and `bun create`): scaffolds the Origin
 // Engine project template (templates/game) into a directory, naming the game.
 //
-//   create [dir] [--name "Name"] [--id slug] [--archetype runner|match3|...]
+//   create [dir] [--name "Name"] [--id slug] [--profile 2d|3d] [--archetype runner|match3|...]
 //          [--premise "one line"] [--look <slug>] [--force]
 //
-// The template comes from ./template/ in the published package (prepack:
-// scripts/pack-template.ts) or ../../templates/game in the engine repository;
-// an archetype (a complete small game to start from) from ./archetypes/<name>/
-// or ../../templates/archetypes/<name>/.
+// The template comes from ./template/ (the 3D template, templates/game) or
+// ./template-2d/ (the 2D starter, templates/game-2d) in the published
+// package (prepack: scripts/pack-template.ts), or from ../../templates/ in
+// the engine repository; an archetype (a complete small game to start from)
+// from ./archetypes/<name>/ or ../../templates/archetypes/<name>/. The 2D
+// starter is written for --profile 2d, or for a premise that says 2D
+// (platformer, side-scroller, metroidvania, pixel art) without saying 3D.
 //
 // Every game gets its look, `assets/looks/<id>.ogt`, named by GameDesc.look
 // in the entry: it extends the style catalogue's preset given by --look, or
@@ -44,8 +47,10 @@ 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;
   /** The template directory; found next to this file when omitted. */
   readonly template?: string;
   /** A style catalogue slug the game's look extends (og-taste §12). */
@@ -68,11 +73,22 @@ export interface CreatedLook {
   readonly chosen: "flag" | "premise" | "template" | "none";
 }
 
+/** A project's profile (`project.ogt`'s `profile` line): 2D or 3D. */
+export type Profile = "2d" | "3d";
+
+/** The profile the game was written in, and how it was chosen. */
+export interface CreatedProfile {
+  readonly value: Profile;
+  /** `flag` for --profile, `premise` for a premise that says 2D, `archetype` for an archetype's own, `template` for the 3D template by default. */
+  readonly chosen: "flag" | "premise" | "archetype" | "template";
+}
+
 export interface Created {
   readonly dir: string;
   readonly name: string;
   readonly id: string;
   readonly files: readonly string[];
+  readonly profile: CreatedProfile;
   readonly look: CreatedLook;
   /** What the game's author should know, such as reference frames a look will move. */
   readonly notes: readonly string[];
@@ -86,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. */
@@ -164,8 +180,30 @@ function title(id: string): string {
     .join(" ");
 }
 
-/** The template this copy of the package scaffolds. */
-export function templateDir(archetype?: string): string {
+/** Words of a premise that say the game is 2D (platformer, side-scroller, metroidvania, pixel art, sprites, tiles). */
+const TWO_D = new Set(["platformer", "platforming", "side-scroller", "side-scrolling", "sidescroller", "sidescrolling", "scroller", "metroidvania", "pixel", "pixel-art", "pixelart", "sprite", "tilemap", "tile", "8bit", "16bit", "1bit"]);
+const THREE_D = new Set(["third-person", "first-person", "fps", "voxel", "lowpoly", "low-poly"]);
+
+/**
+ * The profile a premise asks for: `2d` when it uses a 2D word (TWO_D, or
+ * `2D` itself) and no 3D word (THREE_D, or `3D`), else null: the template's
+ * own, 3D, applies.
+ */
+export function premiseProfile(premise: string): Profile | null {
+  const asked = new Set(words(premise));
+  const says = (w: string) => new RegExp(`(^|[^a-z0-9])${w}($|[^a-z0-9])`, "i").test(premise);
+  if (says("3d") || [...THREE_D].some((w) => asked.has(w))) return null;
+  return says("2d") || [...TWO_D].some((w) => asked.has(w)) ? "2d" : null;
+}
+
+/** The `profile "2d"` line of a project manifest; `3d` when it has none. */
+function profileOf(dir: string): Profile {
+  const m = /^profile[ \t]+"(2d|3d)"/m.exec(readFileSync(join(dir, "project.ogt"), "utf8"));
+  return m?.[1] === "2d" ? "2d" : "3d";
+}
+
+/** The template this copy of the package scaffolds: the archetype's, or the project template of a profile (3D unless `2d`). */
+export function templateDir(archetype?: string, profile: Profile = "3d"): string {
   const here = dirname(fileURLToPath(import.meta.url));
   if (archetype !== undefined) {
     const roots = [join(here, "..", "archetypes"), join(here, "..", "..", "..", "templates", "archetypes")];
@@ -175,10 +213,15 @@ export function templateDir(archetype?: string): string {
     const known = roots.filter(existsSync).flatMap((r) => readdirSync(r).filter((d) => existsSync(join(r, d, "project.ogt"))));
     throw new Error(`no archetype '${archetype}': choose one of ${[...new Set(known)].sort().join(", ") || "(none shipped)"}`);
   }
-  for (const candidate of [join(here, "..", "template"), join(here, "..", "..", "..", "templates", "game")]) {
+  const packed = profile === "2d" ? "template-2d" : "template";
+  const source = profile === "2d" ? "game-2d" : "game";
+  // 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 project template next to ${here}: expected ../template (published package) or ../../../templates/game (engine repository)`);
+  throw new Error(`no ${profile} project template next to ${here}: expected ../${packed} (published package) or ../../../templates/${source} (engine repository)`);
 }
 
 function ogtString(value: string): string {
@@ -241,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.");
@@ -269,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(
@@ -322,8 +365,16 @@ export function create(options: CreateOptions): Created {
       throw new Error(`${dir} is not empty; pick an empty directory, or pass --force to write the template over it`);
     }
   }
+  if (options.profile !== undefined && options.archetype !== undefined) {
+    throw new Error(`--profile and --archetype together: an archetype has its own profile (${options.archetype}); drop one`);
+  }
   const choice = chooseStyle(options);
-  const template = options.template ?? templateDir(options.archetype);
+  const asked = options.profile ?? (options.premise !== undefined ? premiseProfile(options.premise) : null);
+  const template = options.template ?? templateDir(options.archetype, asked ?? "3d");
+  const profile: CreatedProfile = {
+    value: profileOf(template),
+    chosen: options.archetype !== undefined ? "archetype" : options.profile !== undefined ? "flag" : asked !== null ? "premise" : "template",
+  };
   const list = files(template);
   const written: string[] = [];
   mkdirSync(dir, { recursive: true });
@@ -342,7 +393,7 @@ export function create(options: CreateOptions): Created {
     writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
   }
   const { look, notes } = writeLook(dir, name, id, choice, written);
-  return { dir, name, id, files: written, look, notes };
+  return { dir, name, id, files: written, profile, look, notes };
 }
 
 /**
@@ -427,12 +478,13 @@ function writeLook(dir: string, name: string, id: string, choice: ReturnType<typ
   return { look, notes };
 }
 
-const USAGE = `usage: create [dir] [--name "Name"] [--id slug] [--archetype name] [--premise "one line"] [--look slug] [--force]
+const USAGE = `usage: create [dir] [--name "Name"] [--id slug] [--profile 2d|3d] [--archetype name] [--premise "one line"] [--look slug] [--force]
 
 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)
-  --archetype  start from a complete archetype game (runner, match3, topdown, tower-defense, roguelike, idle, rhythm, third-person) instead of the template
+  --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, 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
@@ -444,6 +496,7 @@ function main(argv: string[]): number {
   let id: string | undefined;
   let force = false;
   let archetype: string | undefined;
+  let profile: Profile | undefined;
   let premise: string | undefined;
   let look: string | undefined;
   let ask = true;
@@ -458,7 +511,11 @@ function main(argv: string[]): number {
     else if (a === "--id") id = value();
     else if (a === "--force") force = true;
     else if (a === "--archetype") archetype = value();
-    else if (a === "--premise") premise = value();
+    else if (a === "--profile") {
+      const v = value();
+      if (v !== "2d" && v !== "3d") throw new Error(`--profile ${v}: use 2d or 3d. ${USAGE}`);
+      profile = v;
+    } else if (a === "--premise") premise = value();
     else if (a === "--look") look = value();
     else if (a === "--no-prompt") ask = false;
     else if (a === "-h" || a === "--help") {
@@ -476,13 +533,16 @@ function main(argv: string[]): number {
     ...(name ? { name } : {}),
     ...(id ? { id } : {}),
     ...(archetype ? { archetype } : {}),
+    ...(profile ? { profile } : {}),
     ...(premise ? { premise } : {}),
     ...(look ? { look } : {}),
     force,
   });
   const shown = relative(process.cwd(), made.dir) || ".";
   const style = made.look.extends ? `extends ${made.look.extends}${made.look.chosen === "premise" ? " (from the premise)" : made.look.chosen === "flag" ? " (--look)" : ""}` : "extends no preset";
+  const how = { flag: " (--profile)", premise: " (from the premise)", archetype: ` (the ${archetype} archetype's)`, template: "" }[made.profile.chosen];
   console.log(`Created ${made.name} (${made.id}) in ${shown}: ${made.files.length} files.
+Profile: ${made.profile.value}${how}.
 Look: ${made.look.file}, ${style}; README.md says how to change it.${made.notes.map((n) => `\nNote: ${n}`).join("")}
 
 Next:

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,16 +1,16 @@
 {
   "name": "@origingame/create-game",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Scaffolds an Origin Engine game from the project template: npm create @origingame/game.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/fran0220/origin-engine.git",
+    "url": "git+https://github.com/originai-game/origin-engine.git",
     "directory": "packages/create"
   },
-  "homepage": "https://github.com/fran0220/origin-engine#readme",
+  "homepage": "https://github.com/originai-game/origin-engine#readme",
   "bugs": {
-    "url": "https://github.com/fran0220/origin-engine/issues"
+    "url": "https://github.com/originai-game/origin-engine/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -22,6 +22,7 @@
   "files": [
     "bin",
     "template",
+    "template-2d",
     "archetypes",
     "looks",
     "README.md"

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