Doubloon Bay 1.0.0: guía del comprador

Juego HTML5 de slot en simulación, con créditos ficticios gratuitos. Código fuente editable incluido.

Guía de personalización (recetas)

EnglishPortuguêsEspañol

Visión general

Doubloon Bay es un juego de simulación de tragamonedas en HTML5: 5 rodillos, 3 filas y 20 líneas fijas, con una cala pirata al atardecer: un loro capitán, una brújula dorada, un catalejo, un timón, un sombrero de capitán y un cofre del tesoro. 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.

La pantalla del juego (1280×720) después de una línea ganadora.
La pantalla del juego (1280×720) después de una línea ganadora.

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.

  1. Abre el administrador de archivos de tu alojamiento o conéctate con un programa FTP (por ejemplo FileZilla).
  2. Crea una carpeta para el juego, por ejemplo /games/doubloon-bay/.
  3. Sube a ella el contenido de game/: index.html, doubloon-bay.config.js, SCOPE.md, DOCUMENTATION.txt y las carpetas art/, audio/, assets/ y modules/.
  4. Abre la dirección en un navegador, por ejemplo https://your-site.example/games/doubloon-bay/.

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/doubloon-bay/" 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.

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)
  • WILD (brújula dorada) 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.
La celebración de una gran ganancia (importes en créditos ficticios de demostración).
La celebración de una gran ganancia (importes en créditos ficticios de demostración).
Tiradas gratis: el escenario cambia y el multiplicador aparece arriba a la derecha de los rodillos.
Tiradas gratis: el escenario cambia y el multiplicador aparece arriba a la derecha de los rodillos.
Locked Coins: las monedas quedan fijas; las tres luces muestran los giros extra que quedan.
Locked Coins: las monedas quedan fijas; las tres luces muestran los giros extra que quedan.

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.

La ruleta diaria (créditos de demostración gratuitos). 1 2 3
La ruleta diaria (créditos de demostración gratuitos).
  1. La ruleta y sus premios en créditos de demostración
  2. Girar la ruleta
  3. 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.

Reglas: tabla de pagos, reglas de los bonos, las 20 líneas y las opciones. 1 2 3 4 5
Reglas: tabla de pagos, reglas de los bonos, las 20 líneas y las opciones.
  1. Tabla de pagos de la apuesta actual
  2. Reglas de WILD, SCATTER, tiradas gratis y Locked Coins
  3. Las 20 líneas
  4. Opciones: música, efectos, menos movimiento, idioma
  5. Cerrar (Esc)
Opciones en portugués, con los 14 idiomas.
Opciones en portugués, con los 14 idiomas.
Móvil en vertical (390×844): el mismo juego, reorganizado. 1 2 3 4 5 6 7 8 9 10
Móvil en vertical (390×844): el mismo juego, reorganizado.
  1. Saldo de créditos de demostración (+ = recarga gratis cuando se acaba)
  2. Jackpots del bono Locked Coins
  3. Menú: reglas, sonido, pantalla completa
  4. Rodillos: 5 × 3, 20 líneas
  5. Apuesta – / +
  6. Ganancia de la ronda y la línea premiada
  7. Girar (Espacio o Intro)
  8. Giro automático
  9. Turbo
  10. 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

doubloon-bay-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
    doubloon-bay.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, theme.js, 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/, doubloon-bay.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 doubloon-bay.config.js en el alojamiento.

Configuración (doubloon-bay.config.js)

