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 WebP (GIMP, Photopea en el navegador, Krita) para el arte;
- un editor de audio que guarde MP3 (Audacity) para los sonidos.
Haz primero una copia: copia la carpeta entera del paquete antes de cambiar nada.
Hay dos formas de cambiar el juego:
-
Directamente en el alojamiento (sin herramientas): sustituye archivos de tu carpeta
game/subida (arte, audio,onyx-club.config.js). Rápido, pero esos cambios solo quedan en el alojamiento. -
En
source/y compilar (necesita Node.js, ver la guía principal): cambia archivos ensource/, ejecutanpm run buildy subesource/dist/. Úsalo para código, estilos,theme.js,feel.jsy traducciones.
Tras cada subida, recarga el juego sin caché (Ctrl+F5, o Cmd+Shift+R en Mac).
Un tema completamente nuevo es: imágenes nuevas con los mismos nombres en art/, sonidos nuevos
en audio/, los colores de source/src/ui/theme.js, los nombres de las mesas en los
idiomas, y el nombre en onyx-club.config.js y en index.html.
1
2
3
4
5
6
7
8
9
10
11
12
13
- saldo de créditos gratis de demostración (el + abre las monedas gratis)
- nivel del jugador y XP
- menú: ajustes, reglas, estadísticas, mesas
- reglas de esta mesa
- casilla de apuesta
- apuesta lateral Perfect Pairs
- apuesta lateral 21+3
- bandeja de fichas (las cinco fichas de la mesa)
- CLEAR: devuelve las apuestas
- REBET: repite las apuestas de la última ronda
- ×2: dobla las apuestas
- DEAL: empieza la ronda
- el aviso de créditos gratis (mantenlo visible)
Qué archivo es cada parte de la pantalla
| En pantalla | Archivo (en game/art/, el mismo nombre en source/public/art/) |
|---|---|
| Ambiente detrás de la primera mesa (horizontal / vertical) | bg-landscape.webp, bg-portrait.webp |
| La mesa delante del crupier (horizontal / vertical) | table-landscape.webp, table-portrait.webp |
| Ambientes y mesas de la segunda y la tercera mesa |
bg-stage-*.webp, table-stage-*.webp, bg-rooftop-*.webp,
table-rooftop-*.webp
|
| Imágenes de las mesas en el carrusel de la sala |
thumb-lounge.webp, thumb-stage.webp, thumb-rooftop.webp
|
| Logo | logo.webp |
| El crupier (una pantera negra de esmoquin marfil que reparte, aplaude, se encoge de hombros y saluda) |
bear-sprites/*.webp (una imagen por pose) y bear-sprites/sprites.json
|
| El crupier en los paneles (ruleta, recarga, subir de nivel, reglas) |
bear-cheer.webp, bear-cheer-full.webp, bear-clipboard.webp,
bear-peek.webp, bear-sack.webp, bear-thumbs.webp
|
| Cartas (las 52 y el reverso) | cards.webp (una hoja) |
| Zapato de cartas / bandeja de descarte | shoe.webp / discard.webp |
| Fichas: en la bandeja / vistas desde arriba / vistas de lado |
chip-rack-0..5.webp / chip-top-0..5.webp /
chip-side-0..5.webp
|
| Bandeja de fichas y la barra de la consola (pantallas anchas) | rack.webp, console-bar.webp |
| Botones y placas |
btn-blue/teal/navy/violet/gray/pill.webp, banner.webp,
plaque.webp, panel.webp, row.webp,
round-btn.webp, badge*.webp, level-badge.webp
|
| Paneles y títulos de resultado |
panel-win/push/bigwin/crest.webp, banner-bust.webp,
title-*.webp
|
| Iconos | icon-*.webp |
| Ruleta diaria |
wheel.webp, wheel-hub.webp, wheel-pointer.webp,
wheel-base.webp, title-wheel.webp, montones de monedas
pile-0..2.webp
|
| Estadísticas y logros | stat-*.webp, medal-*.webp |
| Decoraciones (ornamentos Art Déco, polvo dorado y chispas) |
crystal-0..3.webp, flake-0..5.webp, spark-0..3.webp,
coin.webp, ice-arrow.webp, gift-sack.webp
|
| Cifras pintadas: claras (apuestas, totales) / doradas (saldo, victorias) |
font-ice.webp + .json / font-gold.webp + .json
|
| Textos | source/src/locales/*.js o texts en onyx-club.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 (base), luego styles-placement.css,
styles-polish.css, styles-final.css
|
Receta 1: cambiar el ambiente y la mesa
-
bg-landscape.webpmide 1672 × 941 (ordenadores y móviles en horizontal),bg-portrait.webpmide 941 × 1672 (móviles en vertical).table-landscape.webpytable-portrait.webptienen los mismos tamaños y se dibujan sobre el ambiente, delante del crupier: conserva su parte superior transparente. - Deja lo importante de la imagen en el centro: los bordes se recortan en pantallas de otras proporciones. El borde del fondo de la mesa debe quedar a la misma altura, porque las patas del crupier se apoyan en él.
- Guarda en WebP con los mismos nombres y sustitúyelos.
Receta 2: el logo y el crupier
-
El logo es
logo.webp(900 × 619, fondo transparente). Mantén una proporción parecida para que quepa en el mismo sitio. -
El crupier es un conjunto de imágenes completas de 1229 × 819, una por pose (
rest,deal,wave-a,wave-b,clap-open,clap-shut,cheeks,scratch,chest,shrug,up,fist,curious,blink), algunas con una copia-frontcuyas patas quedan delante del borde de la mesa. Dibuja tu personaje en todas las poses al mismo tamaño y en el mismo lugar de la imagen, para que las poses cambien sin saltos.sprites.jsonindica el tamaño de las imágenes y el punto donde las patas tocan la mesa (contact). -
Las seis imágenes de los paneles (
bear-cheer.webp...) son el mismo personaje en la ruleta diaria, la recarga, la subida de nivel y las reglas. -
Para cambiar el nombre del juego, pon también
brand: { name: 'Mi Juego' }enonyx-club.config.js, el<title>y el textoaltdel logo enindex.html, ynameensource/src/ui/theme.js. La línea pequeña del estudio bajo el logo en la pantalla de inicio es<p class="maker">enindex.html: escribe ahí tu nombre o borra la línea.
Receta 3: las tres mesas, sus ambientes y una cuarta mesa
-
Cada mesa de
rules.tablestiene unid(lounge, stage, rooftop). La primera mesa usabg-landscape/portraitytable-landscape/portrait; las demás usanbg-<id>-landscape/portrait.webpytable-<id>-landscape/portrait.webp. El carrusel muestrathumb-<id>.webp(420 × 507). -
Los nombres que se muestran son los textos
table_<id>de los idiomas (por ejemplotable_stage), así que una mesa se puede renombrar por idioma contexts. -
Una mesa nueva: añade una línea a
rules.tablesenonyx-club.config.js, por ejemplo{ id: 'vip', minBet: 500, maxBet: 20000, chips: [500, 1000, 2000, 5000, 20000], unlock: 20 }, y su nombretexts: { table_vip: 'MESA VIP' }. Juega en el primer ambiente. Para darle su propio ambiente, añadebg-vip-*.webp,table-vip-*.webpythumb-vip.webp, añade'vip'a la listaSCENESdesource/src/main.jsy copia las cuatro reglas[data-scene='rooftop']del final desource/src/ui/styles-final.csscambiándolas porvip; después compila.
Receta 4: cartas y fichas
-
cards.webpmide 2600 × 1400: 13 columnas (A, 2 a 10, J, Q, K) y 5 filas (picas, corazones, diamantes, tréboles, y el reverso en la última fila), cada carta de 200 × 280. Conserva la misma cuadrícula. -
Cada color de ficha tiene tres imágenes con el mismo número:
chip-rack-N(en la bandeja),chip-top-N(vista desde arriba, 256 × 256) ychip-side-N(una pila vista de lado). Los valores son loschipsde cada mesa enrules.tables; el color de cada posición de la bandeja eschipColorsentheme.js. El juego escribe el valor en la ficha.
Receta 6: sonidos, voz y música
-
Cada sonido es un MP3 en
game/audio/(mismos nombres ensource/public/audio/). Sustituye un archivo por otro MP3 con el mismo nombre; los efectos cortos deben ser cortos (menos de 2 segundos). -
Música:
music.mp3(las mesas),music-wheel.mp3(la ruleta diaria) ymusic-bigwin.mp3(victorias grandes). Se repiten en bucle. -
Locutor:
v-welcome,v-place-bets,v-blackjack,v-dealer-busts,v-big,v-mega,v-epic,v-level-up. -
Efectos: las cartas (
card,card-land,flip,shuffle,sweep), las fichas (chip,chips-win,chips-lose), resultados (win,lose,push,bust,blackjack,bigwin,shatter), monedas (coin,coinrain,count,collect,levelup), la ruleta diaria (wheel-tick,wheel-win), yclick,nope,whoosh. -
Si falta una pista opcional, el juego no se rompe. El volumen inicial es
audio: { volume: 0.8 }enonyx-club.config.js; el jugador tiene interruptores separados para música, efectos y voz en SETTINGS. La lista de archivos y sus volúmenes está al principio desource/src/audio/audio.js.
Receta 7: colores, efectos y tiempos
-
En
source/src/ui/theme.jscambiaaccent(anillos, chispas, destellos),gold,ambient(el polvo dorado que sube despacio a la luz de las lámparas),rays(los rayos de luz detrás de cada celebración) ychipColors. Los colores se escriben como'#6fe9ff'o[150, 230, 255]. -
En
source/src/ui/feel.jscada tiempo tiene un nombre y un comentario: la velocidad de las cartas al volar y girar, las fichas, el turno del crupier, cuánto dura un resultado, las celebraciones.speed.fastes el ajuste FAST. Números más pequeños hacen el juego más rápido. -
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 una carta o un pago.
Receta 8: textos y los 14 idiomas
-
Para cambiar algunos textos en el alojamiento, añádelos a
onyx-club.config.js:texts: { tapToPlay: 'JUGAR' }cambia todos los idiomas;texts: { es: { tapToPlay: 'JUGAR' } }solo el español. Los nombres (tapToPlay,deal,table_lounge...) 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 entera, cambia
source/src/locales/<código>.js(en pt es fr de it nl pl tr ru id ja ko zh), ejecutanpm run localesynpm run build.
Receta 9: reglas, límites de las mesas y los créditos iniciales
En onyx-club.config.js, dentro de rules: { }:
-
preset:'vegas','european'o'social'; después cualquier regla suelta:decks,dealerHitsSoft17,blackjackPays([3, 2]o[6, 5]...),double,surrender,insurance,maxHands. -
tables: la apuesta mínima y máxima, las cinco fichas y el nivel de apertura de cada mesa. -
sideBets: { perfectPairs: { enabled: false } }quita una apuesta lateral;payscambia lo que paga. startBalance: los créditos de un jugador nuevo y de la recarga gratis.-
Tras un cambio, ejecuta
npm run edgeensource/para ver la ventaja de la casa de tu mesa. Un valor incorrecto se rechaza con un mensaje.
Son solo créditos ficticios de demostración.
Receta 10: niveles, ruleta diaria y monedas gratis
En onyx-club.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 las 12 porciones. coins: { everyHours: 3, amount: 100 }define el botón de regalo.-
levels: { enabled: false }desactiva los niveles (todas las mesas abiertas desde el principio);needyrewarddefinen la velocidad de los niveles y lo que dan.
Los importes son múltiplos de la apuesta mínima de la primera mesa.
Receta 11: publicar tu versión
- Si solo cambiaste archivos de
game/en el alojamiento, ya está: recarga sin caché. -
Si cambiaste
source/: ejecutanpm test, luegonpm run build, y sube el contenido desource/dist/sobre la carpeta del juego.npm run robot(guía principal) juega unas rondas para comprobar que nada se rompió. -
Conserva
SCOPE.mdjunto al juego y el aviso de créditos visible. Cambiabrand.storageKeysi quieres que los jugadores empiecen con una partida nueva.