# War3AI / OpenWar3

> Interfaz abierta de Warcraft III 1.27 para agentes de IA: un runtime inyectado publica cada 50 ms el estado completo de todo el mapa y un flujo de eventos; los programas externos envían comandos semánticos que se aplican en ~1 fotograma, cada uno con su recibo y su código de motivo. El SDK de Python (openwar3) lo describe todo con la terminología del juego (códigos de cuatro caracteres, nombres de orden de las habilidades).

El camino más corto para escribir un Bot: lee "Las quince reglas" y las interfaces de api.json, hereda de openwar3.Bot e implementa on_start(g) / on_tick(g) / on_event(g, ev); usa solo métodos que existan en api.json.
Toda la documentación en un solo archivo: https://war3ai.com/es/llms-full.txt

## Empezar

- [Visión general de la documentación](https://war3ai.com/es/docs/index.md): Documentación de OpenWar3: qué es, qué hace; Inicio rápido, Tu primer Bot, Escribe un Bot con un LLM, API y protocolo, Pasarela y MCP — por dónde empezar depende de tu caso.
- [Inicio rápido](https://war3ai.com/es/docs/quickstart.md): Doble clic en start.bat y todo se instala solo; configura el directorio del juego en Farsight, lanza una partida y mira cómo un Bot de ejemplo toma el control. Unos 15 minutos.
- [Tu primer Bot](https://war3ai.com/es/docs/first-bot.md): Empieza con un Bot mínimo de 10 líneas, añade campesinos, comida, tropas, un héroe y un ataque, y aprende a leer los recibos.

## La IA escribe tu Bot

- [Escribe un Bot con un LLM](https://war3ai.com/es/docs/ai-bot.md): Puedes hacerlo sin saber programar: tú explicas bien cómo quieres que juegue y el LLM escribe el código. Copia la plantilla de prompt, describe tu estrategia, ejecútalo y pídele cambios.
- [Iteración autónoma del Agent](https://war3ai.com/es/docs/agent-loop.md): Deja que un Coding Agent juegue partidas, lea los resultados, cambie el código y vuelva a jugar por su cuenta. Necesita un comando que funcione sin supervisión, un informe de partida estructurado y un objetivo claro.
- [El LLM como asesor](https://war3ai.com/es/docs/llm-coach.md): Deja en manos del LLM qué acumular, dónde poner a los trabajadores y si este minuto toca atacar o aguantar; la capa de reglas solo ejecuta y veta. El cerebro de referencia ya funciona así; esta página explica el patrón y sus trampas.
- [El LLM usa herramientas directamente (MCP)](https://war3ai.com/es/docs/mcp.md): tools/war3_mcp.py es un servidor MCP. Conéctalo a Claude Code, Claude Desktop o cualquier cliente compatible con MCP y el LLM podrá ver la partida, dar órdenes, hablar con el jugador en pantalla, preguntarle con tarjetas y hacer capturas de la imagen, sin escribir código antes.

## Conceptos clave

- [Modelo mental](https://war3ai.com/es/docs/concepts.md): Instantánea, comando, recibo, evento, tick y lote. Con estos seis conceptos entenderás por qué la API tiene esta forma y cómo escribir código rápido.
- [Las quince reglas](https://war3ai.com/es/docs/rules.md): Cada una se aprendió a base de errores en partidas reales. Repásalas al escribir un Bot y te ahorrarás la mayor parte de la depuración.
- [Modo justo](https://war3ai.com/es/docs/fair-mode.md): Un cliente inyectado en el juego puede leer todo el mapa. El modo justo hace que el Bot solo vea lo que está en su visión, igual que un jugador humano y que las reglas de la Arena.

## Guías

- [Recetario de jugadas profesionales](https://war3ai.com/es/docs/cookbook.md): La ventaja de los mejores jugadores viene sobre todo de decenas de pequeños hábitos. Esta página lleva las jugadas profesionales más comunes, una a una, a código del SDK; cada fragmento se puede copiar tal cual en on_tick.
- [Bots de ejemplo](https://war3ai.com/es/docs/examples.md): Cuatro ejemplos de menor a mayor complejidad; todos se ejecutan tal cual y cada bloque de lógica corresponde a una capacidad del SDK. Además, un cerebro de referencia completo.
- [Depuración y rendimiento](https://war3ai.com/es/docs/debugging.md): Por qué un tick va lento, por qué un comando no surtió efecto, por qué el juego no se mueve. Diagnostica por síntomas y confírmalo con los scripts de verificación en vivo incluidos.

## Extensiones de juego

- [Compañero para RPG](https://war3ai.com/es/docs/companion.md): Dale al jugador un compañero IA en mapas de RPG o personalizados: te sigue, te ayuda contra los monstruos, te cura cuando vas mal de vida y charla contigo. Cuatro modos; hereda una clase, cambia unas cuantas propiedades y ya tienes tu propio compañero.
- [Lienzo](https://war3ai.com/es/docs/canvas.md): Dibuja sobre la imagen del juego cuadros de texto, paneles, barras de progreso, imágenes, círculos pegados al suelo y rutas con flecha. El runtime lo dibuja él mismo en cada fotograma sin cambiar el estado del juego, así que también es seguro en multijugador; desde Python, por HTTP o escribiendo directamente en memoria compartida.
- [Interfaz y entrada](https://war3ai.com/es/docs/ui-input.md): Los botones y las tarjetas de elección del lienzo se pueden pulsar y se resaltan solos al pasar el ratón; registra atajos de teclado, haz clic en el suelo para elegir una posición, lee a qué apunta el ratón y qué tiene seleccionado el jugador local. Clics, atajos, habilidades lanzadas, el texto completo del chat y los jugadores que se van: todo entra en el flujo de eventos.
- [Canal JASS](https://war3ai.com/es/docs/jass.md): Las 1291 funciones JASS que tienen los autores de mapas ahora se pueden llamar por su nombre desde fuera del juego: crear unidades, cambiar atributos, efectos, paneles, cuadros de diálogo, sonido, cámara, niebla… Cuatro formas de uso: consola Farsight, línea de comandos, HTTP y Python.
- [Mods de juego](https://war3ai.com/es/docs/mods.md): Un esquema no tiene por qué ser una IA que juega por ti: también puede ser un conjunto de reglas. Juegas tú en la ventana del juego y el mod prepara el inicio, genera enemigos, da recompensas, te pone botones y tarjetas de elección en pantalla y decide el resultado. Hereda de openwar3.Mod: un archivo, un modo de juego.

## Herramientas

- [Consola Farsight](https://war3ai.com/es/docs/console.md): Consola web local y también el único punto de entrada: configura el directorio del juego, arranca y detén los servicios y las instancias del juego, configura la siguiente partida, mira qué piensa la IA, da órdenes a mano, dirección de cámara, historial de partidas.
- [Esquemas de IA](https://war3ai.com/es/docs/schemes.md): Un esquema es una IA completa. Se cambia con un clic en Farsight, incluso en plena partida, y el nuevo toma el control al instante; exporta un zip para compartirlo, importa esquemas de otros para probarlos, y los resultados de cada esquema se registran solos.
- [Burbujas y modelos locales](https://war3ai.com/es/docs/speech.md): Haz que cualquier unidad del juego muestre burbujas de diálogo con cualquier identidad; conecta un LLM local y cada frase que entra recibe una respuesta sobre la cabeza de la unidad.
- [Pasarela](https://war3ai.com/es/docs/gateway.md): Pasarela WebSocket / JSON: las interfaces públicas que puede llamar el SDK de Python también las pueden llamar JS, C#, Go, Rust, páginas web o programas en otra máquina. Tres roles, con cliente JS y página de demostración incluidos; la latencia es la del carril rápido más ~1 ms.

## Referencia

- [Protocolo W3P](https://war3ai.com/es/docs/protocol.md): Todo el contrato entre el runtime y los programas externos: ocho bloques de memoria compartida, lectura del estado del mundo, lectura de eventos, envío de comandos, recibos, roles de carril, lienzo e interfaz y entrada. Si te integras desde un lenguaje distinto de Python, lee esta página.
- [Recibos y códigos de motivo](https://war3ai.com/es/docs/reason-codes.md): El recibo de cada comando incluye un código de estado y un código de motivo. Son la base para que Bots y agentes se corrijan solos: convierten "por qué no se hizo" en un número legible por máquina.
- [De dónde salen los datos](https://war3ai.com/es/docs/data-sources.md): Origen y precisión de cada tipo de dato. Si pasa algo que "parece raro", mira primero esta página.

## Otros

- [Preguntas frecuentes](https://war3ai.com/es/docs/faq.md): ¿Es un hack? ¿Qué versiones admite? ¿Qué ve y qué puede hacer la IA? ¿Puedo usarlo sin saber programar?…
- [Límites de uso](https://war3ai.com/es/docs/legal.md): Qué puedes hacer y qué no, las estadísticas de visitas de este sitio web y los avisos sobre marcas y licencias de terceros. Al usar este proyecto aceptas respetar estos límites.

## API

- [api.json](https://war3ai.com/es/api.json): Los 103 métodos de Game (name / category / status / latency / mechanism / signature / doc), generados a partir del código
- [Catálogo de API (web)](https://war3ai.com/es/api/): Versión con búsqueda de los mismos datos

## Opcional

- [llms-full.txt](https://war3ai.com/es/llms-full.txt): Toda la documentación + el catálogo de API, en una sola lectura
- [Límites de uso](https://war3ai.com/es/docs/legal.md): Solo para clientes que poseas legalmente; no debe usarse en Battle.net ni en ningún servidor con antitrampas