Intro Arquitectura IA CLI Export Modulos
EXPERIMENTAL — PYTHON 3.11+

OpenGame

Motor 2D IA-first en Python

Motor/editor experimental para crear, editar, ejecutar y exportar juegos 2D mediante escenas serializables, CLI oficial y una API pública pensada para automatización e IA.

VER REPOSITORIO → LEER DOCUMENTACION →
Scene serializable fuente de verdad
↓
Edit World proyeccion
↓
PLAY Runtime World simulacion
↓
STOP → vuelve a Scene persistencia

Que es OpenGame?

OpenGame es un motor/editor 2D experimental construido en Python. Su objetivo es separar claramente el contenido persistente, la simulacion en runtime y las herramientas de authoring, permitiendo que humanos, scripts y agentes IA trabajen sobre el mismo modelo de datos.

⚠

Este proyecto es experimental. Algunas capacidades son oficiales y estables, mientras que otras areas como RL, datasets y tooling multiagente se tratan explicitamente como experimental/tooling.

Arquitectura

Conceptos principales del motor

Scene

Fuente persistente de verdad. Contiene entidades, componentes serializables, reglas, metadata y referencias de prefab.

SERIALIZABLE

World

Proyeccion operativa usada por editor y runtime. No sustituye a la escena persistente.

RUNTIME

SceneManager

Coordina workspace, authoring, dirty state, historial y el ciclo EDIT → PLAY → STOP.

CORE

EngineAPI

Fachada publica para agentes, tests, CLI y automatizacion. Punto de entrada estable para todo desarrollo externo.

API PUBLICA
Editor
IA
CLI
↓
EngineAPI
↓
SceneManager
↓
Scene
←→
World
←→
Runtime

IA-first, pero sin humo

El motor expone una CLI oficial y una EngineAPI para que herramientas externas, tests y agentes IA puedan consultar, modificar y validar proyectos sin depender de tocar internals privados.

Disenado para agentes. Sin promesas falsas. 

from engine.api import EngineAPI

api = EngineAPI(project_root=".")
api.load_scene("levels/main_scene.json")
api.create_entity("Player", components={
    "Transform": {"x": 100, "y": 200}
})
api.save_scene()
api.shutdown()

CLI oficial motor

Interfaz de linea de comandos para automatizacion

$ py -m motor doctor --project . --json
$ py -m motor capabilities --json
$ py -m motor scene list --project . --json
$ py -m motor project bootstrap-ai --project .

doctor

Diagnostico del proyecto

scene list

Inspeccion de escenas

export build

Exportacion de builds

ai start

Entrada compacta para agentes IA

Exportacion de juegos

Pipeline de build multiplataforma

Preset
→
Validacion
→
Build Graph
→
Content Pack
→
Platform Exporter
→
Build Report
Windows
Linux
macOS
Android
iOS
Headless

Algunas plataformas dependen de toolchains externas como Android SDK, Gradle, Xcode o PyInstaller.

Modulos del motor

Core obligatorio

  • ▸ ECS
  • ▸ Scene
  • ▸ SceneManager
  • ▸ Serializacion
  • ▸ Editor base
  • ▸ EngineAPI
  • ▸ CLI
  • ▸ Fisica base

Modulos oficiales opcionales

  • ▸ Assets
  • ▸ Prefabs
  • ▸ Tilemap
  • ▸ Parallax
  • ▸ Audio
  • ▸ UI serializable
  • ▸ Export pipeline

Experimental / tooling

  • ▸ Navegacion
  • ▸ RL
  • ▸ Recetas IA
  • ▸ Agente nativo
  • ▸ Datasets
  • ▸ Benchmarks

Quick start

Ponte en marcha en minutos

$ py -m pip install -r requirements.txt
$ py -m pip install -e .[dev]
$ py -m motor --help
$ py main.py

ⓘ Requiere Python 3.11 o superior.

OpenGame

No es solo una demo: es una base experimental para construir juegos 2D con un modelo de datos serializable, una API automatizable y un flujo preparado para trabajar con herramientas IA.

VER REPOSITORIO → LEER README → VER ARQUITECTURA → VER CLI →