Saloon Showdown 1.0.0: guía del comprador

Juego HTML5 de rueda de la fortuna (simulación) con créditos ficticios gratuitos. Código fuente editable incluido.

Guía de personalización (recetas)

EnglishPortuguêsEspañol

Visión general

Saloon Showdown es un juego HTML5 de rueda de la fortuna (una rueda de premios del estilo "Big Six") ambientado en un saloon del Lejano Oeste y presentado por un zorro sheriff. El jugador pone fichas en los números, hace girar la gran rueda y gana cuando se detiene en un número con apuesta. Los sectores dorados x2 hacen girar la rueda otra vez con cada ganancia multiplicada, y el sector BONUS abre una segunda rueda de multiplicadores. Se entrega como juego listo para alojar (game/) y con su código fuente completo y editable (source/). Funciona en cualquier navegador actual, en teléfonos, tabletas y ordenadores, en vertical y en horizontal, sin servidor, base de datos ni cuenta.

Funciones: 6 ruedas incluidas (de 16 a 54 sectores), nuevos giros x2/x7 que se acumulan, una rueda de bonificación, celebraciones BIG/MEGA/EPIC WIN, giro rápido, niveles de jugador que desbloquean fichas más grandes, un giro gratis diario de la rueda de bonificación, monedas gratis cada 3 horas, juego con teclado, 14 idiomas de interfaz, voz de locutor grabada, música y efectos.

Solo simulación. El jugador recibe créditos de demostración gratuitos y ficticios. No tienen valor monetario y no se pueden comprar, transferir, vender ni canjear. No hay depósitos, retiros, premios ni recompensas de valor económico. El precio de compra es por una licencia de software, no por participar en juegos de azar. La licencia no permite usarlo para juegos de azar con dinero real ni con nada de valor real. Lee SCOPE.md (en la raíz del paquete y dentro de game/): forma parte de los términos de la licencia.

La mesa con fichas en todas las casillas (1280×720).
La mesa con fichas en todas las casillas (1280×720).

Instalar en tu sitio web

El juego listo para jugar es la carpeta game/. Es HTML, CSS y JavaScript sin más: para alojarlo no hace falta compilar, ni Node.js, ni base de datos.

  1. Abre el administrador de archivos de tu alojamiento o conéctate con un programa FTP (por ejemplo FileZilla).
  2. Crea una carpeta para el juego, por ejemplo /games/saloon-showdown/.
  3. Sube a ella el contenido de game/: index.html, saloon-showdown.config.js, SCOPE.md, DOCUMENTATION.txt y las carpetas art/, audio/, assets/ y modules/.
  4. Abre la dirección en un navegador, por ejemplo https://your-site.example/games/saloon-showdown/.

