Rune Hoard 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 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, rune-hoard.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, los colores de los efectos y las traducciones.

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

La pantalla del juego (1280×720) después de una línea ganadora. 1 2 3 4 5 6 7 8 9 10 11 12 13 14
La pantalla del juego (1280×720) después de una línea ganadora.
  1. Saldo de créditos de demostración (+ = recarga gratis cuando se acaba)
  2. Jackpots del bono Locked Coins
  3. Nivel del jugador
  4. Monedas gratis (cada pocas horas)
  5. Menú: reglas, sonido, pantalla completa
  6. BUY BONUS (se paga con créditos de demostración)
  7. Rodillos: 5 × 3, 20 líneas
  8. Apuesta – / +
  9. MAX BET (apuesta máxima)
  10. Ganancia de la ronda y la línea premiada
  11. Girar (Espacio o Intro)
  12. Giro automático
  13. Turbo
  14. Aviso de los créditos (manténgalo visible)

Qué archivo corresponde a cada parte de la pantalla

En pantalla Archivo (en game/, con el mismo nombre en source/public/)
Fondo (horizontal / vertical / giros gratis) art/bg-landscape.webp, art/bg-portrait.webp, art/bg-free.webp
Logotipo art/logo.webp
Mascota (el vikingo) art/viking-idle.webp, art/viking-cheer.webp, art/viking-hype.webp
Símbolos de los rodillos art/s0.webp ... art/s10.webp (consulta la tabla de abajo)
Marco alrededor de los rodillos art/frame.webp
Botón de girar art/spin.webp
Botones dorados / píldoras / placas art/btn-gold.webp, art/pill.webp, art/plaque.webp, art/btn-blank.webp, art/btn-close.webp
Placas de los botes art/jp-mini.webp, art/jp-minor.webp, art/jp-major.webp, art/jp-grand.webp
Iconos (menú, reglas, sonido, pantalla completa, regalo) art/icon-*.webp
Títulos de celebración (BIG WIN, FREE SPINS...) art/title-*.webp, cinta art/banner.webp
Ruleta diaria art/wheel.webp, art/wheel-hub.webp, art/wheel-pointer.webp, art/title-wheel.webp
Números pintados art/font-gold.webp + art/font-gold.json
Monedas, montones, destellos art/coin.webp, art/pile-0..2.webp, art/burst.webp, art/shard-0..5.webp, art/frost.webp
Capas del WILD / capas del SCATTER art/wild-hammer.webp, art/wild-banner.webp, art/bolt-0..3.webp / art/scatter-ring.webp, art/scatter-core.webp, art/scatter-banner.webp
Textos source/src/locales/*.js o texts en rune-hoard.config.js
Colores de los efectos source/src/ui/fx.js, source/src/ui/reels.js, source/src/main.js (códigos de color en el código)
Diseño, tamaños, paleta source/src/ui/styles-1.css ... styles-3.css

Símbolos: 4 piedras rúnicas bajas (verde, azul, morada, ámbar), cuerno, hacha, escudo, yelmo, WILD (martillo del trueno), SCATTER y MONEDA. En los archivos: s0-s3 piedras rúnicas bajas, s4-s7 símbolos altos, s8 WILD, s9 SCATTER, s10 COIN.

Receta 1: cambiar un símbolo

  1. Abre art/s7.webp (por ejemplo) en tu editor de imágenes para ver su tamaño: los símbolos miden 320 × 320 píxeles con fondo transparente.
  2. Dibuja o pega tu símbolo en un lienzo transparente de 320 × 320, centrado y con un pequeño margen.
  3. Expórtalo como WebP con el mismo nombre, s7.webp, y sustituye el archivo en game/art/ (y en source/public/art/ para mantener el código fuente al día).
  4. Recarga sin la caché. La tabla de pagos de las reglas usa los mismos archivos, así que también cambia.

Receta 2: cambiar los fondos

  1. bg-landscape.webp mide 1672 × 941 (ordenador y teléfonos en horizontal), bg-portrait.webp mide 941 × 1672 (teléfonos en vertical) y bg-free.webp, de 1672 × 941, se muestra durante los giros gratis.
  2. Deja la parte importante de la imagen en el centro: los bordes se recortan en pantallas de otras proporciones. Mantén el centro más oscuro para que los rodillos destaquen.
  3. Guárdalos como WebP con los mismos nombres y sustitúyelos.

Receta 4: botones y placas

Los botones y las placas se estiran manteniendo intactos sus dos extremos ("9-slice", 9 pedazos). Cuando vuelvas a dibujar btn-gold.webp, pill.webp, plaque.webp o las placas jp-*.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 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 ser cortos (menos de 2 segundos).
  2. Música: music.mp3 (juego base) y music-free.mp3 (giros gratis). Se repiten en bucle. Las pistas extra opcionales music-locked, music-bigwin y music-wheel (Locked Coins, grandes ganancias, ruleta diaria) se admiten pero no vienen en el paquete: pon el MP3 en source/public/audio/, añade su nombre a la lista FILES al principio de source/src/audio/audio.js y genera el build.
  3. Presentador: v-big, v-mega, v-epic, v-free, v-locked, v-grand.
  4. Efectos: spin, stop, win, smallwin, bigwin, line, coin, coinrain, count, collect, scatter, suspense, bonus, buy, clang, shatter, zap, stamp, heart, drumroll, levelup, miss, nope, click, wheel-tick, wheel-win.
  5. Si falta un archivo, el juego reproduce en su lugar un sonido sintetizado integrado, así que nunca falla. El volumen inicial es audio: { volume: 0.8 } en rune-hoard.config.js.

Receta 6: colores de los efectos y de la pantalla

  1. Los colores de los efectos están escritos en el código donde se dibujan, como códigos de color ('#8fe3ff' o [150, 215, 255]): source/src/ui/fx.js (chispas, destellos, anillos, la nieve del ambiente), source/src/ui/reels.js (el fondo de los rodillos, el rayo del WILD, el marco del rodillo en espera) y source/src/main.js (los rayos de luz y los anillos de las celebraciones). Busca el color en el archivo y cámbialo.
  2. La paleta de la interfaz está al principio de source/src/ui/styles-1.css (las variables --).
  3. 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 rune-hoard.config.js: texts: { tapToPlay: 'PLAY NOW' } cambia todos los idiomas; texts: { pt: { tapToPlay: 'JOGAR' } } solo el portugués. Los nombres (tapToPlay, buyBonus...) 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.

Receta 8: apuestas, créditos iniciales y RTP

  1. En rune-hoard.config.js, dentro de math: { }: startBalance (créditos de un jugador nuevo), bets (los niveles de apuesta, múltiplos de 20), maxWin y profile: 'generous' (RTP de aprox. 97 %), 'standard' (aprox. 95 %) o 'house' (aprox. 92,5 %).
  2. buyBonus: false quita el botón BUY BONUS.
  3. Si cambias los pagos o los rodillos, mide el nuevo RTP: npm run rtp en source/.

Son solo créditos de demostración ficticios.

Receta 9: niveles, ruleta diaria y monedas gratis

En rune-hoard.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 casillas.
  • coins: { everyHours: 3, amount: 50 } configura el botón de regalo.
  • levels: { enabled: false } desactiva los niveles (todas las apuestas disponibles desde el principio).

Las cantidades son múltiplos de la apuesta mínima.

Receta 10: 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.