Antes de empezar
Esta guía es para quienes no programan. Cada receta indica qué archivo abrir y qué cambiar. Necesitas:
-
un editor de texto (Visual Studio Code, Notepad++, TextEdit en modo de texto sin formato) para los
archivos
.jsy.css; - un editor de imágenes que guarde en WebP (GIMP, Photopea en el navegador, Krita) para el arte;
- un editor de audio que guarde en MP3 (Audacity) para los sonidos.
Haz primero una copia de seguridad: copia toda la carpeta del paquete antes de cambiar nada.
Hay dos formas de cambiar el juego:
-
Directamente en el alojamiento (sin herramientas): sustituye archivos en la carpeta
game/que subiste (arte, audio,saloon-showdown.config.js). Es rápido, pero estos cambios solo quedan en el alojamiento. -
En
source/y compilando (necesita Node.js, consulta la guía principal): cambia archivos ensource/, ejecutanpm run buildy subesource/dist/. Úsalo para el código, los estilos,theme.js,engine.jsy las traducciones.
Después de cada subida, recarga el juego sin la caché (Ctrl+F5, o Cmd+Shift+R en un Mac).
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
Qué archivo corresponde a cada parte de la pantalla
Los tamaños están medidos a partir de los archivos del paquete (ancho × alto en píxeles).
| En pantalla | Archivo (en game/art/, con el mismo nombre en source/public/art/) |
Tamaño |
|---|---|---|
| Fondo, ordenador y teléfono en horizontal / teléfono en vertical | bg-landscape.webp / bg-portrait.webp |
1672 × 940 / 941 × 1672 |
| Fondo de la pantalla de título, en horizontal / en vertical, y el escenario del bonus | bg-entry-wide.webp / bg-entry.webp |
1672 × 941 / 941 × 1672 |
| El presentador en la pantalla de título (entero, del sombrero a las botas) | mascot-entry.webp |
586 × 1100 |
| Marco de la barra de carga | load-bar.webp |
900 × 134 |
| Aro de la rueda de bonificación (bombillas encendidas) | wheel-rim-bonus.webp |
1024 × 1024 |
| Ventana de reglas: marco / placa del título / tarjetas de opciones / cuerda / desierto / adorno inferior |
sheet-frame.webp / header-plaque.webp / opt-card.webp /
rope-divider.webp / desert.webp / ornament.webp
|
900 × 1364 / 900 × 220 / 900 × 214 |
| Logotipo (pantalla de título y podio) | logo.webp |
1000 × 554 |
| Las cinco poses del presentador |
mascot-idle.webp, mascot-hope.webp, mascot-pull.webp,
mascot-cheer.webp, mascot-aww.webp
|
670 × 900 cada una |
| El podio del presentador (ordenador) | podium.webp |
600 × 501 |
| Aro de la rueda con bombillas / eje / topes | wheel-rim.webp / wheel-hub.webp / wheel-peg.webp |
1024 × 1024 / 320 × 320 / 96 × 96 |
| Puntero de la rueda (lengüeta) / soporte | wheel-pointer.webp / wheel-stand.webp |
151 × 260 / 900 × 248 |
| Materiales de los sectores (texturas continuas) |
mat-cream.webp, mat-blue.webp, mat-ruby.webp,
mat-gold.webp
|
1024 × 1024 cada una |
| Sector BONUS y apuestas con imagen |
emblem-bonus.webp, emblem-crown.webp, emblem-star.webp /
palabra pintada word-bonus.webp
|
192 × 192 / 640 × 159 |
| Números pintados (rueda, tablero, premios) | font-gold.webp + font-gold.json |
1609 × 128 |
| Marco del tablero de apuestas / casillas de apuesta |
board.webp / tile-cream.webp, tile-blue.webp,
tile-ruby.webp, tile-gold.webp
|
1200 × 683 / 520 × 153 |
| Cinta de estado / placas de saldo y de nivel | ribbon.webp / plaque.webp |
900 × 278 / 560 × 124 |
| Botones turquesa de píldora (archivo llamado blue) / botones dorados / placa de premio | pill-blue.webp / btn-gold.webp / prize-plate.webp |
520 × 214 / 700 × 193 / 900 × 259 |
| Botón SPIN / botón redondo | btn-spin.webp / btn-round.webp |
360 × 360 / 160 × 160 |
| Fichas (de menor a mayor) | chip-0.webp ... chip-4.webp |
160 × 160 cada una |
| Monedas / sello del resultado / fichas del historial |
coin.webp / seal.webp / token-cream.webp,
token-blue.webp, token-ruby.webp, token-gold.webp
|
128 × 128 / 320 × 320 / 96 × 96 |
| Iconos (regalo, menú, reglas, sonido, silencio, pantalla completa, estrella) | icon-*.webp |
128 × 128 |
| Títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) |
title-bonus.webp, title-daily.webp, title-big.webp,
title-mega.webp, title-epic.webp
|
1000 × 305 (bonificación) |
| Textos |
source/src/locales/*.js o texts en saloon-showdown.config.js
|
|
| Colores, materiales de los sectores, rayos de luz | source/src/ui/theme.js |
|
| Diseño, tamaños, paleta | source/src/ui/styles.css (variables de la paleta al principio) |
|
| La rueda, sus pagos, fichas y límites |
math en saloon-showdown.config.js, o
source/src/logic/engine.js
|
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
Receta 1: cambiar los fondos
-
bg-landscape.webp(1672 × 940) se usa en ordenadores, tabletas y teléfonos en horizontal;bg-portrait.webp(941 × 1672) en teléfonos en vertical. - Deja la parte importante de la imagen en el centro: los bordes se recortan en pantallas de otras proporciones. Mantén el centro tranquilo para que la rueda destaque.
-
Guárdalos como WebP con los mismos nombres y sustitúyelos en
game/art/(y ensource/public/art/para mantener el código fuente al día). - Recarga sin la caché.
Receta 2: el logotipo y el presentador
-
El logotipo es
logo.webp(1000 × 554, fondo transparente). Aparece en la pantalla de título y en el podio. Mantén una proporción de ancho y alto parecida para que quepa en los mismos sitios. -
El presentador tiene cinco poses de 670 × 900 con fondo transparente:
mascot-idle(en espera),mascot-hope(la rueda se va frenando),mascot-pull(girando),mascot-cheer(una ganancia, la rueda de bonificación, las celebraciones) ymascot-aww(una pérdida). El juego las cambia en el mismo lugar, así que dibuja las cinco con el mismo encuadre (mismo tamaño y misma posición del cuerpo); si no, el presentador salta entre poses. - El podio (
podium.webp, 600 × 501) está delante del presentador en el ordenador. -
Para cambiar el nombre del juego, configura
brand: { name: 'My Show' }ensaloon-showdown.config.jsy cambia el<title>deindex.html.
Receta 3: el aspecto de la rueda
-
El aro con sus bombillas es
wheel-rim.webp(1024 × 1024, un cuadrado con el centro transparente). Los sectores se dibujan dentro de su círculo interior; ese círculo está medido ensource/src/ui/art.js(wheel.face, una fracción del radio de la imagen). Un aro nuevo con un círculo interior más ancho o más estrecho necesita cambiar este número (y compilar). -
Los sectores se rellenan con las cuatro texturas continuas
mat-cream,mat-blue,mat-ruby,mat-gold(1024 × 1024). Qué material corresponde a cada número se define ensource/src/ui/theme.js(wedge:1: 'cream',2: 'blue',mult: 'gold'...). La rueda de bonificación usabonusWedgespor turnos, con su valor más alto siempre en dorado. -
El eje, los topes, el puntero y el soporte son
wheel-hub,wheel-peg,wheel-pointerywheel-stand. Mantén sus proporciones. -
Los números de la rueda se escriben con la fuente pintada (
font-gold.webp+font-gold.json): solo tiene0-9 x K M + , .. Para volver a dibujarla, mantén los mismos caracteres; el JSON indica la posición x y el ancho de cada carácter en la imagen.
Receta 5: sonidos, voz y música
-
Cada sonido es un MP3 en
game/audio/(con los mismos nombres ensource/public/audio/). Sustituye un archivo por otro MP3 con el mismo nombre; los efectos cortos deben seguir siendo cortos (menos de 2 segundos). -
Música:
music.mp3(la mesa) ymusic-bonus.mp3(la rueda de bonificación y las grandes ganancias). Se repiten en bucle con un fundido cruzado. -
Locutor:
v-bets,v-nomore,v-x2,v-x7,v-bonus,v-big,v-mega,v-epic. -
Efectos:
coin,chip,chips,sweep,spin,peg,stop,stopSpecial,win,bigwin,stamp,bonus,line,count,click,nope,collect,wheel-win,levelup,coinrain,drumroll,applause,aww. -
Si falta un archivo, el juego reproduce en su lugar un sonido sintetizado integrado, así que nunca falla.
Para añadir un nombre de archivo nuevo, agrégalo a la lista
FILESal principio desource/src/audio/audio.jsy compila (un nombre de la lista sin archivo se pediría y daría error). El volumen inicial esaudio: { volume: 0.8 }ensaloon-showdown.config.js.
Receta 6: colores de los efectos y de la pantalla
-
En
source/src/ui/theme.jscambiaaccent(anillos, chispas, destellos),gold,ruby,bulbs(las luces del aro),tierRays(rayos de luz de las celebraciones BIG, MEGA y EPIC) yambient. Los colores se escriben como'#ffd36a'o[255, 214, 120]. -
La paleta de la interfaz está al principio de
source/src/ui/styles.css(las variables--gold-1...--panel-2). -
Los tiempos (cuánto gira la rueda, el muelle del puntero, las celebraciones) están en
source/src/ui/feel.js. -
Ejecuta
npm run buildy subedist/. Nada de estos archivos cambia un resultado ni un pago.
Receta 7: textos e idiomas
-
Para cambiar algunos textos en el alojamiento, añádelos a
saloon-showdown.config.js:texts: { tapToPlay: 'PLAY NOW' }cambia todos los idiomas;texts: { pt: { tapToPlay: 'JOGAR' } }solo el portugués. Los nombres (tapToPlay,placeBets...) son las claves desource/src/locales/en.js. -
Para ofrecer solo algunos idiomas:
languages: ['en', 'es']. Para abrir siempre en uno:language: 'es'. -
Para editar una traducción completa, cambia
source/src/locales/<code>.jsy ejecutanpm run localesynpm run build. -
Los títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) son imágenes (
title-*.webp): para traducirlos, sustituye las imágenes.
Receta 8: la rueda y sus pagos
La forma fácil
Elige una de las 6 ruedas incluidas con math: { preset: 'party' } en
saloon-showdown.config.js (studio, party, grand,
polar, show, classic; consulta la tabla de la guía principal). Sin
volver a compilar.
Tu propia rueda
También en saloon-showdown.config.js:
math: { wheel: { order: [...], pays: {...} } }.
-
orderes la lista de sectores en el sentido de las agujas del reloj desde el puntero: números ('1','2','5'...), multiplicadores ('x2','x7': la rueda vuelve a girar) y'@bonus'(la rueda de bonificación). Todos los sectores tienen la misma probabilidad, así que un número que ocupa más sectores gana más a menudo. paysindica lo que paga cada número a 1:{ 1: 1, 2: 2, 5: 5, 10: 10 }.-
maxRespins: cuántos x2/x7 seguidos como máximo (9 en la rueda por defecto).bonus: { order: ['5x', '10x', ...] }define la rueda de bonificación;bonus: nullla quita.
Compruébala
Guarda y, en source/, ejecuta npm run rtp: lee el archivo de configuración y
muestra el RTP de cada apuesta. El juego rechaza una rueda en la que alguna apuesta devolvería el 100 % o
más, una rueda con menos de 6 sectores, o con tantos que los números quedarían más pequeños de 13 px en un
teléfono (59 sectores con los números por defecto), y explica el motivo en la primera pantalla. Con tu
propia rueda, la lista de ruedas de OPTIONS se oculta (los jugadores no podrían volver a la tuya).
window.SALOON_SHOWDOWN_CONFIG = {
math: {
wheel: {
order: ['@bonus', '1', '2', '1', '5', '1', '2', 'x2', '1', '2', '1', '10', '1', '2', '1', '5'],
pays: { 1: 1, 2: 2, 5: 5, 10: 10 },
},
},
};
Son solo créditos de demostración ficticios.
Receta 9: fichas, límites y créditos iniciales
En saloon-showdown.config.js, dentro de math: { }:
startBalance(100.000): los créditos de un jugador nuevo (y de una recarga).-
chips(10, 50, 100, 500, 1.000): hasta 5 valores de ficha, primero el más pequeño (hay 5 imágenes de fichas). -
minTotal(10),maxSpot(5.000, en una casilla) ymaxTotal(20.000, en la mesa): los límites de la mesa. Ninguna ficha puede ser mayor quemaxSpot. maxWin(5.000): una ronda nunca paga más de este número de veces la apuesta total.
Un valor incorrecto detiene el juego en la primera pantalla con un mensaje que indica qué corregir.
Receta 10: niveles, el giro gratis diario y las monedas gratis
En saloon-showdown.config.js, dentro de progress: { } (las cantidades son
múltiplos de la ficha más pequeña):
-
levels: { enabled: false }desactiva los niveles (todas las fichas disponibles desde el principio).unlock: [1, 1, 1, 3, 6]es el nivel que desbloquea cada ficha;reward, el regalo al subir de nivel. -
daily: { everyHours: 24, stake: 10 }: el giro gratis diario de la rueda de bonificación (premio = su multiplicador × stake × la ficha más pequeña).alwaysReady: truelo ofrece en cada visita (una página de demostración);enabled: falselo desactiva. coins: { everyHours: 3, amount: 50 }: las monedas gratis del botón de regalo.-
winTiers: { big: 10, mega: 25, epic: 50 }(fuera deprogress): cuándo empiezan las celebraciones.
Receta 11: publicar tu versión
- Si solo cambiaste archivos de
game/en el alojamiento, ya está: recarga sin la caché. -
Si cambiaste
source/: ejecutanpm test, despuésnpm run build, y sube el contenido desource/dist/sobre la carpeta de tu juego. -
Conserva
SCOPE.mdjunto al juego y mantén visible el aviso de créditos. Cambiabrand.storageKeysi quieres que los jugadores empiecen con una partida guardada nueva.