Saloon Showdown 1.0.0: guía de personalización

Recetas paso a paso para cambiar arte, sonidos, textos, la rueda y los ajustes, sin programar.

Guía principal del comprador

EnglishPortuguêsEspañol

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 .js y .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:

  1. 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.
  2. En source/ y compilando (necesita Node.js, consulta la guía principal): cambia archivos en source/, ejecuta npm run build y sube source/dist/. Úsalo para el código, los estilos, theme.js, engine.js y las traducciones.

Después de cada subida, recarga el juego sin la caché (Ctrl+F5, o Cmd+Shift+R en un Mac).

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

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
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

Receta 1: cambiar los fondos

  1. 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.
  2. 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.
  3. Guárdalos como WebP con los mismos nombres y sustitúyelos en game/art/ (y en source/public/art/ para mantener el código fuente al día).
  4. Recarga sin la caché.

Receta 3: el aspecto de la rueda

  1. 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 en source/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).
  2. 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 en source/src/ui/theme.js (wedge: 1: 'cream', 2: 'blue', mult: 'gold'...). La rueda de bonificación usa bonusWedges por turnos, con su valor más alto siempre en dorado.
  3. El eje, los topes, el puntero y el soporte son wheel-hub, wheel-peg, wheel-pointer y wheel-stand. Mantén sus proporciones.
  4. Los números de la rueda se escriben con la fuente pintada (font-gold.webp + font-gold.json): solo tiene 0-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 4: placas, botones y fichas

Las placas y los botones se estiran manteniendo intactos sus extremos decorados ("9-slice", 9 pedazos). Cuando vuelvas a dibujar board.webp, tile-*.webp, ribbon.webp, plaque.webp, pill-blue.webp, btn-gold.webp o prize-plate.webp, mantén el mismo tamaño de imagen y el mismo ancho del borde decorado, y deja el centro liso: el juego escribe el texto ahí. Si una placa nueva tiene el borde más grueso o más fino, cambia sus números tanto en source/src/ui/plates.css (corte de border-image) como en source/src/ui/art.js (cut y glass, la zona lisa donde puede ir el texto), y después compila.

Las fichas son chip-0.webp a chip-4.webp (160 × 160), primero la de menor valor; el juego escribe el valor encima.

Receta 5: sonidos, voz y música

  1. Cada sonido es un MP3 en game/audio/ (con los mismos nombres en source/public/audio/). Sustituye un archivo por otro MP3 con el mismo nombre; los efectos cortos deben seguir siendo cortos (menos de 2 segundos).
  2. Música: music.mp3 (la mesa) y music-bonus.mp3 (la rueda de bonificación y las grandes ganancias). Se repiten en bucle con un fundido cruzado.
  3. Locutor: v-bets, v-nomore, v-x2, v-x7, v-bonus, v-big, v-mega, v-epic.
  4. 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.
  5. 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 FILES al principio de source/src/audio/audio.js y compila (un nombre de la lista sin archivo se pediría y daría error). El volumen inicial es audio: { volume: 0.8 } en saloon-showdown.config.js.

Receta 6: colores de los efectos y de la pantalla

  1. En source/src/ui/theme.js cambia accent (anillos, chispas, destellos), gold, ruby, bulbs (las luces del aro), tierRays (rayos de luz de las celebraciones BIG, MEGA y EPIC) y ambient. Los colores se escriben como '#ffd36a' o [255, 214, 120].
  2. La paleta de la interfaz está al principio de source/src/ui/styles.css (las variables --gold-1 ... --panel-2).
  3. Los tiempos (cuánto gira la rueda, el muelle del puntero, las celebraciones) están en source/src/ui/feel.js.
  4. Ejecuta npm run build y sube dist/. Nada de estos archivos cambia un resultado ni un pago.

Receta 7: textos e idiomas

  1. 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 de source/src/locales/en.js.
  2. Para ofrecer solo algunos idiomas: languages: ['en', 'es']. Para abrir siempre en uno: language: 'es'.
  3. Para editar una traducción completa, cambia source/src/locales/<code>.js y ejecuta npm run locales y npm run build.
  4. 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: {...} } }.

  • order es 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.
  • pays indica 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: null la 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) y maxTotal (20.000, en la mesa): los límites de la mesa. Ninguna ficha puede ser mayor que maxSpot.
  • 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: true lo ofrece en cada visita (una página de demostración); enabled: false lo desactiva.
  • coins: { everyHours: 3, amount: 50 }: las monedas gratis del botón de regalo.
  • winTiers: { big: 10, mega: 25, epic: 50 } (fuera de progress): cuándo empiezan las celebraciones.

Receta 11: publicar tu versión

  1. Si solo cambiaste archivos de game/ en el alojamiento, ya está: recarga sin la caché.
  2. Si cambiaste source/: ejecuta npm test, después npm run build, y sube el contenido de source/dist/ sobre la carpeta de tu juego.
  3. Conserva SCOPE.md junto al juego y mantén visible el aviso de créditos. Cambia brand.storageKey si quieres que los jugadores empiecen con una partida guardada nueva.