Onyx Club Blackjack 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 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:

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

Apostando en la primera mesa (MESA SALÓN): tres casillas en una pantalla ancha, las apuestas laterales junto a la central. 1 2 3 4 5 6 7 8 9 10 11 12 13
Apostando en la primera mesa (MESA SALÓN): tres casillas en una pantalla ancha, las apuestas laterales junto a la central.
  1. saldo de créditos gratis de demostración (el + abre las monedas gratis)
  2. nivel del jugador y XP
  3. menú: ajustes, reglas, estadísticas, mesas
  4. reglas de esta mesa
  5. casilla de apuesta
  6. apuesta lateral Perfect Pairs
  7. apuesta lateral 21+3
  8. bandeja de fichas (las cinco fichas de la mesa)
  9. CLEAR: devuelve las apuestas
  10. REBET: repite las apuestas de la última ronda
  11. ×2: dobla las apuestas
  12. DEAL: empieza la ronda
  13. 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

  1. bg-landscape.webp mide 1672 × 941 (ordenadores y móviles en horizontal), bg-portrait.webp mide 941 × 1672 (móviles en vertical). table-landscape.webp y table-portrait.webp tienen los mismos tamaños y se dibujan sobre el ambiente, delante del crupier: conserva su parte superior transparente.
  2. 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.
  3. Guarda en WebP con los mismos nombres y sustitúyelos.

Receta 3: las tres mesas, sus ambientes y una cuarta mesa

  1. Cada mesa de rules.tables tiene un id (lounge, stage, rooftop). La primera mesa usa bg-landscape/portrait y table-landscape/portrait; las demás usan bg-<id>-landscape/portrait.webp y table-<id>-landscape/portrait.webp. El carrusel muestra thumb-<id>.webp (420 × 507).
  2. Los nombres que se muestran son los textos table_<id> de los idiomas (por ejemplo table_stage), así que una mesa se puede renombrar por idioma con texts.
  3. Una mesa nueva: añade una línea a rules.tables en onyx-club.config.js, por ejemplo { id: 'vip', minBet: 500, maxBet: 20000, chips: [500, 1000, 2000, 5000, 20000], unlock: 20 }, y su nombre texts: { table_vip: 'MESA VIP' }. Juega en el primer ambiente. Para darle su propio ambiente, añade bg-vip-*.webp, table-vip-*.webp y thumb-vip.webp, añade 'vip' a la lista SCENES de source/src/main.js y copia las cuatro reglas [data-scene='rooftop'] del final de source/src/ui/styles-final.css cambiándolas por vip; después compila.

Receta 4: cartas y fichas

  1. cards.webp mide 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.
  2. 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) y chip-side-N (una pila vista de lado). Los valores son los chips de cada mesa en rules.tables; el color de cada posición de la bandeja es chipColors en theme.js. El juego escribe el valor en la ficha.

Receta 5: botones y placas

Los botones y las placas se estiran conservando intactos sus extremos decorados ("9 partes"). Al redibujar btn-*.webp, banner.webp, plaque.webp, panel.webp o row.webp, conserva el mismo tamaño de imagen y el mismo ancho de los extremos decorados, si no los extremos se estiran. Los cortes están en source/src/ui/art.js (plates), medidos sobre el arte original.

Receta 6: sonidos, voz y música

  1. Cada sonido es un MP3 en game/audio/ (mismos nombres en source/public/audio/). Sustituye un archivo por otro MP3 con el mismo nombre; los efectos cortos deben ser cortos (menos de 2 segundos).
  2. Música: music.mp3 (las mesas), music-wheel.mp3 (la ruleta diaria) y music-bigwin.mp3 (victorias grandes). Se repiten en bucle.
  3. Locutor: v-welcome, v-place-bets, v-blackjack, v-dealer-busts, v-big, v-mega, v-epic, v-level-up.
  4. 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), y click, nope, whoosh.
  5. Si falta una pista opcional, el juego no se rompe. El volumen inicial es audio: { volume: 0.8 } en onyx-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 de source/src/audio/audio.js.

Receta 7: colores, efectos y tiempos

  1. En source/src/ui/theme.js cambia accent (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) y chipColors. Los colores se escriben como '#6fe9ff' o [150, 230, 255].
  2. En source/src/ui/feel.js cada 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.fast es el ajuste FAST. Números más pequeños hacen el juego más rápido.
  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 una carta o un pago.

Receta 8: textos y los 14 idiomas

  1. 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 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 entera, cambia source/src/locales/<código>.js (en pt es fr de it nl pl tr ru id ja ko zh), ejecuta npm run locales y npm 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; pays cambia lo que paga.
  • startBalance: los créditos de un jugador nuevo y de la recarga gratis.
  • Tras un cambio, ejecuta npm run edge en source/ 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); prizes y weights definen 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); need y reward definen 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

  1. Si solo cambiaste archivos de game/ en el alojamiento, ya está: recarga sin caché.
  2. Si cambiaste source/: ejecuta npm test, luego npm run build, y sube el contenido de source/dist/ sobre la carpeta del juego. npm run robot (guía principal) juega unas rondas para comprobar que nada se rompió.
  3. Conserva 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.