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

venue

<!-- 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

venue

<!-- 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.venue — el sitio por el que se corre. Un circuito es la carretera; el sitio es todo lo demás: el suelo, la playa, el mar y el arco de salida. Va aparte porque cambia de un circuito a otro (una pradera no tiene mar y una playa sí) y porque hay que poder levantar otro sitio sin tocar la escena a mano. Dos maneras de llamarlo, y la diferencia importa: `Venue.build(def, inst)` desde el build de la escena. **Siempre crea**, porque un build solo puede tocar las entidades que crea; el motor reconcilia por nombre lo que ya estaba, así que el suelo del circuito anterior aterriza sobre la misma entidad que el del nuevo. `Venue.build(def, inst, { fresh = true })` en caliente, al cambiar de circuito. Se lleva por delante lo que hubiera con ese nombre y lo vuelve a crear, que es lo que hace falta cuando la escena ya está cargada.

ModelBoxColliderVenue

place(name: ?, fresh: ?) → void

Nombre, y si hay que llevarse por delante lo que ya hubiera con él.

argtypedescription
name?
fresh?

slab(name: ?, fresh: ?, cx: ?, cz: ?, top: ?, sizeX: ?, sizeZ: ?, material: ?, tint: ?) → void

Una losa de suelo plana y enorme, con su colisionador. El suelo es un PLANO sin grosor, así que la cara que se pisa es exactamente la altura que se pide: restarle media losa lo hundiría y lo dejaría por debajo del agua.

argtypedescription
name?
fresh?
cx?
cz?
top?
sizeX?
sizeZ?
material?
tint?

buildProps(def: ?, inst: ?, fresh: ?) → void

El decorado Los bultos del circuito: edificios, farolas, palmeras, árboles, tuberías, lápidas, champiñones grandes… Es lo que hace que un circuito sea un sitio y no una cinta de asfalto en medio de la nada. Se declaran como cajas verticales (`prop.w`, `prop.h`, `prop.d`) porque casi todo lo que pide la especificación —y desde luego todo lo que sirve para hacer un TRICK en el aire— es un pilar: alto, estrecho y en el que no se conduce. Lo que cambia es el color, el tamaño y dónde están.

argtypedescription
def?
inst?
fresh?

put(x: ?, z: ?, y: ?, prop: ?) → void

argtypedescription
x?
z?
y?
prop?

buildGround(def: ?, inst: ?, fresh: ?) → void

El suelo

argtypedescription
def?
inst?
fresh?

buildSea(def: ?, inst: ?, fresh: ?) → void

El mar

argtypedescription
def?
inst?
fresh?

buildGate(def: ?, inst: ?, fresh: ?) → void

La salida

argtypedescription
def?
inst?
fresh?

build(def: ?, inst: ?, fresh: boolean?) → void

Superficie pública --!desc Levanta el sitio que pide un circuito: suelo, playa si la hay, mar si lo hay y el arco de salida donde empieza la vuelta. --!arg def La definición del circuito, de `game.track`. --!arg inst La instancia del circuito ya construida. --!arg fresh Si además hay que reemplazar lo que ya hubiera con esos nombres.

argtypedescription
def?
inst?
freshboolean?

despawn( ) → void

--!desc Se lleva por delante todo lo que levanta `build`.

switch(trackId: string) → void

--!desc Levanta otro circuito y deja el mundo corriendo en él: la carretera nueva, su sitio, las monedas y las cajas colocadas otra vez y la carrera de vuelta a la parrilla. Es el mando que usará la pantalla de selección, y por eso vive aquí y no dentro de ella: cambiar de circuito es una operación del mundo, no del menú. --!arg trackId Identificador del circuito, de `game.track`.

argtypedescription
trackIdstring

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.

23+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
# Pickups <!-- 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
# 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
◇
component · born here
❒asset
# Venue <!-- 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
backing path · game/venue.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.