@@ -0,0 +1,72 @@
+# GTA V 3D presentation game
+
+Select the GTA theme, then **Start heist**. The previous 2D Bay Area game
+has been removed. Its replacement is a browser-scale custom city sandbox,
+not the complete GTA V product or campaign.
+
+## Playable city
+
+The custom district has a connected street grid, buildings, a waterfront,
+park, decorative amusement pier, and street furniture. Four selectable GTA V
+cars (Adder, Buffalo, Blista, Taxi) share the roads with 18 traffic vehicles.
+The Michael model represents the player on foot and background pedestrians.
+The police model represents pursuers. Geometry and available textures are
+reused; missing shared texture dictionaries receive explicit material tints.
+The character export has no skeleton or animation clips. A custom runtime
+skin rig adds distance-driven walking and sprinting, knee bends and opposing
+arm swings. It settles when stopped, freezes when paused and gives background
+pedestrians independent strides. These are original procedural animations,
+not GTA V's animation clips.
+
+Pick up four packages in order, then deliver at the garage. Stop within the
+gold ring and press E. Pickups and vehicle collisions raise a wanted level;
+stay at least 110 m from every pursuer for 15 seconds to escape. The garage
+repairs a stationary vehicle. A run ends on delivery, zero health, or eight
+minutes elapsed. Cash and progress are in-memory and reset on closing.
+
+- WASD/arrows: drive or walk.
+- Space: brake; Shift: sprint on foot.
+- F: exit a stationary car or reenter within five metres.
+- E: collect/deliver; C: chase/close camera; P: pause; M: map.
+- Buttons: change a stationary car, day/night, sound, restart.
+- Touch: hold steering and pedals simultaneously; use the action buttons.
+- Blur, hidden tab and map opening pause the simulation. Escape closes the
+  dialog and restores launcher focus.
+
+## San Andreas flight
+
+The flight button separately loads a low-detail San Andreas model containing
+the source terrain/building meshes and a Frogger helicopter model. This is an aerial explorer:
+W/S moves, A/D turns, Shift climbs and Space descends. Height is clamped above
+the terrain. It has no aircraft physics, on-ground missions, traffic, or
+interiors. Returning restores the paused custom-city run.
+
+The source model is not a substitute for GTA V's full streamed world.
+The city sandbox's street layout, buildings, mission system and physics are
+custom work and are not extracted GTA V gameplay.
+
+## Resource and SEO boundaries
+
+The existing optional-theme lazy boundary is retained. The dialog, Three.js,
+game CSS and models are requested only after launch. Selecting GTA alone
+does not download the game models. The map is another on-demand download.
+Closing aborts fetches, removes input and resize handlers, disposes geometry,
+materials/textures and the WebGL context, and closes synthesized engine audio.
+No external requests, persistence, or telemetry of player movement is added.
+
+No indexable page, metadata, canonical, hreflang, structured data, benchmark
+filter, numerical transformation, or API is changed. This is the documented
+presentation-only exclusion from API and `inferencex-skills` coverage.
+
+## Implementation
+
+- `gta-world.ts`: city geometry and street/traffic paths.
+- `gta-engine.ts`: deterministic simulation, missions and state transitions.
+- `gta-renderer.ts`: asset loading, instanced scenery and disposal.
+- `gta-game.tsx`: bilingual controls, accessibility and lifecycle.
+- `gta-engine.test.ts`: driving, collision, missions, pause, flight and reset-state tests.
+- `cypress/component/gta-heist.cy.tsx`: integrated controls and Chinese UI.
+- Existing optional-theme isolation and sanity specs remain the integration guards.
+
+Asset provenance, processing and permission limitations are recorded in
+`packages/app/public/decorative/gta/models/README.md`.
@@ -4,7 +4,8 @@ Design rationale and non-obvious conventions. See [CLAUDE.md](../CLAUDE.md) for
 
 ## Docs
 
-- [Presentation Themes](./themes.md): light/dark persistence, retired-theme reset, icon-only theme picker, and presentation-only API exclusion.
+- [Presentation Themes](./themes.md): Minecraft activation and assets, CS:GO, GTA and Halo styling, Halo theme music, icon-only theme picker, dark-chart/export integration, and presentation-only API exclusion.
+- [Playable Minecraft](./minecraft-game.md): the opt-in game launched from the Minecraft theme, controls, saves, lifecycle and verification.
 
 - [Dashboard Read-only Views](./dashboard-readonly-views.md): API/filter inventory, source audit and verification scope
 - [Pareto Boundary API](./pareto-api.md): Query frontier and hinterland observations, preserve provenance, and distinguish API scope from chart highlights.
 
