Tiki Paradise Roulette 1.0.0: guía del comprador

Juego HTML5 de mini ruleta en simulación (13 casillas), con créditos ficticios gratuitos. Código fuente editable incluido.

Guía de personalización (recetas)

EnglishPortuguêsEspañol

Presentación

Tiki Paradise Roulette es un juego de simulación de mini ruleta en HTML5: una ruleta con 13 casillas (el 0 verde y los números del 1 al 12), un bar tiki en la playa al atardecer, junto al océano, y un tucán barman con camisa hawaiana como crupier. 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: todas las apuestas de una mesa de ruleta en un tapete de 13 casillas (pleno, caballo, calle, cuadro, línea de seis, columnas, rojo/negro, par/impar, 1-6/7-12), números de la suerte con multiplicadores de ×15 a ×100, la regla de devolver la mitad en el 0, una bola que vuela de verdad y rebota en los separadores, celebraciones big/mega/epic win, apuestas rápidas (vecinos en la ruleta, apuestas favoritas, repetir, doblar), juego automático y turbo, niveles del jugador, una ruleta diaria, monedas gratis cada cierto tiempo, misiones diarias, 14 idiomas de interfaz, voz de locutor 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.

Acierto de un número de la suerte: EPIC WIN, las monedas caen en el saldo
Acierto de un número de la suerte: EPIC WIN, las monedas caen en el saldo

Instalar en tu sitio web

El juego jugable es la carpeta game/. Es HTML, CSS y JavaScript simples: para alojarlo no hace falta compilar, ni Node.js, ni base de datos.

  1. Abre el administrador de archivos de tu hosting o conéctate con un programa FTP (por ejemplo FileZilla).
  2. Crea una carpeta para el juego, por ejemplo /games/tiki-paradise/.
  3. Sube a ella el contenido de game/: index.html, tiki-paradise.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/tiki-paradise/.

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 hosting o con la vista previa local que se explica en "Editar el código fuente".

Ponerlo dentro de una página (iframe)

<iframe src="/games/tiki-paradise/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>

Deja visible el aviso de créditos en pantalla y mantén SCOPE.md junto al juego cuando lo publiques para el público.

