Caso de estudio: Circuito Luz Verde

	"jugadores": {
		"min": 1,
		"max": 4
	},
	"controles": {
		"teclado": true,
		"tactil": true,
		"mando": true,
		"acciones": {
			"saltar": {
				"es": "Saltar",
				"en": "Jump"
			},
			"accion": {
				"es": "Llamar el ascensor",
				"en": "Call the lift"
			}
		}
	},

	"puntajes": [
		{
			"id": "tiempo",
			"nombre": {
				"es": "Mejores tiempos",
				"en": "Best times"
			},
			"orden": "menor",
			"formato": "tiempo"
		}
	],

		{ "id": "losa-1", "forma": "caja", "posicion": [0, -0.5, 9], "tamano": [3.4, 1, 3], "material": { "color": "verde", "patron": "rejilla" }, "dificultades": ["facil", "normal"] },
		{ "id": "losa-1-d", "forma": "caja", "posicion": [0, -0.5, 9], "tamano": [2.2, 1, 2.2], "material": { "color": "verde", "patron": "rejilla" }, "dificultades": ["dificil"] },

		{ "forma": "caja", "posicion": [0, -0.35, 6.75], "tamano": [1.6, 0.5, 1.7], "material": "madera", "dificultades": ["facil"], "etiquetas": ["puente"] },

		{ "id": "brazo", "forma": "caja", "posicion": [2.4, 4.75, 63.5], "tamano": [4, 0.7, 0.5], "material": { "color": "coral", "acabado": "neon" }, "etiquetas": ["peligro"], "datos": { "centro": [0, 4.75, 63.5], "radio": 2.4 } },

// --- Ajustes por dificultad ----------------------------------------------------------------------------------------
// juego.nivelDificultad es el indice de la dificultad elegida en juego.json: 0 facil, 1 normal, 2 dificil.
const AJUSTES = [
	{ limite: 300, giro: 50, verde: 3.2, ambar: 0.9, roja: 1.5, monedas: 24 },
	{ limite: 240, giro: 72, verde: 2.6, ambar: 0.8, roja: 1.8, monedas: 20 },
	{ limite: 180, giro: 95, verde: 2.0, ambar: 0.6, roja: 2.2, monedas: 16 }
][Math.max(0, juego.nivelDificultad)];

let fase: 'menu' | 'cuenta' | 'carrera' | 'fin' = 'menu';
let libre = false;
let totalMonedas = 0;
let crono: Cronometro;
let luz: 'verde' | 'ambar' | 'roja' = 'verde';
let rojaDesde = 0;
let musica = 0;
let ascensorOcupado = false;
let juez: Actor;

/** Estado de cada jugador. Vive en jugador.datos para que cada uno tenga el suyo. */
interface Estado { control: number; monedas: number; llego: boolean; cubierto: boolean }
const estado = (j: Jugador) => j.datos as unknown as Estado;

	jugadores.alEntrar((j) => {
		j.datos = { control: 0, monedas: 0, llego: false, cubierto: false };
		j.congelado = true; // nadie se mueve hasta la luz verde
		pintarHud(j);
	});

	// El menu de inicio se abre para todos; solo cuenta lo que elige una persona.
	const humano = jugadores.humanos()[0];
	const mejor = humano ? progreso.leer<number | null>(humano, `mejor-${juego.dificultad}`, null) : null;
	interfaz.menu({
		id: 'inicio',
		titulo: interfaz.t('menuTitulo'),
		texto: mejor === null ? interfaz.t('menuTexto') : interfaz.t('menuTextoMejor', { tiempo: mejor.toFixed(2) }),
		opciones: [
			{ id: 'carrera', texto: interfaz.t('menuCarrera') },
			{ id: 'paseo', texto: interfaz.t('menuPaseo') }
		]
	});
	interfaz.alElegir((menu, opcion, jugador) => {
		if (menu !== 'inicio' || jugador.esBot || fase !== 'menu') return;
		libre = opcion === 'paseo';
		interfaz.cerrarMenu('inicio');
		cuentaRegresiva();
	});

