Desarrollo

Qué es técnicamente

RNGdle Infinite es un juego de navegador hecho con React + Vite. No tiene backend: todo ocurre en el cliente y la partida se guarda en localStorage.

Dos decisiones de arquitectura mandan sobre el resto:

• El RNG y el scoring viven en un Web Worker (src/roll.worker.js). Mantenerlos fuera del hilo de interfaz es lo que permite tiradas largas y cálculos de insignias sin congelar la pantalla.
• La fuente de aleatoriedad es propia (src/random.js). No se sustituye por Math.random para las tiradas: la honestidad del número es una regla del proyecto, no un detalle de implementación.

Mapa del repositorio

Comandos

npm install
npm run dev              # servidor en 0.0.0.0:5173, relay incluido
npm test                 # suite completa de Playwright (arranca npm run dev sola)
npx playwright test tests/roll.spec.js   # una sola especificación
npm run build            # build de producción en dist/
npm run pages:publish    # regenera docs/ (tras cambios que se publican)
npm run test:pages       # comprobaciones sobre el docs/ ya commiteado
npm run audit:economy    # auditoría de precios y distribución de tiradas
npm run format           # prettier sobre src, tests, configs de raíz y README

Chromium en entornos restringidos

La descarga de Chromium que hace Playwright suele estar bloqueada en sandboxes. Si ya tienes un binario de Chromium, exporta CHROMIUM_PATH=/ruta/a/chromium antes de ejecutar las pruebas. Algunos entornos necesitan además --no-sandbox, que playwright.config.js ya pasa cuando CHROMIUM_PATH está definido.

Reglas que no se negocian

Son decisiones de diseño tomadas por quien mantiene el proyecto. No se cambian como efecto secundario de otro trabajo.

• Tirada honesta. Una skill puede cambiar cuántos números se extraen o cuál se conserva, pero nunca la tabla de puntuación, el valor de las insignias ni el rango de un número. Los multiplicadores de cartera solo multiplican EP ya bancario.
• Los compañeros nunca cambian la tirada. Multiplican el EP que llega a la cartera. Trail y Drift son las únicas excepciones, y usan su propia muestra aleatoria.
• Rollback permanece oculto hasta tener tres prestiges. Está oculto, no deshabilitado. Arranca desde 0 EP (sin bonificación inicial) y se puede repetir.
• Los marcadores están limitados a 3. El README, el chip «Bookmarks (n/3)» y las pruebas afirman ese techo.
• Las firmas de compañero ocupan un hueco del rack, como cualquier otro círculo.
• Logos. La marca nueva del RNG sobre ∞ es solo para el favicon y el icono de la aplicación móvil. El logo del juego es el original, anterior a RNGdle Infinite.
• Números almacenados. Cada número guardado de una tirada paga los multiplicadores de skills de cartera, no solo el último.
• Los ajustes de presentación nunca cambian probabilidades, EP, precios ni tiempos.
• Sin conexión. Las tiradas offline pagan EP y entran en el historial. La carga de skills es solo con conexión.

Pruebas

La suite es de Playwright y arranca sola el servidor de desarrollo. Algunas especificaciones son lentas a propósito, porque prueban los tempos reales del juego: la revelación de 45 segundos y el enfriamiento de 60.

Notas que ahorran tiempo:

• tests/helpers/progress.js siembra la partida. Úsalo en vez de escribir localStorage a mano para PROGRESS_KEY.
• Una página que lee ?sync= lo hace en un efecto después del montaje. Espera a que el enlace esté guardado antes de navegar, o la unión compite con la navegación.
• tests/device-link-webrtc.spec.js necesita la dependencia de desarrollo peer. Debe seguir en devDependencies.
• Las especificaciones sensibles a tiempos (roll, auto-originals) pueden dar falsos fallos con mucha carga paralela. Reejecútalas solas antes de dar por buena una regresión.
• Para flujos largos, ajusta test.setTimeout en vez de acortar los temporizadores del juego.

Publicación

GitHub Pages sirve docs/ desde la rama main, con la ruta base /RNGdle-Infinite/.

El flujo tras un cambio que se publica:

1. Ejecutar npm run pages:publish, que reconstruye docs/.
2. Commitear el docs/ regenerado.

Los datos de puntuación

Es la parte más delicada del proyecto y tiene su propio documento, src/data/README.md, que con 12,8 KB es más extenso que el README principal.

Las puntuaciones y los rangos no se calculan: se consultan de unas tablas factuales descargadas de RNGdle Tools el 14 de septiembre de 2026 y fijadas al commit 8190166af9f259a9d3a0a941b2c9902bfbbe713f de CubityFirst/rngdle-ep-calculator.

La pertenencia a una insignia se lee así, y los siete bits de relleno al final de cada fila se ignoran:

bits[row * 125001 + (number >> 3)] & (1 << (number & 7))

Por qué hay dos formatos de la misma tabla

En public/data/ conviven los .bin.gz y unos .json con un hash en el nombre. No son duplicados:

• Los .json son los que se sirven en runtime. Los genera npm run prepare:data y son sobres de transporte con {encoding: "gzip-base64", data: "…"}.
• Van en JSON ASCII a propósito: así un proxy de previsualización no puede reescribir el gzip ni el binario por el camino.
• El nombre lleva el hash del contenido para que una tabla vieja no pueda emparejarse con un manifiesto más nuevo.
• Los .bin.gz siguen ahí para las pruebas offline y para poder reproducir el proceso, pero la aplicación no los descarga.

Cambiar la revisión fijada

El documento es explícito: si se cambia la revisión de origen hay que revisar a la vez los metadatos, el orden de filas y los umbrales de nivel de tirada. No se sustituye una tabla y ya. Las pruebas auditan cada puntuación legal, cada probabilidad de insignia, el recuento por nivel, los hashes y la concordancia con los cincuenta resultados de referencia.

Y una regla más: no se guarda ningún motor ejecutable aguas arriba en producción.

Economía

npm run audit:economy revisa dos cosas que conviene auditar juntas porque se influyen: los precios de la tienda y la distribución de las tiradas. Si cambias una insignia, un compañero o un precio, es el comando que dice si la economía sigue teniendo sentido.