# screens — everything the player reads
Two screens, both owned by the **Screens** component (which the slice's module
spawns on every scene load — a UI needs a persistent owner for its callbacks):
| Screen | Shows |
|---|---|
| `mko_menu` | The title, the CONTROLES window, and the circuit select. |
| `mko_hud` | The lap/point counter, the millisecond timer, the item slot, the countdown, and the finish card. |
## The flow
```
title --J--> controles --Comenzar/J--> select --a circuit--> countdown --> race --> finish
```
**J** advances (its own `menu.inputMap`), and every button is a real click
target: `comenzar`, `pick_cheep`, `pick_mumu`, `pick_arcoiris`, `again`.
Choosing a circuit calls `Core.selectCircuit(id)` + `Core.beginRace()`; the
tracks lay the circuit and the kart is placed on its line. The menu screen is
hidden and its scheme released while the race runs, and the HUD takes over.
The menu map deliberately does **not** suppress the driving scheme: the kart
already ignores the wheel unless a race is on, so a menu that is up can never be
a kart that cannot move.
## Look
The palette of `design/references/02-title-screen.png`: a blue title bar, white
panels, chunky type, and an orange **COMENZAR** button, with the type over the
live world rather than over a flat colour.
## API
```lua
local S = Core.system("screens")
S.show("title" | "controls" | "select")
S.view() -- which page is up
```
# core
The shared contract of **Mario Kart OrigoZ**. Every slice reads its rules
here, so no slice hard-codes a number that belongs to the game.
`require("game.core")` from anywhere in this world.
## What it holds
| Field | What it is |
|---|---|
| `TITLE`, `PROMPT`, `ART` | The game's name, the *pulsa J para jugar* prompt, and the art-direction sentence — word for word from the reference pass, reused by every prompt. |
| `CIRCUITS` | The three circuits: id, name, laps, layout (`ring` / `square` / `ribbon`), racing surface, what lies beyond the edges, and half-width. |
| `KART` | How a kart feels: max speed, acceleration, braking, turn rates, hop and gravity, drift multipliers, trick spin. |
| `SURFACE` | What each surface does to you: `road` 100%, `water` 75%, `grass` 50%, `space` falls. |
| `SPARK` | The drift charge table: blue at 1.0s (0.5s boost), orange at 2.5s (1.25s), rainbow at 4.0s (2.5s). |
| `BOOST` | Trick 0.75s, mushroom 2.0s, feather 2.0s. |
| `ITEMS` | Crate respawn (8s) and the mushroom / feather odds. |
| `RESCUE` | How Lakitu puts you back: drop height, lift speed, lift duration. |
| `PHASE`, `flow`, `race` | The flow state machine and the live race clock. |
| `records` | The best time on each circuit, kept in `runtime_data.world` — shared and durable. |
## API
- `M.circuits()`, `M.circuit(id)`, `M.circuitIndex(id)`
- `M.register(name, api)` / `M.system(name)` — how slices reach each other
- `M.on(name, fn)` / `M.emit(name, payload)` — the slices' event bus
(`phase`, `circuit`, `lap`, `crate`, `boost`, `rescue`, `finish`)
- `M.setPhase(p)`, `M.selectCircuit(id)`, `M.openControls()`, `M.beginRace()`,
`M.startRace()`, `M.tick(dt)`, `M.reachPoint(total)`, `M.finishRace()`
- `M.records.get(id)` / `M.records.set(id, ms)` / `M.records.all()`
- `M.formatTime(ms)` → `"00:45.678"`, `M.countdownLabel(seconds)`
- `M.clamp`, `M.lerp`, `M.approach`
## Who reads what
- **kart** — `KART`, `SURFACE`, `SPARK`, `BOOST`, `RESCUE`, `race`.
- **tracks** — `CIRCUITS`, `SURFACE`, `reachPoint`, `PHASE`.
- **items** — `ITEMS`, `BOOST`, `FEATHER_LIFT`, `emit("crate")`.
- **screens** — `flow`, `race`, `records`, `formatTime`, `PHASE`.
- **audio** — `on("phase")`, `on("boost")`, `on("crate")`, `on("finish")`.