Big Top Roulette 1.0.0: guía de personalización

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

Guía principal del comprador

EnglishPortuguêsEspañol

Antes de empezar

Esta guía es para quien no programa. Cada receta dice qué archivo abrir y qué cambiar. Necesitas:

  • un editor de texto (Visual Studio Code, Notepad++, TextEdit en modo 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 la carpeta completa del paquete antes de cambiar nada.

Hay dos formas de cambiar el juego:

  1. Directamente en el hosting (sin herramientas): reemplaza archivos en la carpeta game/ que subiste (arte, audio, big-top.config.js). Es rápido, pero estos cambios solo existen en el hosting.
  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/. Usa esta forma para el código, los estilos, theme.js, feel.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 apuestas: pleno, caballo, cuadro, columna y apuestas sencillas 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
La mesa con apuestas: pleno, caballo, cuadro, columna y apuestas sencillas
  1. Saldo: los créditos de demostración gratis
  2. Nivel: crece al jugar, da créditos gratis y desbloquea las fichas mayores
  3. Regalos: monedas gratis, la ruleta diaria y las misiones del día
  4. Menú: INFO, números, apuestas favoritas, juego automático, turbo, sonido, pantalla completa
  5. La rueda: 13 casillas; toque un número para apostar en él y en sus dos vecinos
  6. Últimos resultados (toque: la página DATOS)
  7. APUESTA: lo que hay en la mesa; tras la ronda, GANADO
  8. La mesa: toque un número, una línea, una esquina o una casilla exterior para poner la ficha elegida
  9. Fichas: elija el valor; las bloqueadas se abren en niveles más altos
  10. Deshacer la última ficha
  11. Limpiar la mesa
  12. Repetir: las apuestas de la última ronda
  13. ×2: duplica todas las apuestas
  14. GIRAR (manténgalo pulsado: juego automático)
  15. Turbo sí/no
  16. El aviso de los créditos (manténgalo visible: SCOPE.md)

Qué archivo es cada parte de la pantalla

En pantalla Archivo (en game/, con el mismo nombre en source/public/)
Fondo (horizontal / vertical) art/bg-landscape.webp, art/bg-portrait.webp
Logotipo art/logo.webp
Crupier (el león maestro de ceremonias) art/mascot-idle.webp, art/mascot-watch.webp, art/mascot-hype.webp, art/mascot-cheer.webp
Ruleta: aro dorado con la pista de la bola / torreta del centro art/rim.webp / art/hub.webp (las casillas y sus números se dibujan por código)
Marco alrededor de la mesa art/frame.webp
Fichas: en la bandeja / sobre la mesa y en el aire art/chip-0.webp ... art/chip-5.webp / art/chip3d-0.webp ... art/chip3d-5.webp
Bandeja de fichas art/tray.webp
Marcador de cristal sobre el número ganador art/dolly.webp
El rastrillo del crupier art/rake-head.webp, art/rake-handle.webp
Botón GIRAR art/spin.webp
Botones dorados / píldoras / placas / botones redondos art/btn-gold.webp, art/pill.webp, art/plaque.webp, art/btn-blank.webp, art/btn-close.webp
Iconos (menú, info, sonido, pantalla completa, regalo, deshacer, limpiar, repetir, automático, favoritas, turbo...) art/icon-*.webp
Títulos de celebración (BIG WIN, MEGA WIN, EPIC WIN) art/title-big.webp, art/title-mega.webp, art/title-epic.webp, cinta art/banner.webp
Ruleta diaria art/wheel.webp, art/wheel-hub.webp, art/wheel-pointer.webp, art/title-wheel.webp, montones de monedas art/pile-0..2.webp
Números pintados: dorados (cantidades) / marfil (mesa, ruleta, resultados) art/font-gold.webp + .json / art/font-board.webp + .json
Monedas y destellos art/coin.webp, art/burst.webp, art/shard-0..5.webp
Textos source/src/locales/*.js o texts en big-top.config.js
Colores de los efectos source/src/ui/theme.js
Tiempos de la sensación de juego source/src/ui/feel.js
Diseño, tamaños, paleta source/src/ui/styles.css (estructura común) y source/src/ui/game.css (la mesa de ruleta)

Receta 1: cambiar los fondos

  1. bg-landscape.webp mide 1672 × 941 (ordenadores y teléfonos en horizontal), bg-portrait.webp mide 941 × 1672 (teléfonos en vertical).
  2. Deja la parte importante de la imagen en el centro: los bordes se recortan en pantallas de otras proporciones. Deja tranquila la parte de abajo: ahí están la mesa y la ruleta.
  3. Guarda en WebP con los mismos nombres y reemplázalos.

Receta 3: la ruleta

  1. Las 13 casillas, sus colores y sus números los dibuja el juego, así que siempre coinciden con las reglas. Solo el aro dorado (rim.webp, 900 × 900, transparente en el centro) y la torreta (hub.webp, 420 × 420) son imágenes. Mantén sus tamaños y deja la pista de la bola del aro donde está: la bola corre por ella.
  2. El orden de los números en la ruleta y cuáles son rojos son ajustes, no arte: rules: { wheel: [...], red: [...] } en big-top.config.js (el orden de fábrica es 0, 7, 2, 9, 4, 12, 6, 1, 8, 3, 10, 5, 11; rojos: 1, 3, 5, 7, 9, 12).
  3. Los colores de las casillas están en source/src/ui/roulette.js (la lista ink al principio de buildRotor); el brillo de la casilla ganadora es glow en source/src/ui/theme.js.

Receta 4: las fichas

  1. Cada valor de ficha tiene dos imágenes con el mismo número: chip-N.webp (160 × 160, vista desde arriba, en la bandeja) y chip3d-N.webp (la misma ficha vista con el ángulo de la mesa, con su canto a rayas, sobre la mesa y en el aire). La ficha 0 es el valor más pequeño; la mesa de fábrica usa cinco valores (10, 50, 100, 500, 1000), así que chip-5 es el color de un sexto valor si añades uno.
  2. Los valores en sí son rules.chips en big-top.config.js (de 1 a 6 valores, de menor a mayor). Que sean pares: las mitades en el 0 se redondean hacia abajo.
  3. Dibuja el valor en la ficha o déjala en blanco: el juego escribe el valor encima.

Receta 5: botones y placas

Los botones y las placas se estiran manteniendo intactos sus dos extremos ("9-slice", 9 pedazos). Si vuelves a dibujar btn-gold.webp, pill.webp, plaque.webp o frame.webp, mantén el mismo tamaño de imagen y el mismo ancho de los extremos decorados; si no, los extremos se estiran. Las medidas de corte están en las hojas de estilo (border-image) por si necesitas cambiarlas.

Receta 6: sonidos, voz y música

  1. Cada sonido es un MP3 en game/audio/ (con los mismos nombres en source/public/audio/). Reemplaza un archivo por otro MP3 con el mismo nombre; los efectos cortos deben ser cortos (menos de 2 segundos).
  2. Música: music.mp3 (la mesa) y music-wheel.mp3 (la ruleta diaria). Se repiten en bucle.
  3. Locutor: v-place (hagan sus apuestas), v-nomore (no va más), v-n0 a v-n12 (el resultado), v-lucky y v-luckyhit (números de la suerte), v-big, v-mega, v-epic.
  4. Efectos: la bola (launch, ball-roll, ball-ting, ball-tock, ball-settle, whoosh), las fichas (chip, chip-stack, chips-rake, chips-pay, dolly), las victorias (win, bigwin, coin, coinrain, count, shatter, levelup), los números de la suerte (lucky-strike, lucky-hit), la ruleta diaria y los regalos (wheel-tick, drumroll, wheel-win, collect), y click, nope.
  5. Si falta un archivo, el juego reproduce en su lugar un sonido sintetizado incorporado, así que nunca se rompe. El volumen inicial es audio: { volume: 0.8 } en big-top.config.js.

Receta 7: colores, efectos y tiempos

  1. En source/src/ui/theme.js cambia accent (anillos y chispas), gold, glow (la casilla y la celda ganadoras), tierRays (rayos de luz de las celebraciones) y ambient (el polvo dorado que sube con la luz de la marquesina). Los colores se escriben como '#ffd76a' o [255, 214, 110].
  2. En source/src/ui/feel.js cada tiempo de una ronda tiene un nombre y un comentario: lo rápido que vuelan las fichas, cuánto dura la cámara lenta del rebote decisivo, la repetición de una victoria EPIC, el rastrillo, las torres del pago, el conteo de la celebración. Los números más pequeños hacen la ronda más rápida.
  3. La paleta de la interfaz está al principio de source/src/ui/styles.css (las variables --).
  4. Ejecuta npm run build y sube dist/. Nada en estos archivos cambia un resultado ni un pago.

Receta 8: textos e idiomas

  1. Para cambiar algunos textos en el hosting, añádelos a big-top.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, ejecuta npm run locales y npm run build.

Receta 9: las reglas de la mesa y los créditos iniciales

En big-top.config.js, dentro de rules: { }:

  • zeroRule: 'half' (las apuestas perdedoras que no cubren el 0 recuperan la mitad cuando la bola cae en el 0), 'evenHalf' (solo las apuestas 1:1) o 'none' (la mesa clásica).
  • lucky: { enabled: false } juega sin números de la suerte (el pleno paga 11 a 1); count, mults y weights cambian cuántos hay y lo grandes que son.
  • pays cambia lo que paga un tipo de apuesta; startBalance, los créditos de un jugador nuevo; limits, lo máximo en una casilla y en la mesa.
  • Después de un cambio, ejecuta npm run rtp en source/ para ver el retorno de cada apuesta. Un ajuste que devolvería más del 100% se rechaza con un mensaje.

Son solo créditos de demostración ficticios.

Receta 10: niveles, ruleta diaria, monedas gratis y misiones

En big-top.config.js, dentro de progress: { }:

  • wheel: { alwaysReady: false, everyHours: 24 } ofrece la ruleta una vez al día (la demostración la ofrece en cada visita); prizes y weights definen los sectores.
  • coins: { everyHours: 3, amount: 50 } configura el botón de regalo.
  • missions: { enabled: false } desactiva las misiones diarias; perDay y reward las cambian.
  • levels: { enabled: false } desactiva los niveles (todas las fichas abiertas desde el principio); unlock indica en qué nivel se abre cada ficha.

Las cantidades son múltiplos de la ficha más pequeña.

Receta 11: publicar tu versión

  1. Si solo cambiaste archivos de game/ en el hosting, 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. Mantén SCOPE.md junto al juego y el aviso de créditos visible. Cambia brand.storageKey si quieres que los jugadores empiecen con una partida nueva.