Witch Flight 1.0.0: guía del comprador

Juego crash en HTML5 con créditos ficticios gratuitos. Código fuente editable incluido.

Guía de personalización (recetas)

EnglishPortuguêsEspañol

Descripción general

Witch Flight es un juego crash en HTML5. El jugador hace una apuesta, una bruja despega en su escoba y un multiplicador sube mientras vuela. Cobra antes de que caiga para ganar la apuesta por el multiplicador; si ella cae primero, la apuesta se pierde. Viene como juego listo para alojar (game/) y con su código fuente completo y editable (source/). Funciona en cualquier navegador actual, en celulares, tabletas, computadoras y pantallas ultrapanorámicas, en vertical y en horizontal, sin servidor, base de datos ni cuenta.

Funciones: dos modos de ronda (Solo, el predeterminado, y Sala (room)), cobro automático, celebraciones BIG / MEGA / EPIC WIN, una ventana de juego limpio (hash antes del despegue, semilla después), lista de mejores vuelos, rondas recientes, recarga gratis, interruptores de sonido y música, una opción de "reducir movimiento", un tutorial de 3 pasos y 14 idiomas de interfaz. La bruja está animada con una malla articulada en tiempo real: su cabello y su capa se mueven con física.

Solo juego recreativo. El jugador recibe créditos de juego ficticios y gratuitos. 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 corresponde a una licencia de software. La licencia no permite el uso para apuestas con dinero real ni con otro 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) durante un vuelo.
La pantalla del juego (1280×720) durante un vuelo.

Instalar en tu sitio web

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

  1. Abre el administrador de archivos de tu hosting o conéctate con un programa de FTP (por ejemplo, FileZilla).
  2. Crea una carpeta para el juego, por ejemplo /games/witch-flight/.
  3. Sube el contenido de game/ a esa carpeta: index.html, los archivos .js y .css, SCOPE.md, DOCUMENTATION.txt y las carpetas arte/, audio/, fontes/ y lib/.
  4. Abre la dirección en un navegador, por ejemplo https://your-site.example/games/witch-flight/.

