Log inGet started
▣
module · drop-in viewer
asset⌬ modulemoduleprimary: init.luau·originates fromworld 15f1acc9-b…

menu

<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->

by◐CarneJon·posted 1mo ago
What it does

menu

<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->

TODO: describe this module.

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

game.menu — las pantallas del juego. El título, la elección de modo, la de personaje, vehículo, circuito y cilindrada, y la ventana de "Más" con Controles y Logros. Lo que la especificación pide y aquí se respeta: - Al empezar sale el título con una foto del juego de fondo y abajo "Pulsa cualquier botón para comenzar". - Arriba a la izquierda, el botón "Language" con un dibujo de traductor; al pulsarlo se despliegan Español, English y 中文. - Se traduce todo menos los nombres (personajes, vehículos, circuitos), el puesto en el que vas, el nombre de los idiomas y "LAP". - Al pasar el cursor por un personaje salen sus estadísticas. - Los cinco últimos circuitos salen con interrogantes y no se pueden jugar hasta desbloquearlos. - "Online" está en gris y dice "Próximamente" al pasar por encima. El menú se monta al cargar la escena y se queda delante hasta que empieza una carrera; entonces se esconde y deja ver el HUD.

loadProgress( ) → void

saveProgress( ) → void

label(texto: ?, style: ?) → void

argtypedescription
texto?
style?

box(style: ?, children: ?) → void

argtypedescription
style?
children?

fila(style: ?, children: ?) → void

argtypedescription
style?
children?

pantalla(children: ?) → void

argtypedescription
children?

boton(texto: ?, accion: ?, style: ?, props: ?) → void

argtypedescription
texto?
accion?
style?
props?

barra(valor: ?, color: ?) → void

argtypedescription
valor?
color?

chivato(nombre: ?, valor: ?, color: ?) → void

argtypedescription
nombre?
valor?
color?

barraIdioma( ) → void

El botón de idioma con su despliegue. Va en TODAS las pantallas: antes solo estaba en la portada, y por eso parecía que cambiar de idioma no hacía nada —se cambiaba en el sitio donde menos texto hay— y no se podía cambiar sin volver al título.

opcionesDe(pagina: ?) → void

El teclado en los menús WASD y las flechas mueven, y Enter elige. Es imprescindible en un portátil justo: con el ratón cada clic cuesta, y aquí se recorre todo con cuatro teclas. Las opciones de cada página se declaran UNA vez —con su fila y su columna— y las leen los dos: el dibujo (para marcar cuál está señalada) y el teclado (para saber a dónde puede ir).

argtypedescription
pagina?

mete(id: ?, fila: ?, col: ?) → void

argtypedescription
id?
fila?
col?

bordeDe(id: ?, elegido: ?) → void

El borde de una opción, mirando tres cosas: si la señala el teclado, si es la elegida, y si no, ninguna.

argtypedescription
id?
elegido?

moverCursor(dx: ?, dy: ?) → void

Mueve el cursor a la opción más cercana en la dirección pedida.

argtypedescription
dx?
dy?

reiniciaCursor( ) → void

El cursor, a la vuelta de cada página, empieza en la opción que está elegida.

pageTitle( ) → void

Páginas

pageModes( ) → void

pageCharacter( ) → void

vehiclePhoto(vehicleId: ?) → void

La foto de cada vehículo, hecha DENTRO del juego: se monta el vehículo en el mundo, se retrata con `capture` y la imagen entra como textura. Nada generado. Las identidades van escritas UNA A UNA: una identidad calculada no se puede fijar, y el contenido que la usa no se publica.

argtypedescription
vehicleId?

pageVehicle( ) → void

comboName(marca: ?) → void

El conjunto con el que se hizo un récord, para enseñarlo al lado del tiempo: la especificación pide que el personal y el mundial salgan con el combo usado.

argtypedescription
marca?

pageTrack( ) → void

pageClass( ) → void

pageMore( ) → void

pagePause( ) → void

build( ) → void

bodyKart( ) → void

Empezar una carrera

startRace( ) → void