El juego usa rutas relativas, así que funciona en cualquier carpeta o subdominio. Abrir index.html directamente desde tu disco (file://) no funciona, porque los navegadores bloquean ahí los módulos de JavaScript: pruébalo en un alojamiento web o con la vista previa local descrita en "Editar el código fuente".

Insertarlo en una página (iframe)

<iframe src="/games/saloon-showdown/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>

Deja visible el aviso de créditos en pantalla y conserva SCOPE.md junto al juego cuando lo publiques.

Requisitos

  • Cualquier alojamiento web estático HTTP o HTTPS (alojamiento compartido, una CDN, GitHub Pages, Netlify...). Sin PHP, base de datos ni código de servidor.
  • Un navegador actual: Chrome, Edge, Firefox, Safari (macOS e iOS), Samsung Internet u Opera.
  • Solo para editar el código fuente: Node.js 26 LTS (la versión LTS actual, 26.13.0 o posterior) y npm, consulta "Editar el código fuente".
  • No hace falta conexión a internet para jugar: el arte, los sonidos y el código están todos dentro de game/. El juego no hace peticiones a otros sitios.

Cómo se juega y las pantallas

El jugador toca TAP TO PLAY (tocar para jugar), elige una ficha y toca las casillas de los números en los que puede detenerse la rueda (varias a la vez), y después toca SPIN (girar). Todos los sectores tienen el mismo tamaño, así que todos tienen la misma probabilidad: un número que ocupa más sectores gana más a menudo y paga menos. Una apuesta a un número paga su valor a 1 (una apuesta al 5 paga 5 veces la apuesta) y además se devuelve la apuesta. Todas las cantidades son créditos de demostración ficticios.

La pantalla de entrada con el aviso de los créditos. 1 2 3
La pantalla de entrada con el aviso de los créditos.
  1. Logotipo (art/logo.webp)
  2. TAP TO PLAY (aparece cuando todo ha cargado)
  3. Aviso de los créditos (ficticios y gratuitos, sin premios)
La mesa con fichas en todas las casillas (1280×720). 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
La mesa con fichas en todas las casillas (1280×720).
  1. Saldo de créditos de demostración (FREE = recarga cuando se acaba)
  2. Nivel y XP del jugador (toque: próximo regalo y próxima ficha)
  3. Monedas gratis y giro gratis diario (el punto = algo está listo)
  4. Menú: reglas y opciones, sonido, pantalla completa
  5. La rueda de la fortuna (dibujada en un canvas)
  6. Los 10 últimos resultados
  7. Cinta de estado: apuesta total, NO MORE BETS, el premio
  8. El tablero de apuestas: una casilla por número y BONUS
  9. Fichas (estrella = se abre en un nivel superior)
  10. UNDO deshace la última ficha
  11. CLEAR limpia la mesa
  12. SPIN (Espacio o Enter)
  13. REBET: repite las apuestas de la última ronda
  14. DOUBLE dobla todas las apuestas de la mesa
  15. Aviso de los créditos, siempre visible durante el juego
  • Los sectores x2 / x7 no admiten apuestas: la rueda vuelve a girar con todas las apuestas en la mesa, y la siguiente ganancia se multiplica. Se acumulan (x2 y después x7 = x14), hasta 9 veces seguidas en la rueda por defecto; el último nuevo giro permitido solo puede caer en los demás sectores.
  • BONUS: una apuesta a BONUS hace girar la rueda de bonificación y gana su multiplicador (por los x2/x7 que hubiera antes).
  • Ninguna ronda paga más de 5.000× la apuesta total. Las celebraciones BIG, MEGA y EPIC WIN empiezan a 10×, 25× y 50× la apuesta total (winTiers en la configuración).
  • Un toque en la rueda (o Espacio) mientras gira la frena sobre el resultado que ya tiene; un toque salta una celebración.
La rueda girando: las apuestas quedan cerradas hasta que se detiene.
La rueda girando: las apuestas quedan cerradas hasta que se detiene.
Un premio: la casilla ganadora se ilumina y paga; las demás fichas se retiran.
Un premio: la casilla ganadora se ilumina y paga; las demás fichas se retiran.
x2: la rueda gira otra vez y el siguiente premio sale doblado.
x2: la rueda gira otra vez y el siguiente premio sale doblado.
La rueda de bonificación: una apuesta a BONUS gana su multiplicador. 1 2 3 4
La rueda de bonificación: una apuesta a BONUS gana su multiplicador.
  1. Título pintado (art/title-bonus.webp)
  2. La rueda de bonificación (multiplicadores)
  3. La cuenta: apuesta × multiplicador + la apuesta devuelta
  4. Lo que vuelve al saldo
Celebración de BIG WIN (importes en créditos ficticios de demostración).
Celebración de BIG WIN (importes en créditos ficticios de demostración).

Recompensas fuera de la rueda

  • Niveles: jugar da XP; cada nivel nuevo da un regalo (250 créditos × el nuevo nivel) y desbloquea fichas más grandes: 500 (nivel 3), 1.000 (nivel 6).
  • Giro gratis diario: una vez cada 24 horas el juego abre la rueda de bonificación para un giro gratis: el premio es su multiplicador × 100 créditos. LATER (más tarde) lo guarda para otro momento (el botón de regalo lo vuelve a abrir).
  • Monedas gratis: el botón de regalo da 500 créditos gratis cada 3 horas.
  • Cuando se acaban los créditos, el botón FREE (gratis) del saldo los recarga (hasta los 100.000 iniciales).
El giro gratis diario de la rueda de bonificación, después del giro (créditos de demostración gratuitos). 1 2 3 4
El giro gratis diario de la rueda de bonificación, después del giro (créditos de demostración gratuitos).
  1. Título pintado (art/title-daily.webp)
  2. La rueda de bonificación, girada gratis
  3. El premio: multiplicador × la apuesta diaria (créditos de demostración gratuitos)
  4. SPIN, luego COLLECT (LATER lo guarda para más tarde)

Menú, reglas y opciones

El botón de menú abre el panel de reglas (HOW TO PLAY, PAYS y OPTIONS: cómo se juega, pagos y opciones), el interruptor de sonido y la pantalla completa. Los textos de las reglas y la tabla de PAYS los escribe el juego para la rueda en uso. OPTIONS tiene música, efectos de sonido, giro rápido, el idioma y las 6 ruedas incluidas: elegir una rueda reinicia el juego con ella (el saldo y el nivel del jugador se mantienen; el historial de la rueda anterior se borra).

OPCIONES: música, efectos, giro rápido, idioma y las seis ruedas incluidas. 1 2 3 4 5 6 7
OPCIONES: música, efectos, giro rápido, idioma y las seis ruedas incluidas.
  1. Pestañas: HOW TO PLAY, PAYS, OPTIONS
  2. Música sí/no
  3. Efectos de sonido sí/no
  4. Giro rápido (unos 2,5 s por giro)
  5. Idioma (14)
  6. Las seis ruedas incluidas: elegir una reinicia el juego con ella
  7. Cerrar (Esc)
CÓMO JUGAR: las reglas, escritas para la rueda en uso.
CÓMO JUGAR: las reglas, escritas para la rueda en uso.
PAGOS: sectores y pago de cada apuesta de la rueda en uso.
PAGOS: sectores y pago de cada apuesta de la rueda en uso.
Móvil en vertical (390×844): el mismo juego, reorganizado. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Móvil en vertical (390×844): el mismo juego, reorganizado.
  1. Saldo de créditos de demostración (FREE = recarga cuando se acaba)
  2. Nivel y XP del jugador (toque: próximo regalo y próxima ficha)
  3. Monedas gratis y giro gratis diario (el punto = algo está listo)
  4. Menú: reglas y opciones, sonido, pantalla completa
  5. La rueda de la fortuna (dibujada en un canvas)
  6. Los 10 últimos resultados
  7. Cinta de estado: apuesta total, NO MORE BETS, el premio
  8. El tablero de apuestas: una casilla por número y BONUS
  9. Fichas (estrella = se abre en un nivel superior)
  10. UNDO deshace la última ficha
  11. CLEAR limpia la mesa
  12. SPIN (Espacio o Enter)
  13. REBET: repite las apuestas de la última ronda
  14. DOUBLE dobla todas las apuestas de la mesa
  15. Aviso de los créditos, siempre visible durante el juego

Teclado

Tab recorre las casillas de apuesta y los botones, e Intro o Espacio pulsa el que tiene el foco. Espacio o Intro en cualquier otro lugar hace girar; mientras la rueda gira la acelera, y en la rueda de bonificación o en una gran ganancia salta hacia adelante. M activa o desactiva el sonido. Escape cierra el panel de reglas. El modo de menos movimiento sigue el ajuste del dispositivo (prefers-reduced-motion): giros más cortos, sin sacudidas y sin fichas volando.

Las 6 ruedas incluidas y su RTP

Elige la rueda con math.preset en saloon-showdown.config.js (por defecto studio), o deja que los jugadores la elijan en OPTIONS (wheelChoice). Cada número de abajo se lee de source/src/logic/engine.js (PRESETS y la fórmula exacta rtpOf(), que npm test comprueba contra una simulación larga) cuando se genera esta guía.

math.preset Sectores Apuestas Multiplicadores (sectores) Rueda de bonificación RTP por apuesta
studio (predeterminada) 16 1, 2, 5, 10, BONUS x2 (2) 2x … 50x (media 10,42x) 90,5 – 97,6%
party 24 1, 2, 6, 20, BONUS x2 (1) 4x … 100x (media 19,33x) 92,2 – 97,8%
grand 36 1, 2, 7, 10, BONUS x2 (1) 6x … 150x (media 31,17x) 92,8 – 96,8%
polar 54 1, 2, 5, 10, 20, 40, BONUS x2 (1), x7 (1) 5x … 250x (media 41,67x) 90,8 – 96,6%
show 54 1, 2, 5, 10, 20, 40 x2 (1), x7 (1) — 90,8 – 96,6%
classic 54 1, 2, 5, 10, 20, @crown, @star — — 75,9 – 88,9%
Las seis ruedas incluidas en ordenador y móvil, de izquierda a derecha y de arriba abajo: studio, party, grand, polar, show, classic.
Las seis ruedas incluidas en ordenador y móvil, de izquierda a derecha y de arriba abajo: studio, party, grand, polar, show, classic.
La rueda `polar` de 54 sectores con apuestas en las siete casillas.
La rueda polar de 54 sectores con apuestas en las siete casillas.

RTP de cada apuesta

RTP = cuánto de cada 100 créditos apostados se devuelve de media, a largo plazo. Solo describe el ritmo de la simulación: los créditos son ficticios.

Rueda Apuesta: sectores, pago → RTP
studio 1: 6, 1:1 → 92,86% · 2: 4, 2:1 → 95,24% · 5: 2, 5:1 → 97,62% · 10: 1, 10:1 → 90,48% · BONUS: 1, rueda de bonificación → 93,95%
party 1: 11, 1:1 → 97,83% · 2: 7, 2:1 → 94,07% · 6: 3, 6:1 → 94,86% · 20: 1, 20:1 → 95,26% · BONUS: 1, rueda de bonificación → 92,23%
grand 1: 16, 1:1 → 92,77% · 2: 11, 2:1 → 96,13% · 7: 4, 7:1 → 93,78% · 10: 3, 10:1 → 96,81% · BONUS: 1, rueda de bonificación → 94,52%
polar 1: 22, 1:1 → 91,20% · 2: 15, 2:1 → 95,51% · 5: 7, 5:1 → 91,24% · 10: 4, 10:1 → 96,58% · 20: 2, 20:1 → 92,74% · 40: 1, 40:1 → 90,81% · BONUS: 1, rueda de bonificación → 94,52%
show 1: 23, 1:1 → 95,34% · 2: 15, 2:1 → 95,51% · 5: 7, 5:1 → 91,24% · 10: 4, 10:1 → 96,58% · 20: 2, 20:1 → 92,74% · 40: 1, 40:1 → 90,81%
classic 1: 24, 1:1 → 88,89% · 2: 15, 2:1 → 83,33% · 5: 7, 5:1 → 77,78% · 10: 4, 10:1 → 81,48% · 20: 2, 20:1 → 77,78% · @crown: 1, 40:1 → 75,93% · @star: 1, 40:1 → 75,93%

showRtp: true muestra la columna de RTP en la pestaña PAYS del juego. Después de cambiar una rueda, ejecuta npm run rtp en source/ (lee public/saloon-showdown.config.js; node tools/rtp.mjs --all lista todos los presets).

Qué incluye el paquete

saloon-showdown-static-1.0.0/
  START-HERE.txt          first steps
  DOCUMENTATION.html      opens this guide
  CUSTOMIZATION.html      opens the customization guide (recipes, no coding)
  CHANGELOG.txt
  SCOPE.md                what the product is and what the licence does not allow
  documentation/          this guide and the customization guide (EN/PT/ES), screenshots
  game/                   UPLOAD THE CONTENTS OF THIS FOLDER
    index.html            the page
    saloon-showdown.config.js  your settings (edit on the host, no rebuild)
    modules/              the JavaScript, one readable file per source module
    assets/ui/            the stylesheets
    art/                  images (WebP)
    audio/                sounds, voice and music (MP3)
    SCOPE.md, DOCUMENTATION.txt
  source/                 the complete editable project
    index.html            the page (development version)
    src/main.js           round flow (spin, respins, bonus wheel, payouts), celebrations, daily spin, input
    src/config.js         defaults, events, save key
    src/logic/            engine.js (wheels, limits, round draw, RTP, credits), progress.js (levels, daily spin, coins)
    src/ui/               money-wheel.js, wheel-fit.js, sheets.js, fx.js, theme.js, feel.js, art.js, styles.css, plates.css...
    src/locales/          the 14 languages (en.js is the reference)
    src/audio/audio.js    the list of sounds, music and voices
    public/               art/, audio/, saloon-showdown.config.js (copied to the build as they are)
    tests/                npm test
    tools/                RTP report, translation check, seed finder, in-page label check, build formatter
    package.json, package-lock.json, vite.config.js, .prettierrc, README.md, CREDITS.md
    licenses/             licences of the development tools
  THIRD-PARTY-LICENSES/   the same licence texts

game/ es exactamente lo que npm run build genera a partir de source/ (comprobado archivo por archivo antes de empaquetar). Edita source/ y vuelve a compilar, o edita solo saloon-showdown.config.js en el alojamiento.

Configuración (saloon-showdown.config.js)

game/saloon-showdown.config.js se lee cada vez que se abre el juego, así que puedes cambiar estos ajustes en tu alojamiento con un editor de texto y sin volver a compilar. Todos los campos son opcionales: quita las // del principio de una línea para usarla. Un valor incorrecto detiene el juego en la primera pantalla con un mensaje que indica qué corregir.

window.SALOON_SHOWDOWN_CONFIG = {
  brand: { name: 'Saloon Showdown', storageKey: 'mysite.saloon-showdown' },
  language: 'auto',
  languages: ['en', 'pt', 'es'],
  texts: { tapToPlay: 'PLAY NOW', de: { tapToPlay: 'LOS!' } },
  audio: { volume: 0.8, muted: false },
  ageGate: true,
  showRtp: true,
  quickSpin: false,
  wheelChoice: true,
  math: { preset: 'polar', startBalance: 100000, chips: [10, 50, 100, 500, 1000], maxTotal: 20000 },
  progress: { daily: { everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
  winTiers: { big: 10, mega: 25, epic: 50 },
};
Opción Qué hace
brand.name nombre del juego que se usa en los mensajes (el título de la página está en index.html)
brand.storageKey prefijo de los datos guardados en el navegador (por defecto saloon-showdown.template.save.v1); cámbialo para empezar con una partida guardada nueva
language 'auto' = el idioma del dispositivo (inglés si no está disponible), o un código: en pt es fr de it nl pl tr ru id ja ko zh. Tienen prioridad la elección del jugador en OPTIONS y ?lang=xx en la dirección
languages los idiomas que se ofrecen en OPTIONS (por defecto: los 14). Con un solo idioma se oculta el selector
texts sustituye cualquier texto de src/locales/en.js en todos los idiomas, o en uno solo (texts: { pt: {...} })
audio volumen inicial (de 0 a 1) y si empieza silenciado
ageGate true muestra la insignia 18+ y el aviso de casino social
showRtp muestra el RTP de cada apuesta en la pestaña PAYS (calculado a partir de la rueda, nunca escrito a mano)
quickSpin la opción de giro rápido empieza activada (unos 2,5 s por giro). Los jugadores la cambian en OPTIONS
wheelChoice true (por defecto): OPTIONS lista las 6 ruedas incluidas y elegir una reinicia el juego con ella. false oculta la lista. Se oculta de todos modos cuando configuras tu propia math.wheel
pegHang false (por defecto): la rueda siempre frena directamente sobre el sector sorteado. true: a veces se queda un momento enganchada en un tope antes (solo es un efecto visual: el resultado se sortea antes de que la rueda se mueva)
debug solo para pruebas: permite ?seed=123 en la dirección (las mismas rondas cada vez) en cualquier alojamiento
math preset (consulta "Las ruedas incluidas"), startBalance (100.000), chips (10, 50, 100, 500, 1.000, como máximo 5, de menor a mayor), minTotal (10), maxSpot (5.000 en una casilla), maxTotal (20.000 en la mesa), maxWin (5.000× la apuesta total) y wheel para tu propia rueda (consulta la guía de personalización). Ejecuta npm run rtp después de cambiarlo
progress levels (enabled, need, reward, unlock), daily (enabled, alwaysReady, everyHours, stake) y coins (enabled, everyHours, amount). Las cantidades son múltiplos de la ficha más pequeña
winTiers a cuántas veces la apuesta total empiezan las celebraciones BIG, MEGA y EPIC
integration, callbacks eventos para tu propia página, consulta "Eventos"

El archivo del paquete lista todas las opciones con un comentario. Los valores por defecto completos están en source/src/config.js, source/src/logic/engine.js (MATH, PRESETS) y source/src/logic/progress.js (PROGRESS).

Idiomas

La interfaz está traducida a 14 idiomas: inglés, portugués, español, francés, alemán, italiano, neerlandés, polaco, turco, ruso, indonesio, japonés, coreano y chino (simplificado). La voz del locutor y los títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) son imágenes y sonidos en inglés en todos los idiomas. El juego se abre en el idioma del dispositivo; el jugador puede cambiarlo en OPTIONS, y ?lang=pt en la dirección fuerza uno.

Los textos están en source/src/locales/<code>.js, un archivo por idioma, con las mismas claves que en.js. Si falta una clave, se usa el inglés. Para cambiar algunos textos sin volver a compilar, usa texts en saloon-showdown.config.js. Después de editar los archivos de idioma, ejecuta npm run locales para comprobar que ninguna traducción haya perdido un marcador {value}. Para comprobar que cada etiqueta sigue cabiendo en su placa, abre el juego con npm run dev, pega tools/qa-fit.js en la consola del navegador (F12) y ejecuta __qaFit(): una lista vacía significa que todas las etiquetas caben.

Datos guardados

El juego guarda el saldo, el nivel, el historial, la rueda elegida, las opciones y los temporizadores de recompensas en el localStorage del navegador, con claves que empiezan por saloon-showdown.template.save.v1. (por ejemplo saloon-showdown.template.save.v1.balance). No se envía nada a ningún sitio. Una ronda se resuelve en el momento en que se pulsa SPIN, así que recargar la página en mitad de un giro no cambia nada. Borrar los datos del sitio en el navegador reinicia el juego. Si publicas dos copias del juego en el mismo dominio, da a cada una su propio brand.storageKey.

Eventos para tu página

El juego emite eventos para que tu página pueda mostrar estadísticas, logros o una clasificación de puntuaciones ficticias. No son una interfaz de contabilidad ni de pagos y no deben usarse como tal. Hay cuatro formas; usa la que quieras:

  • callbacks en saloon-showdown.config.js: onReady, onSpin, onWin, onBalance, onBonus, onError.
  • window.SaloonShowdown.on('win', fn) desde un script de la misma página; window.SaloonShowdown.getBalance() lee el saldo.
  • Eventos DOM en window: saloonshowdown:ready, saloonshowdown:spin, saloonshowdown:win, saloonshowdown:balance, saloonshowdown:bonus, saloonshowdown:error.
  • Dentro de un iframe, con integration: { postMessage: true, targetOrigin: 'https://your-site.example' }, la página contenedora recibe { source: 'saloon-showdown', type: 'win', payload: {...} }.
Evento Datos
ready { version, rulesVersion, preset, locale }
spin la ronda: { bets, spent, chain, key, mult, bonus, pays, payout, capped, balanceBefore, balanceAfter } (sorteada antes de que la rueda se mueva)
win la misma ronda, una vez mostrada la ganancia
balance { balance }
bonus una recompensa de demostración gratuita: { kind: 'daily' / 'coins' / 'level', amount, balance }
error { message } (un valor de configuración incorrecto, o una ronda que no se pudo jugar)

round.spent son los créditos de demostración apostados en una ronda y round.payout los créditos de demostración que devolvió (apuesta incluida).

<script>
  addEventListener('saloonshowdown:win', (e) => console.log('won', e.detail.payout));
</script>

Editar el código fuente (Node.js para principiantes)

Solo lo necesitas para cambiar el código, los estilos, el arte o los sonidos y generar un nuevo game/. Para cambiar ajustes, edita saloon-showdown.config.js.

1. Instalar Node.js

  1. Entra en https://nodejs.org y descarga la versión LTS (Node.js 26 LTS). Windows y macOS: ejecuta el instalador con las opciones por defecto. Linux: usa tu gestor de paquetes o los binarios oficiales.
  2. Cierra y vuelve a abrir la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal).
  3. Comprueba las versiones: ambos comandos deben mostrar un número, y Node debe ser 26.13.0 o posterior.
node --version
npm --version

2. Instalar las herramientas del proyecto

Abre la terminal en la carpeta source/ (Windows: abre la carpeta en el Explorador, haz clic en la barra de direcciones, escribe powershell y pulsa Intro; macOS: arrastra la carpeta al icono de Terminal). Después ejecuta:

npm ci

Esto instala las versiones exactas de package-lock.json (Vite y Prettier) en node_modules/. Necesita conexión a internet una sola vez.

3. Probar, previsualizar y compilar

npm test
npm run dev
npm run build
  • npm test ejecuta las 16 pruebas de las reglas (sorteo de la ronda, fórmula del RTP contra una simulación larga, rechazos de configuración, números que caben en sus sectores). Todas deben pasar.
  • npm run dev inicia una vista previa local en http://localhost:5218/ que se recarga al guardar un archivo. Pulsa Ctrl+C para detenerla.
  • npm run build escribe el juego terminado en source/dist/. Sube el contenido de dist/ a tu alojamiento (sustituye a game/). La compilación no está minificada y está formateada con Prettier, así que sigue siendo legible.

Otros comandos

  • npm run rtp muestra el RTP de cada apuesta para la rueda de public/saloon-showdown.config.js; node tools/rtp.mjs --all para todos los presets.
  • npm run locales comprueba las traducciones.
  • node tools/find-seeds.mjs lista semillas cuya primera ronda muestra una ganancia, un x2, la rueda de bonificación o una gran ganancia; abre http://localhost:5218/?seed=N y pon las mismas fichas en todas las casillas para verlo (las semillas funcionan en localhost o con debug: true).
  • npm run format formatea todo el proyecto con Prettier.

Problemas frecuentes

  • node o npm no se reconoce: Node.js no está instalado o la terminal se abrió antes de instalarlo. Reinstálalo y abre una terminal nueva.
  • Windows dice que la ejecución de scripts está deshabilitada (npm.ps1): usa el Símbolo del sistema, o ejecuta npm.cmd ci.
  • ENOENT ... package.json: la terminal no está en la carpeta source/.
  • EBADENGINE: tu Node.js es anterior a 26.13.0. Instala la LTS actual.
  • npm ci falla con un error de red: revisa la conexión o el proxy de la red de tu empresa y vuelve a ejecutarlo.
  • npm ci dice que el archivo de bloqueo no está sincronizado: cambiaste package.json; ejecuta npm install una vez y npm ci volverá a funcionar.
  • El puerto 5218 está ocupado: Vite elige el siguiente puerto libre y lo muestra.

Personalizar y cambiar la apariencia

La guía de personalización (CUSTOMIZATION.html) tiene recetas paso a paso para quienes no programan: los fondos, el logotipo, el presentador, las partes de la rueda, las placas y las fichas, sonidos y música, colores, textos, la rueda y sus pagos, fichas y límites. En resumen:

  • Arte: source/public/art/ (o game/art/ en el alojamiento). Sustituye un archivo por otro WebP con el mismo nombre y las mismas proporciones.
  • Sonidos: source/public/audio/ (o game/audio/). Sustituye un MP3 por otro con el mismo nombre.
  • Colores y materiales de los sectores: source/src/ui/theme.js. Tiempos (duración del giro, muelle del puntero, celebraciones): source/src/ui/feel.js. Solo afectan a la presentación: nada de ahí cambia un resultado.
  • Diseño y estilos: source/src/ui/styles.css; los cortes de las placas están en source/src/ui/plates.css y source/src/ui/art.js.
  • Textos: texts en saloon-showdown.config.js o source/src/locales/.
  • La rueda y sus pagos: math en saloon-showdown.config.js (sin volver a compilar) o PRESETS en source/src/logic/engine.js, y después npm run rtp.

Los cambios en source/ requieren npm run build. Los cambios en archivos de game/ en el alojamiento (arte, audio, saloon-showdown.config.js) no requieren compilar.

Nombres internos

Algunos nombres del código vienen de los módulos compartidos de efectos y del motor, o son nombres cortos de elementos de la pantalla. Son solo nombres:

Nombre en el código Qué es
CreditBank, round.spent, round.payout the fictional demo credits: credits put into one round and credits it returned (no money)
fx.snow, FEEL.ambient.snowTouch / snowDesktop the drifting-flake layer of the shared effects module; off in this game (both counts are 0 in src/ui/feel.js)
fx.frost(), fx.shards(), fx.crack() ice-burst effects of the shared effects module; this game does not call them (kept so the module stays complete)
'@crown', '@star' the two picture wedges of the classic Big Six wheel (plain bets with their own payout, art emblem-crown.webp and emblem-star.webp)
'polar' preset the 54-wedge wheel with x2/x7 respins and the bonus wheel (named after the theme, not a place)
rulesVersion 'ppshow-1' a label sent with every round event so your statistics can tell rule versions apart
host, mascot-*.webp the fox sheriff presenter ("host" in the code)
mat-blue.webp, tile-blue.webp, pill-blue.webp, mat-ruby.webp, tile-ruby.webp, token-blue.webp file names kept from the shared wheel template: in this theme "blue" is teal and "ruby" is western red

Actualizar el juego y borrar la caché

Después de subir una versión nueva, los navegadores y los alojamientos pueden conservar los archivos antiguos durante un tiempo. Si un cambio no aparece:

  • Recarga sin la caché: Ctrl+F5 o Ctrl+Shift+R (Windows/Linux), Cmd+Shift+R (macOS). En un teléfono, cierra la pestaña y vuelve a abrirla.
  • Borra los archivos en caché del sitio en los ajustes del navegador ("Imágenes y archivos en caché"). No borres "cookies y datos de sitios" salvo que quieras reiniciar la partida guardada.
  • Prueba con una ventana privada (de incógnito).
  • Si tu alojamiento o tu CDN (por ejemplo Cloudflare) tiene caché, púrgala.
  • Añade una versión a la dirección una vez, por ejemplo index.html?v=2.

Los datos guardados se mantienen tras una actualización siempre que brand.storageKey no cambie.

Qué es el producto (y qué no es)

  • Solo créditos de demostración gratuitos y ficticios, sin valor monetario. No se pueden comprar, transferir, vender ni canjear. No hay premios de ningún tipo.
  • No hay ningún sistema de pagos, depósitos, retiros, cuentas ni monederos: ninguno está oculto, desactivado ni incluido en el paquete.
  • Las fichas del tablero son los mismos créditos de demostración gratuitos: colocarlas no es una compra ni una apuesta de nada de valor.
  • La licencia estándar no permite usar este juego, ni ninguna versión modificada de él, para juegos de azar con dinero real ni con nada de valor real: no se pueden comprar créditos, ni canjearlos por dinero, ni dar premios según los resultados, ni conectarlo a un monedero de juegos de azar, a un sistema de pagos ni a un operador de dinero real, ni anunciar juegos de azar con dinero real.
  • Debes cumplir las leyes de cada lugar donde publiques el juego (clasificación por edades, menores, protección del consumidor). Mantén visible el aviso de créditos; ageGate: true añade un aviso 18+.
  • El soporte no cubre monederos, depósitos, retiros ni ninguna integración con dinero real; esas solicitudes se rechazan.

El texto completo está en SCOPE.md.

Preguntas y problemas

  • La página está en blanco o se queda en la barra de carga. Comprueba que subiste el contenido de game/ (con modules/, assets/, art/ y audio/) y que lo abres por http(s), no por file://. La consola del navegador (F12) muestra el archivo que falta.
  • El juego muestra un mensaje rojo en la primera pantalla. Un valor de saloon-showdown.config.js no puede funcionar (por ejemplo una ficha mayor que maxSpot, o una rueda en la que una apuesta devolvería el 100 % o más). El mensaje indica qué corregir.
  • No hay sonido. Los navegadores solo permiten el sonido después de un toque: el juego lo inicia con TAP TO PLAY. Revisa el menú (botón de sonido), OPTIONS (música, efectos) y el volumen del dispositivo.
  • ¿Puedo cambiar el RTP? Sí: elige otro math.preset, o configura tu propia math.wheel (sectores y pagos) y mídela con npm run rtp.
  • ¿Pueden los jugadores comprar créditos o ganar premios? No. El juego no tiene ningún sistema de pagos ni de premios, y la licencia no permite añadirlo.
  • ¿Funciona sin conexión? Una vez cargado, sí; no necesita ningún otro sitio.
  • ¿Puedo quitar el aviso de créditos? En una publicación pública debe seguir visible (consulta SCOPE.md).
  • El giro gratis diario no se abrió. Se abre una vez cada 24 horas por navegador, y solo con una rueda que tenga rueda de bonificación (studio, party, grand, polar). progress: { daily: { alwaysReady: true } } lo ofrece en cada visita (una página de demostración).
  • ¿Cómo pruebo la rueda de bonificación? En localhost usa ?seed=N con una semilla de node tools/find-seeds.mjs, o activa debug: true mientras pruebas.

Soporte y créditos

Correo de soporte: willian@polargames.com.br (errores, instalación, diseño en los navegadores compatibles, traducciones, personalización visual y de audio y los ajustes de esta guía). Incluye tu código de compra o de licencia, el navegador y el dispositivo, y una captura de pantalla.

Herramientas de desarrollo: Vite y Prettier (licencias MIT en THIRD-PARTY-LICENSES/). No se incluye código ni fuentes de terceros en game/: los números usan una fuente pintada en imagen creada para este juego y los demás textos usan las fuentes del sistema del jugador. El arte, la música, la voz y los efectos se crearon para este juego y están cubiertos por la licencia de tu compra (source/CREDITS.md).