El juego usa rutas relativas, así que funciona en cualquier carpeta o subdominio. Abrir index.html directamente desde tu disco (file://) no funciona, porque ahí los navegadores bloquean los sonidos y los archivos de datos: pruébalo en un hosting o con npm start (consulta "Editar el código fuente").

Ponerlo dentro de una página (iframe)

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

Mantén visible el aviso en pantalla "Virtual credits only." (solo créditos virtuales) y conserva 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 con WebGL: Chrome, Edge, Firefox, Safari (macOS e iOS), Samsung Internet u Opera.
  • Solo para las pruebas, el servidor local y el build: Node.js 26 LTS (la línea LTS actual) y npm, consulta "Editar el código fuente".
  • No se necesita conexión a internet para jugar: el arte, los sonidos, las fuentes y la biblioteca PixiJS están todos dentro de game/. El juego no hace solicitudes a otros sitios.

Cómo jugar y las pantallas

El jugador elige una apuesta con – y + y toca BET (apostar). La bruja despega y el multiplicador sube; el botón grande pasa a ser CASH OUT (cobrar) y muestra cuánto vale la apuesta en ese momento. Tocarlo paga la apuesta por el multiplicador. Si ella cae primero ("FLEW AWAY"), la apuesta se pierde. Todos los montos son créditos de juego ficticios.

La pantalla del juego (1280×720) durante un vuelo. 1 2 3 4 5 6 7 8 9 10 11 12 13 14
La pantalla del juego (1280×720) durante un vuelo.
  1. Botón de inicio (dirección en WF_CONFIG, u oculto)
  2. Saldo de créditos de juego
  3. Recarga gratis (+10.000 créditos de juego)
  4. Activar/desactivar el sonido
  5. Mejores vuelos
  6. Menú
  7. Multiplicador (el título de arriba indica la fase de la ronda)
  8. Rondas recientes
  9. Bajar la apuesta
  10. Subir la apuesta
  11. Activar/desactivar el retiro automático
  12. Objetivo del retiro automático
  13. BET / CASH OUT / CANCEL (muestra la apuesta, o cuánto vale ahora)
  14. Aviso "Virtual credits only." (manténgalo visible)

Cobro automático

Marca la casilla junto a AUTO CASH OUT y elige un objetivo (x1.20 a x100) en la lista: el juego cobra solo cuando el multiplicador lo alcanza.

Un retiro: el premio aparece junto a la bruja y las monedas vuelan al saldo.
Un retiro: el premio aparece junto a la bruja y las monedas vuelan al saldo.

Celebraciones

Un cobro de 10 veces la apuesta o más abre BIG WIN, de 25 veces MEGA WIN y de 50 veces EPIC WIN: la placa cuenta el premio hacia arriba mientras las monedas vuelan hacia el saldo. Un toque salta el conteo.

BIG WIN: un retiro de 10 veces la apuesta o más (importes en créditos ficticios de juego).
BIG WIN: un retiro de 10 veces la apuesta o más (importes en créditos ficticios de juego).
EPIC WIN: 50 veces la apuesta o más.
EPIC WIN: 50 veces la apuesta o más.
FLEW AWAY: cayó antes del retiro y la apuesta se pierde.
FLEW AWAY: cayó antes del retiro y la apuesta se pierde.

Menú, mejores vuelos y juego limpio

El botón de menú abre los efectos de sonido, la música, "reducir movimiento", el idioma, el tutorial (HOW TO PLAY) y FAIR PLAY (juego limpio). La corona abre los mejores vuelos de este navegador. El + verde junto al saldo da una recarga gratis de 10.000 créditos de juego.

El menú: sonido, música, reducir movimiento, idioma, cómo jugar y juego justo. 1 2 3 4 5 6
El menú: sonido, música, reducir movimiento, idioma, cómo jugar y juego justo.
  1. Efectos de sonido
  2. Música
  3. Reducir movimiento
  4. Idioma (14)
  5. Cómo jugar (tutorial)
  6. Juego justo (hash y semilla)
Los mejores vuelos de este navegador.
Los mejores vuelos de este navegador.
Móvil en vertical (390×844): el mismo juego, reorganizado.
Móvil en vertical (390×844): el mismo juego, reorganizado.

Modos de ronda

El juego tiene dos formas de llevar las rondas. Elige la que mejor se adapte a tu sitio.

Solo (predeterminado) Sala (room)
Cuándo empieza una ronda cuando el jugador pulsa BET (0,8 s después; la apuesta todavía se puede cancelar) sola, después de una cuenta regresiva de 5 segundos
Sin apuesta hecha la bruja flota en su lugar, el título dice PLACE YOUR BET, nada vuela los vuelos siguen; un jugador que se perdió la cuenta regresiva mira y entra en la siguiente
Etiquetas de cobro de otros jugadores ocultas visibles (jugadores simulados)
Rondas recientes en la primera visita vacía 5 vuelos aleatorios, para que la fila no esté vacía
Tutorial, paso 1 "Haz tu apuesta: la bruja despega enseguida." "Haz tu apuesta durante la cuenta regresiva."
Modo Solo: la bruja flota y espera una apuesta.
Modo Solo: la bruja flota y espera una apuesta.
Modo Sala: la cuenta atrás para el próximo vuelo.
Modo Sala: la cuenta atrás para el próximo vuelo.

Por qué Solo es el predeterminado: en un juego de un solo jugador no hay una ronda compartida que esperar. Hacer que el jugador mire un vuelo en el que no apostó solo lo retrasa, y las rondas sin apuesta crean resultados que nadie jugó. Sala mantiene el ritmo clásico de los juegos crash multijugador, con una cuenta regresiva entre vuelos.

Cómo cambiarlo

Abre index.html (en game/ en tu hosting, o en source/) y busca este bloque cerca del final:

<script>
  window.WF_CONFIG = { modo: 'solo' };
</script>

Cambia 'solo' por 'sala' (el valor en el código para el modo Sala) y recarga la página. Para probar sin editar, agrega ?modo=sala o ?modo=solo a la dirección: la dirección tiene prioridad sobre el bloque.

Qué incluye el paquete

witch-flight-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 and the settings block WF_CONFIG
    estilo.css            the styles
    jogo.js               the game (rounds, buttons, scene, effects)
    motor.js              the math
    idiomas.js            the 14 languages
    som.js, justo.js, bruxa.js, rig.js, ui.js
    lib/pixi.js           PixiJS 7.4.2 (MIT), not minified
    arte/, audio/, fontes/  images, sounds, fonts
    SCOPE.md, DOCUMENTATION.txt
  source/                 the complete editable project
    the same game files as game/
    tests/                npm test
    tools/                build.mjs (npm run build), serve.mjs (npm start)
    package.json, package-lock.json, .prettierrc, README.md
    licenses/             licences of PixiJS and Prettier
  THIRD-PARTY-LICENSES/   PixiJS, Prettier and the two fonts

game/ es exactamente lo que npm run build genera a partir de source/ (comprobado archivo por archivo antes de empaquetar).

Archivo Qué es
index.html la página: barra superior, escena, panel, ventanas y el bloque de configuración
estilo.css diseño para celular, computadora y pantalla ultrapanorámica, botones, ventanas, celebraciones
jogo.js el juego: rondas, botones, escena, efectos, celebraciones
motor.js la matemática: punto de caída, curva del multiplicador, pago
idiomas.js textos en 14 idiomas
som.js datos guardados y sonido (efectos, música, campanas de la cuenta regresiva)
justo.js SHA-256 para la ventana de juego limpio
bruxa.js el esqueleto de la bruja: huesos, cadenas del cabello y de la capa, orden de las capas
rig.js el motor de animación: deforma las capas de la bruja, física del cabello y de la capa
ui.js paneles y botones estirados dibujados sin uniones visibles

Configuración

El bloque de configuración (index.html)

window.WF_CONFIG se lee cada vez que se abre la página, así que puedes cambiarlo en tu hosting con un editor de texto y sin build.

window.WF_CONFIG = { modo: 'solo', home: '/games/', bots: false };
Opción Qué hace
modo 'solo' (predeterminado) o 'sala' (modo Sala). Consulta "Modos de ronda"
home dirección del botón de inicio arriba a la izquierda (predeterminado '../', la carpeta que está encima del juego), o false para ocultar el botón
bots true o false muestra u oculta las etiquetas de cobro de los jugadores simulados. Si no está definido, aparecen solo en el modo Sala

Valores del juego (jogo.js)

Son constantes cerca del inicio de jogo.js. Edita source/jogo.js y ejecuta npm run build, o edita game/jogo.js directamente en tu hosting (el archivo de game/ es el mismo archivo legible, no se compila nada).

Qué Dónde Predeterminado
Montos de apuesta (los botones – y +) const APOSTAS 10, 20, 50, 100, 200, 500, 1000, 2000, 5000
Objetivos del cobro automático const AUTOS x1.2, 1.5, 2, 3, 5, 10, 20, 50, 100
Saldo inicial y recarga gratis busca 10000 10.000 créditos de juego
Cuenta regresiva de Sala, pausa de Solo, tiempo que se muestra la caída FEEL.aposta, FEEL.apostaSolo, FEEL.depois 5 s, 0,8 s, 2,6 s
Hitos del multiplicador (campana y destello) FEEL.marcos 2, 3, 5, 10, 20, 50, 100, 200, 500
Umbrales de BIG / MEGA / EPIC WIN (veces la apuesta) FEEL.tiers 10, 25, 50
Monedas que vuelan hacia el saldo FEEL.moedas 42 por segundo (24 en pantallas táctiles)
Sacudida de pantalla FEEL.tremor como máximo 10 px

Matemática y retorno al jugador

Las reglas están en motor.js (unas 20 líneas):

Valor Predeterminado Qué hace
RTP 0.97 Retorno al jugador. La probabilidad de que un vuelo llegue a x es RTP / x, así que cobrar en cualquier objetivo devuelve en promedio el 97%
K 0.00009 Velocidad de la curva: x2 a unos 7,7 s, x5 a 17,9 s, x10 a 25,6 s
MAX 1000 Multiplicador más alto que puede alcanzar un vuelo

Después de cambiarlos, ejecuta npm test: simula 2 millones de vuelos para seis objetivos de cobro y falla si el retorno se aleja del RTP.

Juego limpio

  1. Cuando empieza una fase de apuestas, el juego sortea una semilla aleatoria y calcula su hash SHA-256. El punto de caída sale de la semilla, así que queda fijado antes de cualquier apuesta.
  2. El hash se muestra en Menú > FAIR PLAY antes del despegue.
  3. Después del vuelo, la semilla de ese vuelo aparece en la misma ventana, para que cualquiera pueda comprobar que SHA-256(semilla) es el hash que se mostró antes.
FAIR PLAY: el hash del próximo vuelo antes del despegue y la semilla del anterior después.
FAIR PLAY: el hash del próximo vuelo antes del despegue y la semilla del anterior después.

En el modo Solo, una semilla solo se usa cuando el jugador apuesta; cancelar y volver a apostar mantiene la misma semilla.

Direcciones de prueba

En tu propia computadora (localhost, 127.x, 192.168.x, 10.x) dos opciones de la dirección ayudan con las pruebas: ?crash=40 fuerza la siguiente caída en x40, y ?congela=3.47 congela la pantalla en x3.47 para capturas de pantalla. En un dominio público ambas se ignoran, así que los jugadores no pueden usarlas.

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). El juego se abre en el idioma del dispositivo y el jugador puede cambiarlo en el menú (LANGUAGE). Las palabras pintadas (el botón BET / CASH OUT / CANCEL, el logo y las placas BIG / MEGA / EPIC WIN) son imágenes y quedan en inglés en todos los idiomas. Los números usan el formato 1,250, porque la fuente dorada de los números es una imagen con esos caracteres.

