Visión general
Rune Hoard es un juego de simulación de tragamonedas en HTML5: 5 rodillos,
3 filas y 20 líneas fijas, con un tema nórdico de cueva de hielo: un guerrero vikingo, un martillo del
trueno, piedras rúnicas brillantes, cuernos, hachas, escudos y yelmos con cuernos. Se entrega como juego
listo para alojar (game/) y con su código fuente completo y editable (source/).
Funciona en cualquier navegador actual, en teléfonos, tabletas y ordenadores, en vertical y en horizontal,
sin servidor, base de datos ni cuenta.
Funciones: WILD en los rodillos 2 a 4, giros gratis con SCATTER y un multiplicador creciente, el bono Locked Coins con los botes MINI, MINOR, MAJOR y GRAND, un botón para comprar el bono, celebraciones de premios grandes (big/mega/epic), giro automático y modo turbo, niveles de jugador, una ruleta diaria y monedas gratis periódicas, 14 idiomas de interfaz, voz de presentador grabada y música.
Solo simulación. El jugador recibe créditos de demostración gratuitos y ficticios. No
tienen valor monetario y no se pueden comprar, transferir, vender ni canjear. No hay depósitos, retiros,
premios ni recompensas de valor económico. El precio de compra es por una licencia de software, no por
participar en juegos de azar. La licencia no permite usarlo para juegos de azar con dinero real ni con nada
de valor real. Lee SCOPE.md (en la raíz del paquete y dentro de game/): forma
parte de los términos de la licencia.
Instalar en tu sitio web
El juego listo para jugar es la carpeta game/. Es HTML, CSS y JavaScript sin más: para alojarlo
no hace falta compilar, ni Node.js, ni base de datos.
- Abre el administrador de archivos de tu alojamiento o conéctate con un programa FTP (por ejemplo FileZilla).
- Crea una carpeta para el juego, por ejemplo
/games/rune-hoard/. -
Sube a ella el contenido de
game/:index.html,rune-hoard.config.js,SCOPE.md,DOCUMENTATION.txty las carpetasart/,audio/,assets/ymodules/. -
Abre la dirección en un navegador, por ejemplo
https://your-site.example/games/rune-hoard/.
El juego usa rutas relativas, así que funciona en cualquier carpeta o subdominio. Abrir
index.html directamente desde tu disco (file://) no funciona, porque los
navegadores bloquean ahí los módulos de JavaScript: pruébalo en un alojamiento web o con la vista previa
local descrita en "Editar el código fuente".
Insertarlo en una página (iframe)
<iframe src="/games/rune-hoard/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>
Deja visible el aviso de créditos en pantalla y conserva SCOPE.md junto al juego cuando lo
publiques.
Requisitos
- Cualquier alojamiento web estático HTTP o HTTPS (alojamiento compartido, una CDN, GitHub Pages, Netlify...). Sin PHP, base de datos ni código de servidor.
- Un navegador actual: Chrome, Edge, Firefox, Safari (macOS e iOS), Samsung Internet u Opera.
- Solo para editar el código fuente: Node.js 26 LTS (la versión LTS actual) y npm, consulta "Editar el código fuente".
-
No hace falta conexión a internet para jugar: el arte, los sonidos y el código están todos dentro de
game/. El juego no hace peticiones a otros sitios.
Cómo se juega y las pantallas
El jugador toca TAP TO PLAY (tocar para jugar), elige una apuesta con – y + (o MAX BET, apuesta máxima) y toca el botón de girar. Las combinaciones ganadoras pagan de izquierda a derecha en 20 líneas fijas. Todas las cantidades son créditos de demostración ficticios.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
- Saldo de créditos de demostración (+ = recarga gratis cuando se acaba)
- Jackpots del bono Locked Coins
- Nivel del jugador
- Monedas gratis (cada pocas horas)
- Menú: reglas, sonido, pantalla completa
- BUY BONUS (se paga con créditos de demostración)
- Rodillos: 5 × 3, 20 líneas
- Apuesta – / +
- MAX BET (apuesta máxima)
- Ganancia de la ronda y la línea premiada
- Girar (Espacio o Intro)
- Giro automático
- Turbo
- Aviso de los créditos (manténgalo visible)
- WILD (martillo del trueno) aparece en los rodillos 2, 3 y 4 y sustituye a todos los símbolos excepto SCATTER y COIN.
- SCATTER: 3, 4 o 5 en cualquier posición pagan 2×, 10× o 50× la apuesta total e inician 8, 12 o 20 giros gratis. Durante los giros gratis las ganancias de línea se multiplican: el multiplicador empieza en ×2 y sube 1 tras cada giro con ganancia de línea, hasta ×5. Más scatters añaden giros (hasta 50 por bono).
- Locked Coins: 6 o más símbolos COIN quedan fijos y dan 3 giros extra; cada moneda nueva queda fija y devuelve los giros extra a 3. Al final se paga el valor de cada moneda. Las monedas MINI, MINOR y MAJOR pagan su bote; llenar las 15 posiciones añade el GRAND.
- BUY BONUS (comprar bono) inicia los giros gratis al momento a cambio de un precio en los mismos créditos de demostración gratuitos. No es una compra.
- Ninguna ronda paga más de 5.000× la apuesta total.
Recompensas fuera de los rodillos
Los niveles (el botón redondo con el número) suben al jugar y dan créditos gratis; las apuestas más altas se desbloquean al subir de nivel. La ruleta diaria da créditos gratis una vez al día (en la configuración de demostración incluida se ofrece en cada visita). El botón de regalo da monedas gratis cada pocas horas. Cuando se acaban los créditos, se ofrece una recarga gratuita.
1
2
3
- La ruleta y sus premios en créditos de demostración
- Girar la ruleta
- Más tarde
Menú, reglas y opciones
El botón de menú abre las reglas (tabla de pagos, reglas de los bonos, las 20 líneas) y las opciones: música, efectos de sonido, menos movimiento y el idioma.
1
2
3
4
5
- Tabla de pagos de la apuesta actual
- Reglas de WILD, SCATTER, tiradas gratis y Locked Coins
- Las 20 líneas
- Opciones: música, efectos, menos movimiento, idioma
- Cerrar (Esc)
1
2
3
4
5
6
7
8
9
10
- Saldo de créditos de demostración (+ = recarga gratis cuando se acaba)
- Jackpots del bono Locked Coins
- Menú: reglas, sonido, pantalla completa
- Rodillos: 5 × 3, 20 líneas
- Apuesta – / +
- Ganancia de la ronda y la línea premiada
- Girar (Espacio o Intro)
- Giro automático
- Turbo
- BUY BONUS (se paga con créditos de demostración)
Teclado
Espacio o Intro hace girar. Las flechas cambian la apuesta, M activa o desactiva el sonido, T activa o desactiva el turbo y Escape cierra el menú o un panel abierto.
Qué incluye el paquete
rune-hoard-static-1.0.0/
START-HERE.txt first steps
DOCUMENTATION.html opens this guide
CUSTOMIZATION.html opens the customization guide (recipes, no coding)
CHANGELOG.txt
SCOPE.md what the product is and what the licence does not allow
documentation/ this guide and the customization guide (EN/PT/ES), screenshots
game/ UPLOAD THE CONTENTS OF THIS FOLDER
index.html the page
rune-hoard.config.js your settings (edit on the host, no rebuild)
modules/ the JavaScript, one readable file per source module
assets/ui/ the stylesheets
art/ images (WebP)
audio/ sounds, voice and music (MP3)
SCOPE.md, DOCUMENTATION.txt
source/ the complete editable project
index.html the page (development version)
src/main.js start-up, spins, celebrations, bonuses, menus
src/config.js defaults, events, save key
src/logic/ math.js (symbols, pays, reels, RTP profiles), engine.js, progress.js
src/ui/ reels, effects, wheel, sheets, styles-1..3.css, i18n.css
src/locales/ the 14 languages (en.js is the reference)
src/audio/audio.js the list of sounds, music and voices
public/ art/, audio/, rune-hoard.config.js (copied to the build as they are)
tests/ npm test
tools/ RTP simulator, translation check, seed finder, in-page checks, build formatter
package.json, package-lock.json, vite.config.js, .prettierrc, README.md
licenses/ licences of the development tools
THIRD-PARTY-LICENSES/ the same licence texts
game/ es exactamente lo que npm run build genera a partir de
source/ (comprobado archivo por archivo antes de empaquetar). Edita source/ y
vuelve a compilar, o edita solo rune-hoard.config.js en el alojamiento.
Configuración (rune-hoard.config.js)
game/rune-hoard.config.js se lee cada vez que se abre el juego, así que puedes cambiar estos
ajustes en tu alojamiento con un editor de texto y sin volver a compilar. Todos los campos son opcionales:
quita las // del principio de una línea para usarla. Un valor incorrecto detiene el juego con
un mensaje que indica qué corregir.
window.RUNE_HOARD_CONFIG = {
brand: { name: 'Rune Hoard', storageKey: 'mysite.rune-hoard' },
language: 'auto',
languages: ['en', 'pt', 'es'],
texts: { tapToPlay: 'PLAY NOW', de: { tapToPlay: 'LOS!' } },
audio: { volume: 0.8, muted: false },
ageGate: true,
notice: true,
showRtp: true,
math: { profile: 'standard', startBalance: 1000000, bets: [200, 400, 1000, 2000, 4000, 10000, 20000], maxWin: 5000 },
progress: { wheel: { alwaysReady: false, everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
winTiers: { big: 10, mega: 25, epic: 50 },
};
| Opción | Qué hace |
|---|---|
brand.name |
nombre del juego que se usa en la página y en los mensajes |
brand.storageKey |
prefijo de los datos guardados en el navegador (por defecto
rune-hoard.template.save.v1); cámbialo para empezar con una partida guardada nueva
|
language |
'auto' = el idioma del dispositivo (inglés si no está disponible), o un código:
en pt es fr de it nl pl tr ru id ja ko zh. Tienen prioridad la elección del jugador en
OPTIONS y ?lang=xx en la dirección
|
languages |
los idiomas que se ofrecen en OPTIONS (por defecto: los 14). Con un solo idioma se oculta el selector |
texts |
sustituye cualquier texto de src/locales/en.js en todos los idiomas, o en uno solo
(texts: { pt: {...} })
|
audio |
volumen inicial (de 0 a 1) y si empieza silenciado |
ageGate |
true muestra la insignia 18+ y el aviso de casino social |
notice |
el aviso de créditos de una línea bajo los controles. Déjalo activado: SCOPE.md lo
exige en las publicaciones públicas
|
showRtp |
muestra el RTP del perfil activo en el panel de reglas |
debug |
solo para pruebas: permite ?seed=123 en la dirección (las mismas rondas cada vez) en
cualquier alojamiento
|
math |
profile ('generous' RTP de aprox. 97 %, 'standard' aprox. 95
%, 'house' aprox. 92,5 %), startBalance, bets (múltiplos de
20), maxWin, botes, buyBonus: false para quitar el botón de compra.
Ejecuta npm run rtp después de cambiarlo
|
progress |
niveles (levels.enabled, need, reward, unlock),
la ruleta diaria (enabled, alwaysReady, everyHours,
prizes, weights) y las monedas gratis (enabled,
everyHours, amount). Las cantidades son múltiplos de la apuesta mínima
|
winTiers |
a cuántas veces la apuesta total empiezan las celebraciones big, mega y epic |
integration, callbacks |
eventos para tu propia página, consulta "Eventos" |
El archivo del paquete lista todas las opciones con un comentario. Los valores por defecto completos están
en source/src/config.js, source/src/logic/math.js y
source/src/logic/progress.js.
Idiomas
La interfaz está traducida a 14 idiomas: inglés, portugués, español, francés, alemán, italiano, neerlandés,
polaco, turco, ruso, indonesio, japonés, coreano y chino (simplificado). La voz del presentador y los
títulos pintados (BIG WIN, FREE SPINS...) están en inglés en todos los idiomas. El juego se abre en el
idioma del dispositivo; el jugador puede cambiarlo en OPTIONS, y ?lang=pt en la dirección
fuerza uno.
Los textos están en source/src/locales/<code>.js, un archivo por idioma, con las mismas
claves que en.js. Si falta una clave, se usa el inglés. Para cambiar algunos textos sin volver
a compilar, usa texts en rune-hoard.config.js. Después de editar los archivos de
idioma, ejecuta npm run locales para comprobar que ninguna traducción haya perdido un marcador
{value}.
Datos guardados
El juego guarda el saldo, el nivel, los ajustes y los temporizadores de recompensas en el localStorage del
navegador, con claves que empiezan por rune-hoard.template.save.v1. (por ejemplo
rune-hoard.template.save.v1.balance). No se envía nada a ningún sitio. Borrar los datos del
sitio en el navegador reinicia el juego. Si publicas dos copias del juego en el mismo dominio, da a cada una
su propio brand.storageKey.
Eventos para tu página
El juego emite eventos para que tu página pueda mostrar estadísticas, logros o una clasificación de puntuaciones ficticias. No son una interfaz de contabilidad ni de pagos y no deben usarse como tal.
-
callbacksenrune-hoard.config.js:onReady,onSpin(round),onWin(round),onBalance({ balance }),onBonus({ kind, amount, balance }),onError. -
window.RuneHoard.on('spin', fn),window.RuneHoard.getBalance(),window.RuneHoard.version. - Eventos DOM en
window:runehoard:spin,runehoard:win... -
Con
integration: { postMessage: true, targetOrigin: 'https://your-site.example' }el juego también envía{ source: 'rune-hoard', type, payload }a la página contenedora cuando se ejecuta dentro de un iframe.
round.spent son los créditos de demostración apostados en una ronda y
round.payout los créditos de demostración que devolvió.
Editar el código fuente (Node.js para principiantes)
Solo lo necesitas para cambiar el código, los estilos, el arte o los sonidos y generar un nuevo
game/. Para cambiar ajustes, edita rune-hoard.config.js.
1. Instalar Node.js
-
Entra en
https://nodejs.orgy descarga la versión LTS (Node.js 26 LTS). Windows y macOS: ejecuta el instalador con las opciones por defecto. Linux: usa tu gestor de paquetes o los binarios oficiales. - Cierra y vuelve a abrir la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal).
- Comprueba las versiones: ambos comandos deben mostrar un número, y Node debe ser 26.13.0 o posterior.
node --version
npm --version
2. Instalar las herramientas del proyecto
Abre la terminal en la carpeta source/ (Windows: abre la carpeta en el Explorador, haz clic en
la barra de direcciones, escribe powershell y pulsa Intro; macOS: arrastra la carpeta al icono
de Terminal). Después ejecuta:
npm ci
Esto instala las versiones exactas de package-lock.json (Vite y Prettier) en
node_modules/. Necesita conexión a internet una sola vez.
3. Probar, previsualizar y compilar
npm test
npm run dev
npm run build
-
npm testejecuta las pruebas del motor (pagos, bonos, créditos, niveles, ruleta, RTP). Todas deben pasar. -
npm run devinicia una vista previa local enhttp://localhost:5207/que se recarga al guardar un archivo. Pulsa Ctrl+C para detenerla. -
npm run buildescribe el juego terminado ensource/dist/. Sube el contenido dedist/a tu alojamiento (sustituye agame/). La compilación no está minificada y está formateada con Prettier, así que sigue siendo legible.
Otros comandos
-
npm run rtpmuestra el RTP real de tus matemáticas (src/logic/math.jsmás elmathdepublic/rune-hoard.config.js).node tools/simulate.mjs buycalcula nuevos precios para comprar el bono. npm run localescomprueba las traducciones.-
node tools/find-seeds.mjslista semillas que muestran un bono en el primer giro; abrehttp://localhost:5207/?seed=Npara verlo (las semillas funcionan en localhost o condebug: true). npm run formatformatea todo el proyecto con Prettier.
Problemas frecuentes
-
nodeonpmno se reconoce: Node.js no está instalado o la terminal se abrió antes de instalarlo. Reinstálalo y abre una terminal nueva. -
Windows dice que la ejecución de scripts está deshabilitada (
npm.ps1): usa el Símbolo del sistema, o ejecutanpm.cmd ci. ENOENT ... package.json: la terminal no está en la carpetasource/.EBADENGINE: tu Node.js es anterior a 26.13.0. Instala la LTS actual.-
npm cifalla con un error de red: revisa la conexión o el proxy de la red de tu empresa y vuelve a ejecutarlo. -
npm cidice que el archivo de bloqueo no está sincronizado: cambiastepackage.json; ejecutanpm installuna vez ynpm civolverá a funcionar. - El puerto 5207 está ocupado: Vite elige el siguiente puerto libre y lo muestra.
Personalizar y cambiar la apariencia
La guía de personalización (CUSTOMIZATION.html) tiene recetas paso a paso para
quienes no programan: cambiar símbolos, fondos, el logotipo, la mascota, sonidos y música, colores, textos,
apuestas y recompensas. En resumen:
-
Arte:
source/public/art/(ogame/art/en el alojamiento). Sustituye un archivo por otro WebP con el mismo nombre y el mismo tamaño.s0.webpas10.webpson los símbolos. -
Sonidos:
source/public/audio/(ogame/audio/). Sustituye un MP3 por otro con el mismo nombre. -
Colores y efectos del tema: escritos como códigos de color (como
'#8fe3ff'o[150, 215, 255]) donde se dibujan: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 rodillo en espera) ysource/src/main.js(los rayos de luz de las celebraciones). Solo afecta a la presentación: nada de ahí cambia un resultado. -
Diseño y estilos:
source/src/ui/styles-1.cssastyles-3.css(variables de la paleta al principio destyles-1.css). -
Textos:
textsenrune-hoard.config.jsosource/src/locales/. -
Matemáticas:
source/src/logic/math.jsomathenrune-hoard.config.js, y despuésnpm run rtp.
Los cambios en source/ requieren npm run build. Los cambios en archivos de
game/ en el alojamiento (arte, audio, rune-hoard.config.js) no requieren compilar.
Nombres internos
Algunos nombres del código vienen del arte de este juego y otros del motor compartido con otros temas. Son solo nombres:
| Nombre en el código | Qué es en este juego |
|---|---|
#viking, plantViking(), seatViking(), art/viking-*.webp |
the mascot (the Viking): its element, where it stands and its three poses; keep the names if you draw another character |
frost.webp, fx.frost(), reels.freeze(), "shards" |
the ice that covers the reels when Locked Coins starts, and the shards when a coin locks |
.entry-hoard |
the three floating symbols on the title screen |
CreditBank, round.spent, round.payout |
the fictional demo credits: credits put into and won by one round (no money) |
Actualizar el juego y borrar la caché
Después de subir una versión nueva, los navegadores y los alojamientos pueden conservar los archivos antiguos durante un tiempo. Si un cambio no aparece:
- Recarga sin la caché: Ctrl+F5 o Ctrl+Shift+R (Windows/Linux), Cmd+Shift+R (macOS). En un teléfono, cierra la pestaña y vuelve a abrirla.
- Borra los archivos en caché del sitio en los ajustes del navegador ("Imágenes y archivos en caché"). No borres "cookies y datos de sitios" salvo que quieras reiniciar la partida guardada.
- Prueba con una ventana privada (de incógnito).
- Si tu alojamiento o tu CDN (por ejemplo Cloudflare) tiene caché, púrgala.
- Añade una versión a la dirección una vez, por ejemplo
index.html?v=2.
Los datos guardados se mantienen tras una actualización siempre que brand.storageKey no cambie.
Qué es el producto (y qué no es)
- Solo créditos de demostración gratuitos y ficticios, sin valor monetario. No se pueden comprar, transferir, vender ni canjear. No hay premios de ningún tipo.
- No hay ningún sistema de pagos, depósitos, retiros, cuentas ni monederos: ninguno está oculto, desactivado ni incluido en el paquete.
- La licencia estándar no permite usar este juego, ni ninguna versión modificada de él, para juegos de azar con dinero real ni con nada de valor real: no se pueden comprar créditos, ni canjearlos por dinero, ni dar premios según los resultados, ni conectarlo a un monedero de juegos de azar, a un sistema de pagos ni a un operador de dinero real, ni anunciar juegos de azar con dinero real.
-
Debes cumplir las leyes de cada lugar donde publiques el juego (clasificación por edades, menores,
protección del consumidor). Mantén visible el aviso de créditos;
ageGate: trueañade un aviso 18+. - El soporte no cubre monederos, depósitos, retiros ni ninguna integración con dinero real; esas solicitudes se rechazan.
El texto completo está en SCOPE.md.
Preguntas y problemas
-
La página está en blanco. Comprueba que subiste el contenido de
game/(conmodules/yassets/) y que lo abres por http(s), no porfile://. La consola del navegador (F12) muestra el archivo que falta. - No hay sonido. Los navegadores solo permiten el sonido después de un toque: el juego lo inicia con TAP TO PLAY. Revisa el menú (botón de sonido), OPTIONS (música, efectos) y el volumen del dispositivo.
-
¿Puedo cambiar el RTP? Sí:
math.profileelige uno de los tres perfiles medidos; tus propias matemáticas se miden connpm run rtp. - ¿Pueden los jugadores comprar créditos o ganar premios? No. El juego no tiene ningún sistema de pagos ni de premios, y la licencia no permite añadirlo.
- ¿Funciona sin conexión? Una vez cargado, sí; no necesita ningún otro sitio.
-
¿Puedo quitar el aviso de créditos? En una publicación pública debe seguir visible
(consulta
SCOPE.md). -
La ruleta diaria se abre en cada visita. Es el ajuste de demostración
alwaysReady: true; configuraprogress: { wheel: { alwaysReady: false } }. -
¿Cómo pruebo un bono? En localhost usa
?seed=Ncon una semilla denode tools/find-seeds.mjs, o activadebug: truemientras pruebas.
Soporte y créditos
Correo de soporte: willian@polargames.com.br (errores, instalación, diseño en los navegadores compatibles, traducciones, personalización visual y de audio y los ajustes de esta guía). Incluye tu código de compra o de licencia, el navegador y el dispositivo, y una captura de pantalla.
Herramientas de desarrollo: Vite y Prettier (licencias MIT en THIRD-PARTY-LICENSES/). No se
incluye código de terceros en game/. El arte, la música, la voz y los efectos forman parte del
juego y están cubiertos por la licencia de tu compra.