Requisitos

  • Cualquier hosting web estático HTTP o HTTPS (hosting 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 dentro de game/. El juego no hace peticiones a otros sitios.

Cómo se juega y las pantallas

El jugador pulsa TOCA PARA JUGAR, elige una ficha en la bandeja, toca la mesa para colocarla y toca GIRAR. El tucán crupier lanza la bola; cuando se detiene, el número sale de su casilla, el rastrillo retira las fichas perdidas y se pagan las apuestas ganadoras. Todas las cantidades son créditos de demostración ficticios.

La mesa con apuestas: pleno, caballo, cuadro, columna y apuestas sencillas 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
La mesa con apuestas: pleno, caballo, cuadro, columna y apuestas sencillas
  1. Saldo: los créditos de demostración gratis
  2. Nivel: crece al jugar, da créditos gratis y desbloquea las fichas mayores
  3. Regalos: monedas gratis, la ruleta diaria y las misiones del día
  4. Menú: INFO, números, apuestas favoritas, juego automático, turbo, sonido, pantalla completa
  5. La rueda: 13 casillas; toque un número para apostar en él y en sus dos vecinos
  6. Últimos resultados (toque: la página DATOS)
  7. APUESTA: lo que hay en la mesa; tras la ronda, GANADO
  8. La mesa: toque un número, una línea, una esquina o una casilla exterior para poner la ficha elegida
  9. Fichas: elija el valor; las bloqueadas se abren en niveles más altos
  10. Deshacer la última ficha
  11. Limpiar la mesa
  12. Repetir: las apuestas de la última ronda
  13. ×2: duplica todas las apuestas
  14. GIRAR (manténgalo pulsado: juego automático)
  15. Turbo sí/no
  16. El aviso de los créditos (manténgalo visible: SCOPE.md)

Las apuestas y lo que pagan

Una apuesta que "paga 5 a 1" devuelve la ficha más 5 veces la ficha.

Apuesta Números Paga Dónde tocar
Pleno 1 11 a 1 (9 a 1 mientras hay números de la suerte) un número
Caballo 2 5 a 1 la línea entre dos números
Calle 3 3 a 1 la línea exterior de una fila de tres
Trío 3 (el 0 y dos números) 3 a 1 la esquina donde el 0 se junta con dos números
Cuadro 4 2 a 1 el punto donde se juntan cuatro números
Primeros cuatro 0, 1, 2, 3 2 a 1 la esquina exterior del 0 y la primera fila
Línea de seis 6 1 a 1 la línea exterior entre dos filas
Columna 4 2 a 1 una casilla 2:1
Rojo / negro, par / impar, 1-6 / 7-12 6 1 a 1 las casillas debajo de la mesa

Si mantienes el dedo sobre la mesa (o apuntas con el ratón), se iluminan los números que cubre una apuesta y aparece una etiqueta con su nombre y su pago antes de colocar la ficha. Al tocar un número en la ruleta se coloca una ficha en él y en sus dos vecinos de la ruleta.

  • La regla del 0: cuando la bola cae en el 0, toda apuesta perdedora que no cubre el 0 recupera la mitad de sus fichas (redondeada hacia abajo). Es el ajuste de fábrica; rules.zeroRule lo cambia.
  • Números de la suerte: cuando el jugador toca GIRAR, 2 números se iluminan con un multiplicador (×15, ×20, ×25, ×50, ×100). Una ficha a pleno en un número de la suerte que gana devuelve esa cantidad de veces la ficha. Las demás apuestas pagan como siempre.
Tras GIRAR: dos números de la suerte se encienden con su multiplicador mientras la bola corre
Tras GIRAR: dos números de la suerte se encienden con su multiplicador mientras la bola corre
El resultado sale de su casilla; el marcador de cristal se posa en el número ganador
El resultado sale de su casilla; el marcador de cristal se posa en el número ganador

Apuestas rápidas y botones

  • Deshacer, limpiar la mesa, repetir (las apuestas de la última ronda) y ×2 (doblar todas las apuestas) son los botones redondos junto a GIRAR.
  • Apuestas favoritas (menú): guarda hasta tres distribuciones y vuelve a colocar una con un toque.
  • Juego automático: mantén pulsado GIRAR, o ábrelo desde el menú, y elige cuántas rondas. Un toque en GIRAR lo detiene.
  • Turbo: el pequeño rayo de GIRAR, o el menú, acorta el lanzamiento.

Recompensas fuera de la mesa

Los niveles (el botón redondo LV) suben al jugar, dan créditos gratis y abren las fichas más grandes. La ruleta diaria da créditos gratis una vez al día (en el ajuste de demostración de fábrica se ofrece en cada visita). El botón de regalo da monedas gratis cada pocas horas y muestra tres misiones diarias para probar los tipos de apuesta. Cuando se acaban los créditos, se ofrece una recarga gratis.

La ruleta diaria (créditos de demostración gratis) 1 2 3
La ruleta diaria (créditos de demostración gratis)
  1. Los premios, en créditos de demostración gratis
  2. Girar la ruleta
  3. Luego: volver a la mesa

INFO: PAGOS, REGLAS, DATOS y OPCIONES

El menú abre INFO con cuatro páginas: lo que paga cada apuesta (dibujado en un tapete pequeño), las reglas, las estadísticas de los últimos resultados y las opciones (música, efectos de sonido, turbo, menos movimiento, idioma).

INFO, PAGOS: cada tipo de apuesta en una mesa pequeña, con lo que paga 1 2 3 4 5 6 7
INFO, PAGOS: cada tipo de apuesta en una mesa pequeña, con lo que paga
  1. PAGOS
  2. REGLAS
  3. DATOS (estadísticas)
  4. OPCIONES
  5. Cerrar
  6. Dónde va la ficha de esa apuesta y los números que cubre
  7. Lo que paga, "a 1" (la ficha también vuelve)
INFO, DATOS: con qué frecuencia salió cada número, los últimos resultados, los más y menos frecuentes
INFO, DATOS: con qué frecuencia salió cada número, los últimos resultados, los más y menos frecuentes
INFO, OPCIONES: música, efectos de sonido, turbo, menos movimiento y el idioma 1
INFO, OPCIONES: música, efectos de sonido, turbo, menos movimiento y el idioma
  1. El selector de idioma
Teléfono vertical (390 × 844): la rueda arriba, la mesa debajo 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
Teléfono vertical (390 × 844): la rueda arriba, la mesa debajo
  1. Saldo: los créditos de demostración gratis
  2. Nivel: crece al jugar, da créditos gratis y desbloquea las fichas mayores
  3. Regalos: monedas gratis, la ruleta diaria y las misiones del día
  4. Menú: INFO, números, apuestas favoritas, juego automático, turbo, sonido, pantalla completa
  5. La rueda: 13 casillas; toque un número para apostar en él y en sus dos vecinos
  6. Últimos resultados (toque: la página DATOS)
  7. APUESTA: lo que hay en la mesa; tras la ronda, GANADO
  8. La mesa: toque un número, una línea, una esquina o una casilla exterior para poner la ficha elegida
  9. Fichas: elija el valor; las bloqueadas se abren en niveles más altos
  10. Deshacer la última ficha
  11. Limpiar la mesa
  12. Repetir: las apuestas de la última ronda
  13. ×2: duplica todas las apuestas
  14. GIRAR (manténgalo pulsado: juego automático)
  15. Turbo sí/no
  16. El aviso de los créditos (manténgalo visible: SCOPE.md)

Teclado

Space o Enter gira. Backspace o Z retira la última ficha, R vuelve a colocar las últimas apuestas, T activa o desactiva el turbo, M activa o desactiva el sonido y Escape cierra una ventana abierta.

Qué incluye el paquete

tiki-paradise-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
    tiki-paradise.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, the round, lucky numbers, the daily wheel and gifts
    src/table/            hud.js, betting.js, celebration.js, input.js (parts of main.js)
    src/config.js         defaults, events, save key
    src/logic/            rules.js (the table), engine.js (bets, credits, return), progress.js, missions.js
    src/ui/               roulette.js (the wheel), spin-sim.js (the ball), board.js (the table), fx, sheets, feel.js, theme.js, styles.css, game.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/, tiki-paradise.config.js (copied to the build as they are)
    tests/                npm test
    tools/                return of every bet, translation check, in-page text check, 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/ (se comprueba archivo por archivo antes de empaquetar). Edita source/ y vuelve a compilar, o edita solo tiki-paradise.config.js en el hosting.

Ajustes (tiki-paradise.config.js)

game/tiki-paradise.config.js se lee cada vez que se abre el juego, así que puedes cambiar estos ajustes en tu hosting con un editor de texto y sin volver a compilar. Todos los campos son opcionales: quita las // del inicio de una línea para usarla. Un valor incorrecto detiene el juego con un mensaje que dice qué corregir.

window.TIKI_PARADISE_CONFIG = {
  brand: { name: 'Tiki Paradise Roulette', storageKey: 'mysite.tiki-paradise' },
  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,
  rules: { zeroRule: 'half', lucky: { enabled: true }, chips: [10, 50, 100, 500, 1000], startBalance: 50000, limits: { spot: 5000, table: 25000 } },
  progress: { wheel: { alwaysReady: false, everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
  winTiers: { big: 5, mega: 12, epic: 25 },
};
Opción Qué hace
brand.name nombre del juego usado en la página y en los mensajes
brand.storageKey prefijo de los datos guardados en el navegador (por defecto tiki-paradise.template.save.v1); cámbialo para empezar con una partida 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. La elección del jugador en OPCIONES y ?lang=xx en la dirección tienen prioridad
languages los idiomas que se ofrecen en OPCIONES (por defecto: los 14). Con un solo idioma se oculta el selector
texts reemplaza 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 en silencio
ageGate true muestra el distintivo 18+ y el aviso de casino social
notice el aviso de créditos de una línea debajo de la mesa. Déjalo activado: SCOPE.md lo exige en las publicaciones para el público
showRtp muestra el retorno de las apuestas en la página de reglas
debug solo para pruebas: permite ?seed=123 (las mismas rondas cada vez) y ?result=7 (la bola cae en el 7) en cualquier hosting
rules la mesa: zeroRule ('half' un retorno de aproximadamente el 96,15%, 'evenHalf' solo las apuestas 1:1 recuperan la mitad, 'none' la mesa clásica con el 92,31%), pays, lucky (enabled, count, straight, mults, weights), chips, startBalance, limits, wheel (el orden de las casillas), red. Un pago que devolvería más del 100% se rechaza con un mensaje. Ejecuta npm run rtp después de cambiarlo
progress niveles (levels.enabled, need, reward, unlock), la ruleta diaria (enabled, alwaysReady, everyHours, prizes, weights), monedas gratis (enabled, everyHours, amount) y misiones (enabled, perDay, reward). Las cantidades son múltiplos de la ficha más pequeña
winTiers a cuántas veces los créditos apostados empiezan las celebraciones big, mega y epic
integration, callbacks eventos para tu propia página, consulta "Eventos"

El archivo del paquete enumera todas las opciones con un comentario. Los valores por defecto completos están en source/src/config.js, source/src/logic/rules.js y source/src/logic/progress.js.

Las matemáticas de la mesa

Con las reglas de fábrica, el retorno al jugador de cada apuesta está entre el 92,31% (las apuestas que cubren el 0) y el 96,15% (las demás, gracias a la regla de devolver la mitad en el 0). Los números de la suerte no lo cambian: mientras están activos, un pleno paga 9 a 1 en lugar de 11 a 1, y los multiplicadores devuelven esa diferencia en promedio. npm run rtp (en source/) calcula el retorno exacto de cada apuesta a partir de tus ajustes y lo comprueba con una simulación de millones de rondas.

Las casillas en la ruleta, en el sentido de las agujas del reloj: 0, 7, 2, 9, 4, 12, 6, 1, 8, 3, 10, 5, 11. Rojos: 1, 3, 5, 7, 9, 12; los otros seis son negros y el 0 es verde. La ficha mínima es el primer valor de rules.chips (10, 50, 100, 500, 1000 en el ajuste de fábrica); lo máximo en una casilla es 5.000 y en toda la mesa 25.000 por ronda. Un jugador nuevo empieza con 50.000 créditos de demostración gratuitos.

El número se sortea al tocar GIRAR, y cada uno de los 13 tiene la misma probabilidad (o con ?seed= / ?result= durante las pruebas). Después se simula el vuelo de la bola para que se detenga en esa casilla: solo muestra el resultado.

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 locutor (el tucán) y los títulos pintados (BIG WIN, MEGA WIN, EPIC WIN, DAILY WHEEL) están en inglés en todos los idiomas. El juego se abre en el idioma del dispositivo; el jugador puede cambiarlo en OPCIONES, 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 tiki-paradise.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}.

La misma ronda en portugués
La misma ronda en portugués

Datos guardados

El juego guarda el saldo, las apuestas sobre la mesa, los últimos resultados, el nivel, las misiones, las apuestas favoritas, los ajustes y los temporizadores de recompensas en el localStorage del navegador, con claves que empiezan por tiki-paradise.template.save.v1. (por ejemplo tiki-paradise.template.save.v1.balance). No se envía nada a ningún sitio. Cada ronda se resuelve en el momento de tocar GIRAR, así que cerrar la página en mitad de una ronda no hace perder nada: la siguiente visita dice lo que pagó. Borrar los datos del sitio en el navegador reinicia el juego. Si publicas dos copias del juego en el mismo dominio, dale a cada una su propio brand.storageKey.

Eventos para tu página

El juego envía eventos para que tu página pueda mostrar estadísticas, logros o una clasificación de puntuaciones ficticias. No son una interfaz contable ni de pagos y no deben usarse como tal.

  • callbacks en tiki-paradise.config.js: onReady, onBet({ spot, amount, total }), onSpin(round), onWin(round), onBalance({ balance }), onBonus({ kind, amount, balance }).
  • window.TikiParadise.on('spin', fn), window.TikiParadise.getBalance(), window.TikiParadise.version.
  • Eventos DOM en window: tikiparadise:spin, tikiparadise:win...
  • Con integration: { postMessage: true, targetOrigin: 'https://your-site.example' } el juego también envía { source: 'tiki-paradise', type, payload } a la página principal cuando se ejecuta dentro de un iframe.

round.result es el número, round.spent los créditos de demostración puestos en la ronda, round.payout los créditos de demostración que devolvió y round.lucky los números de la suerte de la ronda ([{ n, x }]).

Editar el código fuente (Node.js para principiantes)

Solo necesitas esto para cambiar código, estilos, arte o sonidos y compilar un nuevo game/. Para cambiar ajustes, edita tiki-paradise.config.js.

1. Instalar Node.js

  1. Ve a 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: los dos comandos deben mostrar un número, y Node debe ser 26.13.0 o más reciente.
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 Enter; macOS: arrastra la carpeta sobre el 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, ver la vista previa y compilar

npm test
npm run dev
npm run build
  • npm test ejecuta las pruebas del motor (apuestas, pagos, la regla del 0, números de la suerte, créditos, retorno) y comprueba que la bola siempre cae donde dice la ronda. Todas deben pasar.
  • npm run dev inicia una vista previa local en http://localhost:5221/ que se recarga cuando guardas un archivo. Pulsa Ctrl+C para detenerla. En la vista previa, ?result=7 hace que la bola caiga en el 7 y ?lucky=7x50 elige los números de la suerte.
  • npm run build escribe el juego terminado en source/dist/. Sube el contenido de dist/ a tu hosting (reemplaza a game/). La compilación no está minificada y se formatea con Prettier, así que sigue siendo legible.

Otros comandos

  • npm run rtp muestra el retorno exacto de cada apuesta de tu mesa (src/logic/rules.js más las rules de public/tiki-paradise.config.js) y una simulación de millones de rondas.
  • npm run locales comprueba las traducciones.
  • npm run format formatea todo el proyecto con Prettier.
  • tools/qa-fit.js es una comprobación dentro de la página para la vista previa: en la consola del navegador, (await import('/tools/qa-fit.js')).check() enumera cualquier texto que no quepa en su placa.

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 lock no está sincronizado: cambiaste package.json; ejecuta npm install una vez y npm ci volverá a funcionar.
  • El puerto 5221 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 quien no programa: cambiar el fondo, el logotipo, el crupier, las fichas, los sonidos y la música, los colores, los textos, las reglas de la mesa y las recompensas. En resumen:

  • Arte: source/public/art/ (o game/art/ en el hosting). Reemplaza un archivo por otro WebP con el mismo nombre y el mismo tamaño.
  • Sonidos: source/public/audio/ (o game/audio/). Reemplaza un MP3 por otro con el mismo nombre.
  • La ruleta: sus casillas y números se dibujan por código (source/src/ui/roulette.js), así que siempre siguen rules.wheel y rules.red; el aro dorado y la torreta son arte (rim.webp 900 × 900, hub.webp 420 × 420).
  • Tiempos y efectos: source/src/ui/feel.js (cuánto dura cada parte de una ronda, cámara lenta, sacudidas, monedas) y source/src/ui/theme.js (colores del brillo y de los rayos). Solo presentación: nada de ahí cambia un resultado.
  • Diseño y estilos: source/src/ui/styles.css (la estructura común) y game.css (la mesa de ruleta).
  • Textos: texts en tiki-paradise.config.js o source/src/locales/.
  • Reglas de la mesa: rules en tiki-paradise.config.js o source/src/logic/rules.js, y después npm run rtp.

Los cambios en source/ necesitan npm run build. Los cambios en archivos de game/ en el hosting (arte, audio, tiki-paradise.config.js) no necesitan compilar.

Nombres internos

Parte del código se comparte con otros juegos de la misma familia, así que algunos nombres describen algo distinto de lo que dicen. Son solo nombres:

Nombre en el código Qué es
SLOTS, slot, slotOf() una casilla de la rueda: SLOTS = 13 casillas, slot = la posición de una casilla en la rueda, en sentido horario (no es una tragamonedas)
jackpot (src/ui/wheel.js) la porción dorada de la rueda diaria: su premio mayor, en créditos de demostración gratis
fx.snow, THEME.ambient las brasas cálidas que suben de las antorchas tiki (THEME.ambient.rise = true)
fx.frost() un efecto del código compartido que este juego no usa
.entry-cta, .entry-logo, .entry-mascot la pantalla de inicio: TAP TO PLAY, el logo y el tucán barman
CreditBank, round.spent, round.payout los créditos ficticios de demostración: lo que una ronda recibió y devolvió (sin dinero)

Actualizar el juego y borrar la caché

Después de subir una versión nueva, los navegadores y los hostings 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 en una ventana privada (de incógnito).
  • Si tu hosting o tu CDN (por ejemplo Cloudflare) tiene caché, púrgala.
  • Añade una vez una versión a la dirección, por ejemplo index.html?v=2.

Los datos guardados se conservan tras una actualización mientras 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. Ningún tipo de premio.
  • Ningún sistema de pago, depósito, retiro, cuenta ni monedero: no hay ninguno 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 o con cualquier cosa de valor real: sin compra de créditos, sin retiro de dinero, sin premios según los resultados, sin conexión a un monedero de juego, un sistema de pago o un operador de dinero real, sin publicidad de juegos de azar con dinero real.
  • Debes cumplir las leyes de cada lugar donde publiques el juego (clasificación por edad, menores, protección del consumidor). Mantén visible el aviso de créditos; ageGate: true añade un aviso de 18+.
  • El soporte no cubre monederos, depósitos, retiros ni ninguna integración con dinero real; esas peticiones 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 sonido después de un toque: el juego lo inicia en TOCA PARA JUGAR. Revisa el menú (botón de sonido), OPCIONES (música, efectos) y el volumen del dispositivo. Si un teléfono corta el sonido (una llamada, otra aplicación), el siguiente toque lo recupera.
  • ¿Puedo cambiar el retorno? Sí: rules.zeroRule, rules.pays y rules.lucky; npm run rtp mide tu mesa, y un ajuste que devolvería más del 100% se rechaza.
  • ¿Puedo jugar con la mesa clásica sin números de la suerte? Sí: rules: { lucky: { enabled: false } } (el pleno paga 11 a 1). zeroRule: 'none' quita la regla de devolver la mitad.
  • ¿Los jugadores pueden comprar créditos o ganar premios? No. El juego no tiene sistema de pagos ni de premios, y la licencia no permite añadir uno.
  • ¿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 para el público debe seguir visible (consulta SCOPE.md).
  • La ruleta diaria se abre en cada visita. Es el ajuste de demostración alwaysReady: true; pon progress: { wheel: { alwaysReady: false } }.
  • ¿Cómo muestro un resultado elegido? En la vista previa local, o con debug: true durante las pruebas, añade ?result=7 (y ?lucky=7x50) a la dirección.

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/). En game/ no se incluye código de terceros. El arte, la música, la voz y los efectos forman parte del juego y están cubiertos por la licencia de tu compra.