Pone el conjunto elegido en el kart del jugador, deja la carrera lista y esconde el menú. El circuito ya está horneado en la escena: el menú elige entre los que hay, y cambiar de circuito es cosa del mundo (ver PLAN).

director( ) → void

pause( ) → void

--!desc Saca la ventana de pausa. Devuelve si la ha sacado.

resumeAfterDelay( ) → void

--!desc "No": la ventana se va y la carrera se reanuda 0,75 s después.

backToTitle( ) → void

--!desc "Sí": se deja la carrera y se vuelve a la pantalla del título.

handle(id: ?, value: ?) → void

Interacción

argtypedescription
id?
value?

mount( ) → void

leerTeclas( ) → void

hay(puestas: ?, nombres: ?) → void

argtypedescription
puestas?
nombres?

hide( ) → void

show( ) → void

unmount( ) → void

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

Showing up to 3 levels deep. Open a part to see what it holds further down.

51+items
◇
component · born here
❒asset
# Race La carrera: cuenta atrás, vueltas, Lakitu, posición y meta. Vive en una entidad propia de la escena (`RaceDirector`). Los karts se apuntan solos al despertar, así que la misma pieza sirve para el jugador, para las CPUs y para quien entre después — y como el mundo es multijugador, la carrera es una sola para todos los que están en ella. Las reglas viven en `game.race` y no tocan el motor, así que se pueden comprobar sin conducir. ## Fases `idle` → `countdown` → `racing` → `finished` Con `autoStart` (por defecto) la cuenta atrás se lanza sola en cuanto hay un kart apuntado. La pantalla de selección la lanzará a mano con `startRace()`. ## Vueltas La vuelta se reparte en **8 puertas de control**. Una vuelta solo cuenta si se han pasado las ocho **en orden** y luego se cruza la meta, así que no se puede hacer trampa yendo y viniendo por la línea. El circuito de tramo (el 10, la Senda Arcoíris) no da vueltas: termina al cruzar la meta una vez. ## Lakitu Si un kart se aleja más de 45 m del eje de la carretera y sigue así 1,6 s, Lakitu se lo lleva de vuelta a la última puerta que pasó y le cuesta **3 monedas**. Salirse un poco al prado es parte del juego; perderse en el campo no. ## Public fields | Campo | Qué es | |---|---| | `phase` | En qué punto está la carrera. | | `countdown` | Segundos que quedan de la cuenta atrás. | | `raceTime` | Segundos desde la salida. | | `leaderLap` | Vuelta en la que va quien va primero. | | `totalLaps` | Vueltas de la carrera. | | `trackId` | Circuito en el que se corre. | | `entryCount` | Cuántos karts hay apuntados. | | `standings` | La clasificación: nombre, vuelta, progreso, posición y monedas. | | `results` | El resultado final, en orden de llegada. | | `lastEvent` | El último aviso: "VUELTA 2", "META", "LAKITU". | ## Methods - `:register(kartId)` / `:unregister(kartId)` — los llama el propio kart. - `:startRace()` — lanza la cuenta atrás. - `:reset()` — vuelve al estado inicial sin lanzarla. - `:kartStatus(kartId)` — vuelta, último tiempo, tiempo total y puesto. ## Usage ```lua entity.spawn("RaceDirector").component.add("Race", { autoStart = true }) ```
▲ 0↑ born
◇
component · born here
❒asset
# CpuRacers <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. --> TODO: describe this component.
▲ 0↑ born
◇
component · born here
❒asset
# ItemBoxes <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. --> TODO: describe this component.
▲ 0↑ born
▣
module · born here
❒asset
# circuit <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
▣
module · born here
❒asset
# game.roster El plantel de **Mario Kart OrigoZero Ultimate**: 16 personajes y 6 vehículos, con las cuatro estadísticas que `game.core` convierte en conducción. ```lua local Roster = require("game.roster") local tune = Roster.tuning("bowser", "boulder_kart", "150cc") -- tune.topSpeed, tune.accel, tune.turnRate, tune.chargeSpeed, tune.boostTimeMul ``` ## Personajes En el orden que pide la especificación — dentro de cada peso, de menor a mayor. **Ligeros** (más aceleración y manejo, menos velocidad): Bat · Baby Rosalina · Baby Daisy · Cheep Cheep · Goomba · Shy Guy · Koopa **Medianos** (un balance de todo): Toadette · Toad · Luigi · Mario · Waluigi · Moo Moo **Pesados** (más velocidad y peso, menos aceleración y manejo): Wario · Donkey Kong · Bowser Dos parejas comparten peso exactamente, como se pidió: **Toadette con Toad**, y **Baby Rosalina con Baby Daisy**. La clase se lee del peso (`Core.weightClass`), y es la que da las bonificaciones: un ligero carga derrape y salto un 10 % más rápido, un mediano un 5 % más y sus miniturbos duran un 5 % más, y un pesado sus miniturbos duran un 10 % más. ## Vehículos Un kart y una moto de cada peso. Dentro de cada peso la moto pesa menos y gira algo mejor; el kart aguanta más. | Vehículo | Clase | Kart o moto | |---|---|---| | Pip Kart | ligero | kart | | Feather Bike | ligero | moto | | Comet Kart | mediano | kart | | Bolt Bike | mediano | moto | | Boulder Kart | pesado | kart | | Ironbike | pesado | moto | Cada vehículo trae además `bodyScale`, `wheelRadius` y `wheelWidth`, que es lo que hace que el peso **se vea**: una moto pesada es larga y ancha de rueda, y una ligera es estrecha y corta. ## API | Llamada | Qué da | |---|---| | `Roster.character(id)` | El personaje, o el de por defecto si no se pasa id. | | `Roster.vehicle(id)` | El vehículo, o el de por defecto. | | `Roster.kindOf(character)` | Su clase de peso: `light`, `medium` o `heavy`. | | `Roster.tuning(charId, vehId, classId)` | La conducción final del conjunto. | | `Roster.accelSeconds(charId, vehId, classId)` | Cuánto tarda de 0 a tope, sin conducir. | `Roster.DEFAULT_CHARACTER` es `mario` y `Roster.DEFAULT_VEHICLE` es `comet_kart` — un conjunto mediano, cuya referencia son los 1,75 s de la especificación.
▲ 0↑ born
▣
module · born here
❒asset
# hud <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
▣
module · born here
❒asset
# achievements <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
▣
module · born here
❒asset
# game.track Los circuitos de Mario Kart OrigoZero Ultimate, construidos en código en cada carga: nada queda congelado en la escena, así que recargar el mundo deja el mismo circuito. ```lua local Track = require("game.track") local inst = Track.build("pradera") ``` ## Qué construye - La carretera, como una fila de losas solapadas un 25 % para que no se vea ninguna juntura. - Un bordillo claro a cada lado. - Nada más: el suelo, el cielo y el mar son de la escena. ## Consultas que da la instancia | Llamada | Qué responde | |---|---| | `inst:nearest(p)` | La muestra más cercana: `index`, `t`, `arc`, `lateral` (metros a la derecha del eje), `along`, `planDistance`, `dir`, `right`. | | `inst:surfaceAt(p)` | `"road"` si el punto cae dentro del ancho del asfalto; si no, la superficie del circuito (`"offroad"` por defecto). | | `inst:startPose(i)` | Posición y rumbo (grados) de la muestra `i`, que es donde aparece un kart. | | `inst:despawn()` | Quita el circuito del mundo. | `Track.current` es el circuito activo. Construir uno nuevo quita el anterior. ## Añadir un circuito Una entrada en `Track.defs`: su nombre, dificultad, ancho, colores, y una lista de puntos de control que se cierran en bucle. La curva pasa por todos ellos y el eje Y es la altura. | Campo | Qué es | |---|---| | `points` | Puntos de control `{ x, y, z }` de la vuelta. | | `width` | Ancho del asfalto en metros. | | `surface` | Superficie de todo lo que no sea asfalto. | | `walled` | Si lleva muros que impiden salirse. | | `laps` | Vueltas de la carrera. | | `roadTint` / `kerbTint` / `groundTint` | Colores. | | `skyPreset` / `timeOfDay` | Cielo del circuito. | | `sea` | Preset de océano, si el circuito tiene mar. |
▲ 0↑ born
▣
module · born here
❒asset
# i18n <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
◇
component · born here
❒asset
# Kart El modelo de conducción de Mario Kart OrigoZero Ultimate — y la K entera. Vive en el cuerpo del kart (el `body` del `PlayerPrototype`). Attach it there and every joining player drives their own. ## Controles | Tecla | Qué hace | |---|---| | J | Acelerar. De 0 a velocidad máxima en 1,75 s con un conjunto mediano. | | A / D | Girar a izquierda y derecha. | | S / O | Frenar; por debajo de cierta velocidad, marcha atrás. | | K | Saltar, derrapar y cargar el salto cargado. | | L | Usar el objeto. | ## La K, entera Un toque de K en el suelo salta. Si estás girando, el salto va **hacia el lado contrario** al derrape que vas a hacer; si no, va recto. Al caer derrapando empiezas a cargar, y cada nivel son chispas de las ruedas y un miniturbo al soltar la K: | Carga | Chispas | Miniturbo | |---|---|---| | 1 s | azules | 0,75 s | | 3 s | naranjas | 1,5 s | | 5 s | arcoíris | 3 s | Al caer del salto recto, si sigues manteniendo la K y no giras, empiezas a cargar un **salto cargado** — con la mitad de agarre. Las ruedas sueltan dos remolinos de viento, y soltar la K da el salto de ese nivel: | Carga | Viento | Salto | Miniturbo al aterrizar | |---|---|---|---| | 0 s | gris/blanco | — | — | | 1 s | azul | pequeño | 0,5 s | | 3 s | naranja | mediano | 1 s | | 5 s | arcoíris | grande | 2 s | Antes del azul no hay nada que soltar: ni miniturbo, ni salto. Espamear la K no da miniturbos: cada salto reinicia la carga y entre salto y salto hay un tiempo mínimo. ## Public fields - `characterId`, `vehicleId`, `classId` — la selección. - `isCpu`, `cpuSkill`, `gridIndex` — la parrilla. - `speed`, `speedRatio`, `heading`, `coins`, `lap`, `lastLapTime`, `totalTime`, `finished` — estado que leen la cámara, el HUD y la carrera. - `drifting`, `driftSide`, `chargeMode`, `chargeLevel`, `chargeTime` — la carga. - `boostTime`, `boostMul`, `boostKind` — el impulso en curso. - `airborne`, `surface`, `squishTime`, `slipTime`, `starTime`, `controlLocked`, `gone` — el resto de estados. - `inputMap` — el mapa de controles que activa al arrancar. ## Methods - `:setCombo(charId, vehicleId, classId, charStats, vehStats, kind)` — fija el conjunto y recalcula la conducción. - `:addCoins(n)` — suma o quita monedas (y da el miniturbo de 0,125 s al coger). - `:applyBoost(duration, mul, kind)` — un impulso, sin acumular con el que ya lleve. - `:slip()` — resbalón: 3 monedas y vueltas al 5 % durante 1,5 s. - `:squish()` — rayo: encogido al 33 % durante 3,5 s. - `:star()` — estrella: inmune, un 5 % más rápido, 10 s. - `:rescueAt(index)` — Lakitu: vuelta al punto de control. - `:isBoosting()`, `:isImmune()`. ## Lifecycle - `awake()` — localiza las piezas visuales del kart y le pone las chispas. - `start()` — activa su mapa de controles y se suscribe. - `update(dt)` — toda la conducción. - `onDestroy()` — suelta su reclamación del mapa de controles. ## Usage ```lua body.component.add("Kart", { inputMap = "driveKart", heading = 0, classId = "150cc" }) ```
▲ 0↑ born
▣
module · born here
❒asset
# progress <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
▣
module · born here
❒asset
# race <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.
▲ 0↑ born
backing path · game/menu.module

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

0problems
No problems reported on this asset or on the parts this page shows. Parts it leaves out are not counted here.
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ quality × 0.35
+ performance × 0.25
± compat factor

Usability ratings

Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.