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
.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 la carpeta completa del paquete antes de cambiar nada.
Hay dos formas de cambiar el juego:
-
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. -
En
source/y compilando (necesita Node.js, consulta la guía principal): cambia archivos ensource/, ejecutanpm run buildy subesource/dist/. Usa esta forma para el código, los estilos,theme.js,feel.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
16
- Saldo: los créditos de demostración gratis
- Nivel: crece al jugar, da créditos gratis y desbloquea las fichas mayores
- Regalos: monedas gratis, la ruleta diaria y las misiones del día
- Menú: INFO, números, apuestas favoritas, juego automático, turbo, sonido, pantalla completa
- La rueda: 13 casillas; toque un número para apostar en él y en sus dos vecinos
- Últimos resultados (toque: la página DATOS)
- APUESTA: lo que hay en la mesa; tras la ronda, GANADO
- La mesa: toque un número, una línea, una esquina o una casilla exterior para poner la ficha elegida
- Fichas: elija el valor; las bloqueadas se abren en niveles más altos
- Deshacer la última ficha
- Limpiar la mesa
- Repetir: las apuestas de la última ronda
- ×2: duplica todas las apuestas
- GIRAR (manténgalo pulsado: juego automático)
- Turbo sí/no
- 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
-
bg-landscape.webpmide 1672 × 941 (ordenadores y teléfonos en horizontal),bg-portrait.webpmide 941 × 1672 (teléfonos en vertical). - 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.
- Guarda en WebP con los mismos nombres y reemplázalos.
Receta 2: el logotipo y el crupier
-
El logotipo es
logo.webp(1744 × 866, fondo transparente). Mantén una proporción parecida entre ancho y alto para que quepa en el mismo sitio. -
El crupier tiene cuatro poses de 720 × 1100 con fondo transparente:
mascot-idle(esperando),mascot-hype(lanzando la bola, la pantalla de título),mascot-watch(siguiendo la bola) ymascot-cheer(victorias). Reemplaza las cuatro con el mismo personaje, en el mismo lugar de la imagen, para que las poses cambien sin saltos. -
Para cambiar el nombre del juego, pon también
brand: { name: 'My Game' }enbig-top.config.jsy el<title>enindex.html.
Receta 3: la ruleta
-
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. -
El orden de los números en la ruleta y cuáles son rojos son ajustes, no arte:
rules: { wheel: [...], red: [...] }enbig-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). -
Los colores de las casillas están en
source/src/ui/roulette.js(la listainkal principio debuildRotor); el brillo de la casilla ganadora esglowensource/src/ui/theme.js.
Receta 4: las fichas
-
Cada valor de ficha tiene dos imágenes con el mismo número:
chip-N.webp(160 × 160, vista desde arriba, en la bandeja) ychip3d-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í quechip-5es el color de un sexto valor si añades uno. -
Los valores en sí son
rules.chipsenbig-top.config.js(de 1 a 6 valores, de menor a mayor). Que sean pares: las mitades en el 0 se redondean hacia abajo. - Dibuja el valor en la ficha o déjala en blanco: el juego escribe el valor encima.
Receta 6: sonidos, voz y música
-
Cada sonido es un MP3 en
game/audio/(con los mismos nombres ensource/public/audio/). Reemplaza un archivo por otro MP3 con el mismo nombre; los efectos cortos deben ser cortos (menos de 2 segundos). -
Música:
music.mp3(la mesa) ymusic-wheel.mp3(la ruleta diaria). Se repiten en bucle. -
Locutor:
v-place(hagan sus apuestas),v-nomore(no va más),v-n0av-n12(el resultado),v-luckyyv-luckyhit(números de la suerte),v-big,v-mega,v-epic. -
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), yclick,nope. -
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 }enbig-top.config.js.
Receta 7: colores, efectos y tiempos
-
En
source/src/ui/theme.jscambiaaccent(anillos y chispas),gold,glow(la casilla y la celda ganadoras),tierRays(rayos de luz de las celebraciones) yambient(el polvo dorado que sube con la luz de la marquesina). Los colores se escriben como'#ffd76a'o[255, 214, 110]. -
En
source/src/ui/feel.jscada 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. -
La paleta de la interfaz está al principio de
source/src/ui/styles.css(las variables--). -
Ejecuta
npm run buildy subedist/. Nada en estos archivos cambia un resultado ni un pago.
Receta 8: textos e idiomas
-
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 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>.js, ejecutanpm run localesynpm 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,multsyweightscambian cuántos hay y lo grandes que son. -
payscambia 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 rtpensource/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);prizesyweightsdefinen los sectores. coins: { everyHours: 3, amount: 50 }configura el botón de regalo.-
missions: { enabled: false }desactiva las misiones diarias;perDayyrewardlas cambian. -
levels: { enabled: false }desactiva los niveles (todas las fichas abiertas desde el principio);unlockindica 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
- Si solo cambiaste archivos de
game/en el hosting, 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. -
Mantén
SCOPE.mdjunto al juego y el aviso de créditos visible. Cambiabrand.storageKeysi quieres que los jugadores empiecen con una partida nueva.