function sembrarMonedas(): void {
	// azar sale de la semilla de la partida: con la misma semilla, las monedas quedan en los mismos lugares.
	const elegidos = azar.mezclar(LUGARES).slice(0, AJUSTES.monedas);
	totalMonedas = elegidos.length;
	for (const posicion of elegidos) {
		const moneda = mundo.crear({
			forma: 'cilindro',
			posicion,
			rotacion: [90, 0, 0],
			tamano: [0.9, 0.16, 0.9],
			material: { color: 'ambar', acabado: 'brillante' },
			solida: false,
			etiquetas: ['moneda']
		});
		moneda.girar([0, 160, 0]);
	}
}

	mundo.alTocar('#moneda', (moneda, j) => {
		interfaz.flotante(interfaz.t('menosUno'), moneda.posicion, { tipo: 'exito', para: j });
		moneda.eliminar();
		estado(j).monedas++;
		j.puntos++;
		sonido.tocar('moneda', { para: j, tono: 1 + estado(j).monedas * 0.02 });
		pintarHud(j);
	});

	mundo.alTocar('#peligro', (_pieza, j) => {
		if (fase !== 'carrera' || estado(j).llego) return;
		sonido.tocar('golpe', { para: j });
		interfaz.mensaje(interfaz.t('golpe'), { tipo: 'peligro', para: j });
		j.reaparecer();
	});

	mundo.alTocar('#trampolin', (_pieza, j) => {
		j.impulsar([0, 21, 5]);
		sonido.tocar('poder', { para: j });
	});

	mundo.alEntrar('#control', (zona, j) => {
		const n = CONTROLES.indexOf(zona.id.replace('zona-', '')) + 1;
		if (n <= estado(j).control) return;
		estado(j).control = n;
		j.aparicion = CONTROLES[n - 1];
		pintarHud(j);
		if (j.esBot) return;
		mundo.pieza(`luz-control-${n}`).material = { color: 'verde', acabado: 'neon' };
		sonido.tocar('control', { para: j });
		interfaz.mensaje(interfaz.t('controlAlcanzado', { n }), { tipo: 'exito', duracion: 1.6, para: j });
	});

juego.cadaCuadro(() => {
	// La barredora: un brazo que da vueltas alrededor del eje. Se mueve a mano para mostrar posicion y rotacion.
	const brazo = mundo.pieza('brazo');
	const centro = brazo.datos.centro as Vec3;
	const radio = brazo.datos.radio as number;
	const grados = (reloj.ahora * AJUSTES.giro) % 360;
	const a = (grados * Math.PI) / 180;
	brazo.posicion = [centro[0] + Math.cos(a) * radio, centro[1], centro[2] - Math.sin(a) * radio];
	brazo.rotacion = [0, grados, 0];

function cicloDelCorredor(nueva: 'verde' | 'ambar' | 'roja'): void {
	if (fase === 'fin') return;
	luz = nueva;
	const semaforo = mundo.pieza('semaforo-corredor');
	// ...
	const color = nueva === 'verde' ? 'verde' : nueva === 'ambar' ? 'ambar' : 'coral';
	for (const banda of mundo.piezas('banda')) banda.material = { color, acabado: 'neon' };
	// Las etiquetas le sirven al bot de prueba para saber cuando partir (ver pruebas/bot.json).
	semaforo.desetiquetar('recien-verde');
	if (nueva === 'verde') {
		semaforo.etiquetar('recien-verde');
		reloj.despues(0.3, () => semaforo.desetiquetar('recien-verde'));
	}
	if (nueva === 'roja') rojaDesde = reloj.ahora;
	// ...
	const duracion = nueva === 'verde' ? AJUSTES.verde : nueva === 'ambar' ? AJUSTES.ambar : AJUSTES.roja;
	reloj.despues(duracion, () => cicloDelCorredor(nueva === 'verde' ? 'ambar' : nueva === 'ambar' ? 'roja' : 'verde'));
}

	if (fase !== 'carrera') return;
	for (const j of mundo.zona('zona-corredor').jugadores()) {
		const cubierto = !loVeElSemaforo(j);
		if (cubierto !== estado(j).cubierto) {
			estado(j).cubierto = cubierto;
			interfaz.hud('cubierto', cubierto ? { texto: interfaz.t('aCubierto'), lugar: 'abajo-centro' } : null, j);
		}
		if (luz !== 'roja' || reloj.ahora - rojaDesde < 0.35 || cubierto) continue;
		const [vx, , vz] = j.velocidad;
		if (Math.hypot(vx, vz) > 1.2) {
			sonido.tocar('alerta', { para: j });
			interfaz.mensaje(interfaz.t('pillado'), { tipo: 'peligro', para: j });
			j.reaparecer();
		}
	}
});