El menú en japonés, uno de los 14 idiomas.
El menú en japonés, uno de los 14 idiomas.

Todos los textos están en idiomas.js, un bloque por idioma con las mismas claves que en. {0} y {1} se reemplazan por números y <br> es un salto de línea. Para agregar un idioma, copia el bloque en, dale un código nuevo (por ejemplo sv), traduce los valores y agrega su nombre a WF_NOMES. npm test comprueba que cada idioma tenga todas las claves y conserve los marcadores.

Datos guardados

El juego guarda el saldo, la apuesta, el cobro automático, las rondas recientes, los mejores vuelos, el idioma, el sonido y el estado del tutorial en el localStorage del navegador, con claves que empiezan por witch-flight.template.save.v1. (la constante SALVO en som.js). No se envía nada a ninguna parte. 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 prefijo SALVO.

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

El juego no necesita build: cada archivo de game/ es el archivo fuente legible. Node.js solo se usa para ejecutar las pruebas, un servidor local y la copia de source/ a una dist/ nueva. También puedes editar los archivos de game/ con cualquier editor de texto.

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 predeterminadas. Linux: usa tu gestor de paquetes o los binarios oficiales.
  2. Cierra y vuelve a abrir tu 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 de archivos, haz clic en la barra de direcciones, escribe powershell y pulsa Enter; macOS: arrastra la carpeta sobre el ícono de Terminal). Luego ejecuta:

npm ci

Esto instala en node_modules/ la versión exacta de Prettier indicada en package-lock.json. Necesita conexión a internet una vez. El juego en sí no tiene dependencias de npm.

3. Probar, jugar y hacer el build

npm test
npm start
npm run build
  • npm test comprueba la matemática y el retorno al jugador, el hash del juego limpio, las traducciones y que exista cada archivo que el juego pide. Todas las pruebas deben pasar.
  • npm start inicia un servidor local en http://localhost:8080/. Ábrelo en el navegador; recarga después de guardar un archivo. Pulsa Ctrl+C para detenerlo. Otro puerto: PORT=8090 npm start (Windows PowerShell: $env:PORT=8090; npm start).
  • npm run build copia el juego a source/dist/ (la carpeta se vacía primero, así que un archivo borrado también sale de ella). Sube el contenido de dist/: reemplaza a game/.
  • npm run format da formato a todos los archivos con Prettier; npm run check solo comprueba.

Problemas comunes

  • 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 después npm ci vuelve a funcionar.
  • EADDRINUSE con npm start: el puerto 8080 está ocupado; usa otro puerto como se indica arriba.

Personalizar y cambiar el aspecto

La guía de personalización (CUSTOMIZATION.html) tiene recetas paso a paso para quienes no programan: reemplazar la bruja, el fondo, los botones, el logo, los sonidos y la música, los colores y los textos, y cambiar las apuestas, las celebraciones y el modo de ronda. En resumen:

  • Arte: arte/ (imágenes WebP y máscaras PNG). Reemplaza un archivo por otro con el mismo nombre y el mismo tamaño.
  • Sonidos: audio/ (MP3). Reemplaza un archivo por otro con el mismo nombre.
  • Diseño y colores: estilo.css.
  • Textos: idiomas.js.
  • Valores y efectos: FEEL, APOSTAS y AUTOS en jogo.js; la matemática en motor.js.

