La Horda

ARPG de horda + Arena Divina (prototipo de MOBA 4v4), hecho en HTML5 / Canvas 2D puro (JavaScript sin dependencias ni frameworks).

Cómo jugarlo

No necesita instalación ni paso de "build": el navegador lee los archivos tal cual.

• Publicado: GitHub Pages sirve index.html directamente.
• Local: desde la carpeta del repo,

  python3 -m http.server 8000
  # y abrí http://localhost:8000
  

  También funciona abriendo index.html con doble clic.
• Preview de un commit (para probar desde el iPhone antes de mergear): https://rawcdn.githack.com/drmarianojimenez94-sudo/La-Horda/<commit>/index.html

El juego es horizontal: en el teléfono en vertical muestra un aviso para girarlo.

Estructura

index.html        esqueleto HTML de las pantallas + lista de estilos y scripts (en orden)
css/              estilos (base, menús, HUD, paneles, overlays)
js/               código del juego separado por sistema (datos, dibujo, combate, campeones,
                  arenas, IA, UI...). js/main.js arranca el juego.
assets/           arte en PNG: sprites de campeones, enemigos, jefes, arenas, efectos e íconos
tools/regression/ batería de pruebas automáticas (herramienta de desarrollo, no es parte del juego)
docs/             informes técnicos

Dónde está cada cosa, cómo agregar campeones/enemigos/habilidades/arenas/sprites y dónde tocar el balance: ver ARCHITECTURE.md.

Contenido actual

• Arena (modo horda): campaña de 10 arenas en orden — 01 Ciudad Maldita · 02 Fábrica Sin Fin · 03 Ruinas Célticas · 04 Reino Fúngico · 05 Arena Gélida · 06 Arena Acuática · 07 Laberinto · 08 Abismo · 09 Minas Profundas (la luz es territorio; matar a Cerbero abre el Portal Infernal y hay que atravesarlo; ver docs/arena-identity/minas.md) · 10 Arena Infernal —, 10 niveles cada una, subjefes y jefe final por arena. Fichas en docs/arena-identity/.
• Jefes con REGLA propia: cada jefe final tiene una mecánica que hay que resolver (red de núcleos, paredes agrietadas, tentáculos, Gran Helada, Convergencia…) con ventana EXPUESTO, anti-kite y anti-facetank. Ver LA_HORDA_BOSS_IDENTITY.md (matriz y exploits) y LA_HORDA_BOSS_ASSET_MANIFEST.md; pruebas en tools/bosses/boss_rules.js.
• 43 guardianes (clases del motor en CLASSES, catálogo en js/data/champions.js, categorías en js/data/champion-taxonomy.js: 32 Standard, 2 Familia, 7 Ascensión y 2 Fundadores), cada uno con 3 habilidades y definitiva. Los originales son Tanque, Guerrero, Mago, Soporte, Segador Olvidado, Axiom, La Profeta, Musashi, La Cazadora, Nigromante, El Libertador e Ilkan. Los contadores que ve el jugador salen de una sola función, championCounts(): 43 en total, 41 obtenibles por progresión (los 2 Fundadores no entran: se conceden) y 34 elegibles como regalo inicial (Standard y Familia comprables; Ascensión y Fundadores no). Un perfil nuevo elige un guardián de regalo (más una skin); los demás se compran en la Tienda o se ganan.
• Arena Divina: asedio 4v4 con torres, castillos, minions y campeones divinos.
• Progresión persistente en localStorage: niveles, oro, maestría de habilidades, árboles de talentos, objetos con rarezas/sets/fusión; exportación/importación por código.
• Códice (guardianes, bestiario, jefes y arenas) y Tienda (guardianes, objetos/sets y skins; precio por rareza; guardianes a 2.500 de oro (Ascensión con precio propio); Míticos y Únicos no se venden; un perfil nuevo empieza con 0 de oro: el regalo inicial es un guardián y una skin, js/storage/save.js y js/systems/starter-gift.js).
• Cooperativo online de hasta 4 guardianes (sala con código de 6 letras; relay en server/).

Carga de imágenes

• Dos tandas (js/assets/lazy-images.js + js/assets/preload.js): primero lo que se ve en título, menús, Sala y guardianes (~11 MB); el arte de las arenas y los efectos (~28 MB) baja mientras se navegan los menús. La partida espera a que esté todo ("Preparando la arena… N %"): nunca se juega con arte a medio cargar.
• WebP sin pérdida: python3 tools/art/webp_convert.py genera una copia .webp (mismos píxeles) de cada PNG del manifiesto y la lista js/assets/asset-webp.js. Si agregás o cambiás una imagen, volvé a correrlo (si no, se usa el PNG, que también funciona).
• Medición con red 4G simulada: node tools/audit/loadtime.js (título: 52,5 s → 13,9 s).

Servidor del multijugador

server/relay.js, desplegado en Render con render.yaml. Acepta conexiones del juego publicado (GitHub Pages) y de las previews. En el plan gratuito se duerme: el juego lo despierta al abrir y, al crear o unirse, reintenta solo hasta ~100 s mostrando "Despertando el servidor… N s". Si el servidor rechaza la conexión, la Sala muestra el motivo. Prueba: node tools/net-test/coldstart.js.

Verificación del juego publicado: el workflow Live check (.github/workflows/live-check.yml) corre una vez por día y a mano desde la pestaña Actions. Despierta el relay de Render, crea una sala y se une con el código (tools/net-test/live_relay.js), hace el flujo de la Sala con dos iPhone emulados contra GitHub Pages y mide la carga en 4G.

Pruebas de celular y fluidez

• node tools/audit/ui_layout.js: 43 pantallas en iPhone 14 y SE apaisados (botones de menos de 40 px, textos chicos, cosas fuera de pantalla). Los ajustes para celular están en css/mobile.css.
• node tools/audit/fps.js [arena] [cpu]: fluidez. Si el juego va lento, la resolución interna baja sola (75 % / 60 %; js/core/canvas.js); ?res=0.75 la fija para probar.

This is the beginning of the README. Read the rest at the original. Read the full README ↗