@@ -0,0 +1,96 @@
+# Mario Kart theme and 3D race
+
+Select **Mario Kart** (the flag icon) in the theme picker, then **Race in 3D**.
+The theme uses a local rendered Luigi Circuit backdrop and the existing dark
+chart palettes. The game is imported only after pressing its launcher.
+
+## Play
+
+Pick one of eight racers (Mario, Luigi, Peach, Daisy, Yoshi, Toad, Donkey Kong,
+Bowser) and an engine class (50cc, 100cc, 150cc), then race three laps of Luigi
+Circuit against the other seven. Light racers accelerate and drift harder,
+heavy racers have the highest top speed and win collisions.
+
+There is no assisted steering. The kart goes where it points: holding
+accelerate alone drives straight into the first wall. Collision, walls, curbs,
+offroad, sand, and water come from a surface map rasterized from the course's
+own collision materials, so cutting across grass is slower and falling into
+the water brings out Lakitu to put you back on the road.
+
+| Control                    | Action                                                   |
+| -------------------------- | -------------------------------------------------------- |
+| W / ↑                      | Accelerate                                               |
+| S / ↓                      | Brake, then reverse                                      |
+| A D / ← →                  | Steer                                                    |
+| Space (or X)               | Hop; hold while steering to drift                        |
+| Shift / E                  | Use item. Hold to drag bananas or shells behind the kart |
+| S while releasing the item | Throw shells and Bob-ombs backward                       |
+| C                          | Look back                                                |
+| P                          | Pause                                                    |
+
+Drifting charges blue then orange sparks; releasing gives a mini-turbo or super
+mini-turbo. Pressing accelerate just after the 2 in the countdown gives a rocket
+start; pressing too early burns out. Following close behind another racer
+builds a slipstream.
+
+The nine boost panels on the final banked bend give a one-second boost on
+contact. Banking is drivable terrain, not a vertical barrier. Drift steering
+uses speed-dependent handling so ordinary bends allow natural blue/orange
+charge; a low-speed hop held through acceleration can also enter a drift.
+
+Item boxes sit in three rows around the course. The roulette lands on an item
+weighted by position, as in the original: front runners mostly see bananas and
+green shells, back markers see stars, triple mushrooms, Golden Mushrooms, and
+lightning. Items: Mushroom, Triple Mushroom, Golden Mushroom, Banana, Triple
+Banana, Green Shell, Triple Green Shells, Red Shell (homes on the racer ahead),
+Star, Bob-omb, and Lightning (shrinks every rival and takes their items).
+CPU racers use the same controls and items, drift for mini-turbos, avoid
+hazards, back out after hitting walls, and use mild rubber-banding.
+
+The HUD shows position, lap, race time, the item slot and roulette, live
+standings with racer icons, a course minimap with racers, boxes, and
+projectiles, speed, drift spark stage, and final lap and wrong way banners.
+Lakitu runs the start lights, shows the reverse sign, and waves the finish
+flag. The results card lists every racer's time (projected for racers still
+on course) and your lap splits.
+
+P pauses from the driving canvas. Window blur and hidden tabs pause the
+simulation. Touch controls (←, →, Drift, Item, Brake, Accelerate) support
+simultaneous presses. Escape closes the dialog and returns focus to the
+launcher. Sound is synthesized with WebAudio after Start; Mute toggles it.
+
+## Assets and scope
+
+The track, all eight racers, the Standard Kart, items, item boxes, and Lakitu
+use actual Mario Kart Wii model/texture assets, converted for WebGL. See the [asset provenance and reported permission](../packages/app/public/decorative/kart/README.md).
+This is an original arcade simulation using those assets, not a port of Mario
+Kart Wii. There is no Nintendo game code, audio, multiplayer, or leaderboard.
+
+Both English and Chinese UI use the same implementation. Embedded charts
+suppress the theme artwork and launcher. Other themes request no kart assets.
+Closing the game disposes its GPU resources and listeners, and aborts pending
+asset downloads. WebGL/asset failures offer Retry; retry creates a new canvas.
+Reduced-motion settings disable camera easing, shake, particles, and boost FOV changes.
+
+## Data/API coverage exclusion
+
+This is an optional presentation theme and game, with no new route or data
+view. It changes no benchmark filters, model selection, metrics, calculations,
+share parameters, or returned data. It therefore uses the presentation-only
+exclusion from API and `@semianalysisai/inferencex-skills` parity. Official
+and unofficial overlays retain the same dark palette and data semantics.
+
+## Verification
+
+- Engine tests (on the real surface map): countdown, throttle-only does not
+  finish, a steering driver finishes, all CPU racers finish, steering, offroad,
+  braking/reverse, drift stages and mini-turbo, rocket start and burnout, item
+  boxes and roulette, mushroom, banana, green and red shells, star, lightning,
+  Golden Mushroom, pause, and standings.
+- Theme tests: picker registry, shared chart classification/palette, lazy
+  decoration activation, cleanup, and embed suppression.
+- `cypress/e2e/kart-mode.cy.ts`: actual theme selection, asset isolation,
+  on-demand launch, Escape/focus restoration, persistence, and Chinese mobile UI.
+- Development builds expose `render_game_to_text()`, `advanceTime(ms)`, and `kart_race()`.
+  The latter switches off the wall-clock simulation to avoid double stepping.
+  Production builds do not expose those hooks.
@@ -0,0 +1,140 @@
+# Playable Minecraft
+
+Select **Minecraft** in the theme picker, then **Play Minecraft** in the banner
+under the header. The game opens in a dialog and is imported only after the
+button is pressed; the dashboard, charts and data are unchanged.
+
+## What is in the game
+
+- Title screen with the rotating vanilla panorama, splash text, Singleplayer,
+  Options and Quit. Singleplayer lists saved worlds (play, delete, create).
+- Create New World: name, seed (text seeds are hashed like vanilla), Survival or
+  Creative, and Peaceful/Easy/Normal/Hard difficulty.
+- Infinite, seeded terrain in 16×16×128 chunks streamed around the player:
+  plains, forest, birch forest, taiga, snowy, desert, mountains, ocean, beach
+  and river biomes, caves, coal/iron/gold/redstone/lapis/diamond ores in
+  depth bands, deepslate, bedrock, oak/birch/spruce trees, cacti, sugar cane,
+  flowers, grass and lakes. The same seed always produces the same world.
+- 85 blocks and 149 items with the vanilla textures, 74 crafting recipes
+  (2×2 inventory grid and 3×3 crafting table, shaped and shapeless, tag
+  ingredients such as any planks) and 20 furnace recipes with fuel burn times.
+- Survival rules: vanilla mining times by hardness, tool kind and tier,
+  harvest gating (stone needs a pickaxe, iron ore a stone pickaxe, diamond an
+  iron pickaxe), tool durability, item drops and pickup, health, hunger,
+  saturation and eating, fall, drowning, lava, fire, cactus and mob damage,
+  death screen and respawn, and experience levels.
+- Creative: instant breaking, flight (double-tap Space), the creative item
+  grid with search, and middle-click pick block.
+- Sky and sky-light and block-light (torches, glowstone, lava, furnaces)
+  with smooth lighting and ambient occlusion, day/night cycle with sun, moon,
+  stars and moving clouds, fog, flowing water and lava with source blocks,
+  water + lava making obsidian/cobblestone, falling sand and gravel, crop
+  growth, saplings growing into trees, TNT, doors, ladders, chests and furnaces.
+- Mobs with vanilla models and skins: zombies, skeletons (arrows) and creepers
+  (explosions) spawn in the dark on Easy and above; pigs, cows, sheep (shearing
+  and wool) and chickens spawn with the terrain and drop food.
+- HUD: hotbar, hearts, hunger, air bubbles, experience bar and level, held item
+  name, chat, F3 debug screen, F1 hide HUD, F5 first-person/back/front camera
+  with the player model.
+- Inventory, crafting table, furnace, chest and creative screens with vanilla
+  slot behavior: left/right click, shift-click transfer, drag to split evenly
+  or place one each, double-click collect, number keys to swap with the hotbar,
+  Q to drop, and tooltips.
+- Chat commands: `/gamemode`, `/time`, `/tp`, `/give`, `/summon`, `/kill`,
+  `/difficulty`, `/seed`, `/spawnpoint`, `/clear`, `/help`.
+- Options: FOV, render distance, mouse sensitivity, GUI scale, brightness,
+  volume, view bobbing and clouds. Settings persist in
+  `localStorage` (`inferencex-minecraft-options`).
+- Sounds from the vanilla asset index for digging, steps, mobs, explosions,
+  doors, chests and UI clicks, gated by the theme's existing sound toggle.
+
+## Controls
+
+| Input                   | Action                                           |
+| ----------------------- | ------------------------------------------------ |
+| Click the world         | Capture the mouse                                |
+| Mouse                   | Look                                             |
+| W A S D                 | Move                                             |
+| Space                   | Jump; swim up; double-tap to fly in Creative     |
+| Shift                   | Sneak; fly down                                  |
+| R, Ctrl or double-tap W | Sprint                                           |
+| Left click (hold)       | Mine or attack                                   |
+| Right click             | Place, use, eat, open containers                 |
+| Middle click            | Pick block                                       |
+| 1-9 or wheel            | Select hotbar slot                               |
+| E                       | Inventory                                        |
+| Q                       | Drop item (Ctrl+Q drops the stack)               |
+| T or /                  | Chat and commands                                |
+| F1 / F3 / F5 (or V)     | Hide HUD / debug screen / camera                 |
+| Escape                  | Close a screen, pause; on the title screen, exit |
+
+Touch devices get a movement stick (push fully forward to sprint), a look area
+(drag to look, tap to place or use, hold to mine or attack), Jump and Sneak
+buttons, a tappable hotbar, and on-screen menu buttons.
+
+## Lifecycle
+
+- `MinecraftPlayBanner` (in `minecraft-theme.tsx`) renders the launcher and
+  dynamically imports `components/minecraft/game/minecraft-game-dialog.tsx`.
+  The game code, CSS, textures, models and sounds are not requested until the
+  button is pressed. Light, dark and the other themes request none of it.
+- Worlds save to `localStorage` every 30 seconds, on pause, on Save and Quit,
+  and when the dialog closes: the index is `inferencex-minecraft-worlds` and each
+  world is `inferencex-minecraft-world-<id>`. Only edited blocks are stored
+  (terrain regenerates from the seed), plus player state, inventory, entities,
+  chests and furnaces. A full or disabled storage shows a chat warning.
+- Escape is routed through the game first: it closes open screens and toggles
+  the pause menu while playing, and closes the dialog only from the title
+  screen. Focus returns to the launcher. Closing stops the render loop, releases
+  the pointer lock, disposes WebGL resources and removes listeners.
+- The world renders with three.js using a single texture atlas, per-chunk
+  meshes with cutout and translucent passes, and a fixed 20 Hz simulation tick
+  with render interpolation.
+- Embedded views hide the launcher, as with the other theme banners.
+
+## Source layout
+
+`packages/app/src/components/minecraft/game/`:
+
+| File                 | Responsibility                                                     |
+| -------------------- | ------------------------------------------------------------------ |
+| `mc-blocks.ts`       | Block registry: textures, hardness, tools, light, shapes, sounds   |
+| `mc-items.ts`        | Items, tools, food, fuel, recipes, smelting and mining time        |
+| `mc-noise.ts`        | Seed hashing, PRNG and simplex noise                               |
+| `mc-world.ts`        | Terrain generation, chunks, lighting and fluids                    |
+| `mc-physics.ts`      | AABB collision, movement, raycasts                                 |
+| `mc-game.ts`         | Game rules, player, mobs, containers, commands, ticks              |
+| `mc-mesher.ts`       | Chunk meshing with smooth light and ambient occlusion              |
+| `mc-models.ts`       | Vanilla entity box models and poses                                |
+| `mc-renderer.ts`     | three.js scene, sky, particles, entities, first/third person views |
+| `mc-audio.ts`        | Sound playback                                                     |
+| `mc-save.ts`         | World serialization and `localStorage`                             |
+| `mc-ui.tsx`          | HUD, screens, item icons, buttons, sliders, panorama               |
+| `minecraft-game.tsx` | Phases, menus, input, loop and overlays                            |
+| `mc-atlas.ts`        | Generated atlas, icon and sound tables                             |
+
+`packages/app/scripts/build-minecraft-game-assets.py` rebuilds the atlases, GUI
+textures, panorama and sounds from a client jar, a 1.20.1 jar (classic entity
+skin layouts) and the launcher asset index. See
+`packages/app/public/decorative/minecraft/game/README.md` for provenance.
+
+## Data/API coverage exclusion
+
+This is an optional presentation feature with no new route or data view. It
+changes no benchmark filters, model selection, metrics, calculations, share
+parameters, or returned data. It therefore uses the presentation-only
+exclusion from API and `@semianalysisai/inferencex-skills` parity.
+
+## Verification
+
+- `mc-game.test.ts`: deterministic generation, bedrock and ores, lighting,
+  crafting (shaped, shifted, shapeless, 3×3 only), smelting, vanilla mining
+  times and harvest tiers, gravity and collision, raycasts, drops and pickup,
+  placement, inventory clicks and drag distribution, furnace smelting, fluids
+  and obsidian/cobblestone, fall damage, death and respawn, commands, mob
+  determinism and save round trips.
+- `cypress/e2e/minecraft-game.cy.ts`: asset isolation on light and dark, launch
+  from the theme, world creation, Escape to pause, Save and Quit, Escape closing
+  the dialog with focus restored, and the Chinese mobile launcher.
+- Development builds expose `render_game_to_text()` and `mc_debug()`; production
+  builds do not.