/** Un rayo desde el semaforo hasta el pecho del jugador: si choca antes con un parapeto, el jugador esta a cubierto. */
function loVeElSemaforo(j: Jugador): boolean {
	const ojo: Vec3 = [0, 7.9, 105.9];
	const p = j.posicion;
	const hacia: Vec3 = [p[0] - ojo[0], p[1] + 1 - ojo[1], p[2] - ojo[2]];
	const distancia = Math.hypot(hacia[0], hacia[1], hacia[2]);
	const impacto = mundo.rayo(ojo, hacia, distancia);
	return impacto === null || impacto.distancia > distancia - 0.6;
}

	jugadores.alAccion('accion', (j) => {
		if (ascensorOcupado || !mundo.zona('zona-ascensor').jugadores().includes(j)) return;
		subirAscensor();
	});

function llegar(j: Jugador): void {
	const e = estado(j);
	if (e.llego || fase !== 'carrera') return;
	e.llego = true;
	j.congelado = true;
	if (j.esBot) {
		interfaz.mensaje(interfaz.t('botLlego', { nombre: j.nombre }));
		return;
	}
	fase = 'fin';
	crono.detener();
	sonido.detener(musica);
	sonido.tocar('victoria');
	const tiempo = crono.valor;
	const final = Math.max(0, Math.round((tiempo - e.monedas) * 100) / 100);
	// ...
	const mejor = progreso.leer<number | null>(j, `mejor-${juego.dificultad}`, null);
	if (mejor === null || final < mejor) progreso.guardar(j, `mejor-${juego.dificultad}`, final);
	reloj.despues(1.2, () => {
		juego.terminar({ resultado: 'victoria', puntaje: final, tabla: 'tiempo', de: j, detalle: interfaz.t('finDetalle', { tiempo: tiempo.toFixed(2), monedas: e.monedas }) });
	});
}

function sinTiempo(): void {
	if (fase !== 'carrera') return;
	fase = 'fin';
	sonido.detener(musica);
	sonido.tocar('derrota');
	const humano = jugadores.humanos()[0];
	juego.terminar({ resultado: 'derrota', detalle: interfaz.t('sinTiempo', { n: humano ? estado(humano).control : 0, total: CONTROLES.length }) });
}

{
	"$schema": "../../../packages/sdk/esquemas/bot.schema.json",
	"formato": 1,
	"tiempoMaximo": 170,
	"esperado": { "resultado": "victoria" },
	"pasos": [
		{ "elegir": "inicio:carrera" },
		{ "esperarPieza": "barrera", "cerca": [0, 3.4, 5], "radio": 0.3 },
		{ "ir": [0, 0, 9] },
		{ "ir": [1.5, 0, 13.5] },
		{ "ir": [-1.5, 0, 18] },
		{ "ir": [0, 0, 22.5] },
		{ "ir": "aparicion:control-1", "control": true },

		{ "ir": [0, 0, 41.9] },
		{ "ir": [0, 4, 52], "saltar": "no" },

		{ "esperarPieza": "brazo", "giroY": [115, 150] },
		{ "ir": [3, 4, 61.5] },
		{ "ir": [3, 4, 65.5] },
		{ "ir": [0, 4, 70.5] },

		{ "ir": [0, 4.4, 125] },
		{ "pulsar": "accion" },
		{ "esperarPieza": "ascensor", "cerca": [0, 10.2, 125], "radio": 0.1 },
		{ "ir": "zona:meta" }

  OK    facil semilla 1: victoria, puntaje 26.67, 44.9 s de partida en 325 ms; script 0.018 ms/cuadro (max 0.84), 99 piezas
  OK    facil semilla 2: victoria, puntaje 27.67, 44.9 s de partida en 285 ms; script 0.019 ms/cuadro (max 0.82), 99 piezas
  OK    normal semilla 1: victoria, puntaje 30.83, 47.0 s de partida en 273 ms; script 0.016 ms/cuadro (max 0.81), 90 piezas
  OK    normal semilla 2: victoria, puntaje 31.83, 47.0 s de partida en 334 ms; script 0.017 ms/cuadro (max 1.02), 90 piezas
  OK    dificil semilla 1: victoria, puntaje 32.78, 45.0 s de partida en 279 ms; script 0.017 ms/cuadro (max 0.77), 86 piezas
  OK    dificil semilla 2: victoria, puntaje 33.78, 45.0 s de partida en 319 ms; script 0.017 ms/cuadro (max 1.37), 86 piezas
circuito-luz-verde: prueba aprobada (6 de 6 corridas, .ggx de 9.0 KB)