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.
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.
- Abre el administrador de archivos de tu alojamiento o conéctate con un programa FTP (por ejemplo FileZilla).
- Crea una carpeta para el juego, por ejemplo
/games/saloon-showdown/. -
Sube a ella el contenido de
game/:index.html,saloon-showdown.config.js,SCOPE.md,DOCUMENTATION.txty las carpetasart/,audio/,assets/ymodules/. -
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.
1
2
3
- Logotipo (
art/logo.webp) - TAP TO PLAY (aparece cuando todo ha cargado)
- Aviso de los créditos (ficticios y gratuitos, sin premios)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- Saldo de créditos de demostración (FREE = recarga cuando se acaba)
- Nivel y XP del jugador (toque: próximo regalo y próxima ficha)
- Monedas gratis y giro gratis diario (el punto = algo está listo)
- Menú: reglas y opciones, sonido, pantalla completa
- La rueda de la fortuna (dibujada en un canvas)
- Los 10 últimos resultados
- Cinta de estado: apuesta total, NO MORE BETS, el premio
- El tablero de apuestas: una casilla por número y BONUS
- Fichas (estrella = se abre en un nivel superior)
- UNDO deshace la última ficha
- CLEAR limpia la mesa
- SPIN (Espacio o Enter)
- REBET: repite las apuestas de la última ronda
- DOUBLE dobla todas las apuestas de la mesa
- 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 (
winTiersen 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.
1
2
3
4
- Título pintado (
art/title-bonus.webp) - La rueda de bonificación (multiplicadores)
- La cuenta: apuesta × multiplicador + la apuesta devuelta
- Lo que vuelve al saldo
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).
1
2
3
4
- Título pintado (
art/title-daily.webp) - La rueda de bonificación, girada gratis
- El premio: multiplicador × la apuesta diaria (créditos de demostración gratuitos)
- 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).
1
2
3
4
5
6
7
- Pestañas: HOW TO PLAY, PAYS, OPTIONS
- Música sí/no
- Efectos de sonido sí/no
- Giro rápido (unos 2,5 s por giro)
- Idioma (14)
- Las seis ruedas incluidas: elegir una reinicia el juego con ella
- Cerrar (Esc)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- Saldo de créditos de demostración (FREE = recarga cuando se acaba)
- Nivel y XP del jugador (toque: próximo regalo y próxima ficha)
- Monedas gratis y giro gratis diario (el punto = algo está listo)
- Menú: reglas y opciones, sonido, pantalla completa
- La rueda de la fortuna (dibujada en un canvas)
- Los 10 últimos resultados
- Cinta de estado: apuesta total, NO MORE BETS, el premio
- El tablero de apuestas: una casilla por número y BONUS
- Fichas (estrella = se abre en un nivel superior)
- UNDO deshace la última ficha
- CLEAR limpia la mesa
- SPIN (Espacio o Enter)
- REBET: repite las apuestas de la última ronda
- DOUBLE dobla todas las apuestas de la mesa
- 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% |
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:
-
callbacksensaloon-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
-
Entra en
https://nodejs.orgy 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. - Cierra y vuelve a abrir la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal).
- 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 testejecuta 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 devinicia una vista previa local enhttp://localhost:5218/que se recarga al guardar un archivo. Pulsa Ctrl+C para detenerla. -
npm run buildescribe el juego terminado ensource/dist/. Sube el contenido dedist/a tu alojamiento (sustituye agame/). La compilación no está minificada y está formateada con Prettier, así que sigue siendo legible.
Otros comandos
-
npm run rtpmuestra el RTP de cada apuesta para la rueda depublic/saloon-showdown.config.js;node tools/rtp.mjs --allpara todos los presets. npm run localescomprueba las traducciones.-
node tools/find-seeds.mjslista semillas cuya primera ronda muestra una ganancia, un x2, la rueda de bonificación o una gran ganancia; abrehttp://localhost:5218/?seed=Ny pon las mismas fichas en todas las casillas para verlo (las semillas funcionan en localhost o condebug: true). npm run formatformatea todo el proyecto con Prettier.
Problemas frecuentes
-
nodeonpmno 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 ejecutanpm.cmd ci. ENOENT ... package.json: la terminal no está en la carpetasource/.EBADENGINE: tu Node.js es anterior a 26.13.0. Instala la LTS actual.-
npm cifalla con un error de red: revisa la conexión o el proxy de la red de tu empresa y vuelve a ejecutarlo. -
npm cidice que el archivo de bloqueo no está sincronizado: cambiastepackage.json; ejecutanpm installuna vez ynpm civolverá 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/(ogame/art/en el alojamiento). Sustituye un archivo por otro WebP con el mismo nombre y las mismas proporciones. -
Sonidos:
source/public/audio/(ogame/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 ensource/src/ui/plates.cssysource/src/ui/art.js. -
Textos:
textsensaloon-showdown.config.jsosource/src/locales/. -
La rueda y sus pagos:
mathensaloon-showdown.config.js(sin volver a compilar) oPRESETSensource/src/logic/engine.js, y despuésnpm 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: trueañ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/(conmodules/,assets/,art/yaudio/) y que lo abres por http(s), no porfile://. 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.jsno puede funcionar (por ejemplo una ficha mayor quemaxSpot, 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 propiamath.wheel(sectores y pagos) y mídela connpm 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=Ncon una semilla denode tools/find-seeds.mjs, o activadebug: truemientras 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).