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.
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.
- Abre el administrador de archivos de tu hosting o conéctate con un programa de FTP (por ejemplo, FileZilla).
- Crea una carpeta para el juego, por ejemplo
/games/witch-flight/. -
Sube el contenido de
game/a esa carpeta:index.html, los archivos.jsy.css,SCOPE.md,DOCUMENTATION.txty las carpetasarte/,audio/,fontes/ylib/. -
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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
- Botón de inicio (dirección en WF_CONFIG, u oculto)
- Saldo de créditos de juego
- Recarga gratis (+10.000 créditos de juego)
- Activar/desactivar el sonido
- Mejores vuelos
- Menú
- Multiplicador (el título de arriba indica la fase de la ronda)
- Rondas recientes
- Bajar la apuesta
- Subir la apuesta
- Activar/desactivar el retiro automático
- Objetivo del retiro automático
- BET / CASH OUT / CANCEL (muestra la apuesta, o cuánto vale ahora)
- 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.
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.
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.
1
2
3
4
5
6
- Efectos de sonido
- Música
- Reducir movimiento
- Idioma (14)
- Cómo jugar (tutorial)
- Juego justo (hash y semilla)
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." |
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
- 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.
- El hash se muestra en Menú > FAIR PLAY antes del despegue.
- 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.
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.
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
-
Ve a
https://nodejs.orgy 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. - Cierra y vuelve a abrir tu terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal).
- 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 testcomprueba 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 startinicia un servidor local enhttp://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 buildcopia el juego asource/dist/(la carpeta se vacía primero, así que un archivo borrado también sale de ella). Sube el contenido dedist/: reemplaza agame/. -
npm run formatda formato a todos los archivos con Prettier;npm run checksolo comprueba.
Problemas comunes
-
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 y despuésnpm civuelve a funcionar. -
EADDRINUSEconnpm 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,APOSTASyAUTOSenjogo.js; la matemática enmotor.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 deindex.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/(conlib/,arte/,audio/yfontes/) y que lo abres por http(s), no confile://. 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í,
RTPenmotor.js; después ejecutanpm test. -
¿Puedo volver a las rondas con cuenta regresiva? Sí:
modo: 'sala'enWF_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.