Volver a Recipes

Trick or Take

Roba caramelos con amigos en un juego de Halloween de 60 segundos para el navegador.

Web / JavaScriptIntermediozicojiao
Trick or Take Halloween characters stealing candy while Lily turns with a broom

Guía de implementación

En esta guía
Trick or Take

Coge los caramelos. Que no te pillen.

Un pequeño robo de caramelos de Halloween en tu navegador. Juega a solas o con amigos por chat de voz.

Jugar ahora · Guía de despliegue

English · 简体中文 · Español · Français · Deutsch · 日本語 · 한국어 · Português (Brasil)

Agora RTC License: MIT Node.js 22.13+ Cloudflare Workers

Trick or Take

El juego

Lily está ocupada en la cocina. Los caramelos están ahí mismo. No se dará cuenta si falta uno, ¿verdad?

Mantén pulsado para robar. Suelta para guardar los caramelos y poner cara de inocente. Si Lily se gira y sigues robando, te dará un escobazo y perderás todos los caramelos. Tienes 60 segundos para conseguir el mejor resultado.

Elige el fantasma, la calabaza o el gato murciélago. Juega a solas o comparte un código de sala de seis dígitos con tus amigos. El chat de voz es opcional.

FunciónQué incluye
Un jugadorRécords locales, pausa y música sintetizada
Multijugador2–6 jugadores, salas de seis dígitos, confirmación de preparación y revanchas
VozAgora RTC con micrófono, silencio y reconexión
ActualizacionesAvisos de Agora RTM y consultas periódicas como alternativa
Un solo retoPausas aleatorias y avisos claros, con las mismas reglas para todos
ClasificaciónUna tabla común; tú decides si publicas tu nombre y puntuación
CompartirEnlaces a resultados verificados y tarjetas descargables
MóvilControles táctiles, diseño adaptable e iconos de pantalla de inicio
Idiomas del juego12 idiomas de interfaz con metadatos traducidos; imágenes OG en inglés y chino

Cómo jugar

  1. Elige un personaje. En multijugador, crea una sala o únete a una y espera a que todos estén listos.
  2. Mantén pulsado el botón grande, la escena o Espacio. Cuanto más tiempo mantengas pulsado, más rápido robas.
  3. Suelta cuando Lily empiece a girarse. Tu personaje pone cara de inocente inmediatamente.
  4. Si te descubre, tu cuenta vuelve a cero. Tras un breve aturdimiento, puedes volver a intentarlo.
  5. Al terminar, también cuentan los caramelos que aún tienes en las manos. Gana quien tenga más; los empates se mantienen.

Cada partida dura 60 segundos. Lily combina pausas cortas y largas y avisa durante 0,55–1,90 segundos antes de mirar. No hay selector de dificultad.

Los tiempos cambian en cada ronda. El servidor no revela el siguiente giro antes de que empiece el aviso. La música permanece desactivada en multijugador para facilitar la conversación.

Ejecutar en local

Necesitas Node.js 22.13 o posterior y npm. El juego local y las salas no requieren una cuenta de Cloudflare ni credenciales de Agora.

bash
git clone https://github.com/zicojiao/trick-or-take.git
cd trick-or-take
npm ci
npm run db:migrate
npm run dev

Abre http://localhost:5173. Para probar una sala, abre otra pestaña, únete con el mismo código y marca ambos jugadores como listos. Para evaluar el audio real, usa dos dispositivos.

El ID de base de datos de ceros en wrangler.json es un valor de ejemplo para desarrollo local. Sustitúyelo por tu propio ID de D1 antes de desplegar.

Activar Agora RTC y RTM

bash
cp .dev.vars.example .dev.vars

Configura AGORA_APP_ID y AGORA_APP_CERTIFICATE en .dev.vars y reinicia el servidor. Activa RTC y Signaling/RTM en tu proyecto de Agora. El servidor emite tokens de corta duración para los miembros autenticados; el certificado nunca se envía al navegador.

Cada jugador debe pulsar Join voice y permitir el micrófono. Se necesita localhost o HTTPS. Consulta la guía de despliegue, en inglés, para la configuración de producción.

Analítica opcional

Está desactivada por defecto. Para activarla, configura tus propios POSTHOG_PROJECT_TOKEN y POSTHOG_HOST. /config.js solo expone la configuración pública de recepción de eventos.

PostHog utiliza cookies propias y almacenamiento local. La captura automática y la grabación de sesiones están desactivadas. Se eliminan códigos de sala, identificadores de desafíos y parámetros de las URL de los eventos; no se envían los nombres de los jugadores. Adapta las páginas de privacidad a tu despliegue.

Cómo funciona

El cliente utiliza JavaScript y Canvas 2D. Un Cloudflare Worker sirve páginas, recursos, API e imágenes OG; D1 guarda salas y resultados. Agora RTC transporta el audio y RTM avisa de cambios en la sala.

  • Motor compartido: public/party/engine.mjs ejecuta las mismas reglas en solitario y en el servidor.
  • Estado del servidor: las actualizaciones condicionadas por versión evitan sobrescribir comandos simultáneos. RTM no decide el estado de la partida.
  • Resultados verificados: el servidor reproduce las acciones de las partidas individuales y obtiene los resultados multijugador del estado de la sala.
  • Publicación voluntaria: terminar una partida no publica tu nombre ni tu puntuación automáticamente. Los enlaces de desafío no incluyen el nombre.
  • Reglas versionadas: los resultados de versiones anteriores compatibles siguen siendo verificables.

Consulta la arquitectura, en inglés. La verificación rechaza puntuaciones inconsistentes, pero no impide por completo los jugadores automatizados.

Estructura

text
public/party/    Juego, Canvas, controles, voz, traducciones y arte
public/          Iconos, manifiesto y archivos para buscadores
server/          Salas, tokens, verificación e imágenes OG
worker/          Rutas y HTML localizado
drizzle/         Migraciones D1
scripts/         Generación de iconos y comprobaciones
tests/           Pruebas automatizadas
docs/            Despliegue y arquitectura, en inglés

Licencia

MIT