Nombres internos

El código se escribió en portugués. Los nombres son solo nombres; esto es lo que significan:

Nombre en el código Qué es
jogo, motor, som, justo, bruxa, idiomas, estilo, fontes, arte juego, motor (matemática), sonido, justo, bruja, idiomas, estilo, fuentes, arte
camadas, fundo, novo capas, fondo, conjunto de arte más nuevo
Luma el nombre de la bruja en el motor de animación (Luma.Rig)
S.saldo, S.aposta, S.m, S.quebra saldo, apuesta actual, multiplicador, punto de caída
S.fase: aposta, voo, caiu fase de la ronda: apuestas, vuelo, cayó
apostar, decola, sacar, caiu hacer la apuesta, despegar, cobrar, ella cayó
MODO (solo, sala) el bloque de configuración: modo Solo o Sala (room)
FEEL, APOSTAS, AUTOS tiempos y efectos, montos de apuesta, objetivos del cobro automático
guarda, SALVO datos guardados en el navegador, el prefijo de sus claves
festa, placa, moedas, painel, botao celebración de victoria, placa, monedas, panel, botón

Actualizar el juego y borrar la caché

Después de subir una versión nueva, los navegadores y los hostings pueden conservar los archivos viejos 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 celular, cierra la pestaña y vuelve a abrirla.
  • Borra los archivos en caché del sitio en la configuración del navegador ("Imágenes y archivos en caché"). No borres "cookies y datos del sitio" a menos 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.
  • Agrega una versión a la dirección una vez, por ejemplo index.html?v=2, o a un archivo modificado dentro de index.html (jogo.js?v=2).

Los datos guardados se conservan tras una actualización siempre que el prefijo SALVO no cambie.

Qué es el producto (y qué no es)

  • Solo créditos de juego gratuitos y ficticios, sin valor monetario. No se pueden comprar, transferir, vender ni canjear. Ningún premio de ningún tipo.
  • Ningún sistema de pagos, depósitos, retiros, cuentas ni billeteras: 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 apuestas con dinero real ni con nada de valor real: nada de comprar créditos, nada de cambiar créditos por dinero, nada de premios basados en resultados, nada de conexión con una billetera de apuestas, un sistema de pagos o un operador de dinero real, nada de publicidad de apuestas 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 "Virtual credits only.".
  • El soporte no cubre billeteras, 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 queda en blanco o solo muestra la barra de carga. Comprueba que subiste el contenido de game/ (con lib/, arte/, audio/ y fontes/) y que lo abres por http(s), no con file://. La consola del navegador (F12) muestra el archivo que falta.
  • No hay sonido. Los navegadores solo permiten el sonido después del primer toque. Revisa el botón del altavoz, el menú (efectos de sonido, música) y el volumen del dispositivo.
  • ¿Puedo cambiar el RTP? Sí, RTP en motor.js; después ejecuta npm test.
  • ¿Puedo volver a las rondas con cuenta regresiva? Sí: modo: 'sala' en WF_CONFIG (consulta "Modos de ronda").
  • ¿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 agregar uno.
  • ¿Funciona sin conexión? Una vez cargado, sí; no necesita ningún otro sitio.
  • ¿Puedo quitar el aviso "Virtual credits only."? En una publicación pública debe permanecer visible (consulta SCOPE.md).
  • El juego va lento en un celular viejo. Activa "reducir movimiento" en el menú: quita la sacudida de pantalla y suaviza los efectos.

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 la configuración de esta guía). Incluye tu código de compra, el navegador y el dispositivo, y una captura de pantalla.

Código de terceros en el paquete: PixiJS 7.4.2 (MIT). Fuentes: Cinzel y Merriweather (SIL Open Font License 1.1). Herramienta de desarrollo: Prettier (MIT). Textos de las licencias en THIRD-PARTY-LICENSES/. El arte, la música, la voz y los efectos forman parte del juego y están cubiertos por la licencia de tu compra.