game/doubloon-bay.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.DOUBLOON_BAY_CONFIG = {
  brand: { name: 'Doubloon Bay', storageKey: 'mysite.doubloon-bay' },
  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 doubloon-bay.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 doubloon-bay.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 doubloon-bay.template.save.v1. (por ejemplo doubloon-bay.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.

  • callbacks en doubloon-bay.config.js: onReady, onSpin(round), onWin(round), onBalance({ balance }), onBonus({ kind, amount, balance }), onError.
  • window.DoubloonBay.on('spin', fn), window.DoubloonBay.getBalance(), window.DoubloonBay.version.
  • Eventos DOM en window: doubloonbay:spin, doubloonbay:win...
  • Con integration: { postMessage: true, targetOrigin: 'https://your-site.example' } el juego también envía { source: 'doubloon-bay', 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 doubloon-bay.config.js.

1. Instalar Node.js

  1. Entra en https://nodejs.org y 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.
  2. Cierra y vuelve a abrir la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal).
  3. 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 test ejecuta las pruebas del motor (pagos, bonos, créditos, niveles, ruleta, RTP). Todas deben pasar.
  • npm run dev inicia una vista previa local en http://localhost:5209/ que se recarga al guardar un archivo. Pulsa Ctrl+C para detenerla.
  • npm run build escribe el juego terminado en source/dist/. Sube el contenido de dist/ a tu alojamiento (sustituye a game/). La compilación no está minificada y está formateada con Prettier, así que sigue siendo legible.

Otros comandos

  • npm run rtp muestra el RTP real de tus matemáticas (src/logic/math.js más el math de public/doubloon-bay.config.js). node tools/simulate.mjs buy calcula nuevos precios para comprar el bono.
  • npm run locales comprueba las traducciones.
  • node tools/find-seeds.mjs lista semillas que muestran un bono en el primer giro; abre http://localhost:5209/?seed=N para verlo (las semillas funcionan en localhost o con debug: true).
  • npm run format formatea todo el proyecto con Prettier.

Problemas frecuentes

  • node o npm no 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 ejecuta npm.cmd ci.
  • ENOENT ... package.json: la terminal no está en la carpeta source/.
  • EBADENGINE: tu Node.js es anterior a 26.13.0. Instala la LTS actual.
  • npm ci falla con un error de red: revisa la conexión o el proxy de la red de tu empresa y vuelve a ejecutarlo.
  • npm ci dice que el archivo de bloqueo no está sincronizado: cambiaste package.json; ejecuta npm install una vez y npm ci volverá a funcionar.
  • El puerto 5209 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/ (o game/art/ en el alojamiento). Sustituye un archivo por otro WebP con el mismo nombre y el mismo tamaño. s0.webp a s10.webp son los símbolos.
  • Sonidos: source/public/audio/ (o game/audio/). Sustituye un MP3 por otro con el mismo nombre.
  • Colores y efectos del tema: source/src/ui/theme.js (color de acento, chispas, el fondo de los rodillos, los rayos de luz de las celebraciones, cómo se mueve cada símbolo cuando paga). Solo afecta a la presentación: nada de ahí cambia un resultado.
  • Diseño y estilos: source/src/ui/styles-1.css a styles-3.css (variables de la paleta al principio de styles-1.css).
  • Textos: texts en doubloon-bay.config.js o source/src/locales/.
  • Matemáticas: source/src/logic/math.js o math en doubloon-bay.config.js, y después npm run rtp.

Los cambios en source/ requieren npm run build. Los cambios en archivos de game/ en el alojamiento (arte, audio, doubloon-bay.config.js) no requieren compilar.

Nombres internos

El motor se comparte con otros temas, así que algunos nombres del código describen el arte para el que se crearon originalmente. Son solo nombres:

Nombre en el código Qué es en este juego
wild-hammer.webp, wild-banner.webp, bolt-0..3.webp, reels.wild.hammer the three painted layers of the WILD symbol (the golden compass, its WILD ribbon and the trail of gold glints); the shared engine calls the top layer "hammer"
frost.webp, fx.frost(), reels.freeze(), "ice", "shards" the sea that rises over the reels when Locked Coins starts, and the splash when a coin locks; comments of the shared engine describe it as ice
snow in fx.js, THEME.ambient the ambient particles (here: small bubbles rising, THEME.ambient.rise = true)
.bg-aurora, "aurora" the light layer over the background that comes down on the biggest wins, and the swirl inside the SCATTER ring
.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: true añ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/ (con modules/ y assets/) y que lo abres por http(s), no por file://. 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.profile elige uno de los tres perfiles medidos; tus propias matemáticas se miden con npm 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; configura progress: { wheel: { alwaysReady: false } }.
  • ¿Cómo pruebo un bono? En localhost usa ?seed=N con una semilla de node tools/find-seeds.mjs, o activa debug: true mientras 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.