# SouthGames

> Plataforma B2B de gamificación y fidelización. Las organizaciones crean
> campañas con juegos, premios, puntos, niveles, rankings y notificaciones, y
> las integran en sus apps mediante SDKs (Flutter, iOS, Android, JavaScript,
> Unity) o una API REST. Los juegos HTML5 del marketplace los construyen
> desarrolladores externos y las organizaciones los instalan y configuran.

Los dos primeros archivos están escritos para consumo de máquina: son
autocontenidos y bastan para construir y publicar un juego sin abrir nada más.

## Recursos para agentes

- [Game SDK — referencia completa](https://southgames.ai/llms-game-sdk.txt): protocolo del bridge postMessage, reglas del bundle ZIP, esqueleto de juego copiable, harness de prueba, reglas duras de producción y checklist de verificación.
- [Marketplace — operación completa](https://southgames.ai/llms-marketplace.txt): registro de desarrollador, creación del juego, configSchema, envío de versión, revisión, publicación, instalación y actualización de la versión instalada, con el nombre exacto de la operación de cada paso.

## Construir juegos para el marketplace

- [Guía: crea tu juego para el marketplace](https://southgames.ai/docs/guides/marketplace-games): la misma información que los dos archivos anteriores, redactada para personas.
- [Paquete npm @southgames-sdk/game-sdk](https://www.npmjs.com/package/@southgames-sdk/game-sdk): implementación tipada del protocolo del bridge, sin dependencias.

## API REST

- [Inicio rápido](https://southgames.ai/docs/getting-started/quick-start): primera integración de punta a punta.
- [Autenticación](https://southgames.ai/docs/getting-started/authentication): API keys, cabeceras y entornos.
- [POST /games/play](https://southgames.ai/docs/api/play): registrar una partida, reportar `gameResult`, premios, ranking y el 403 `PLAYER_BANNED`.
- [GET /campaigns](https://southgames.ai/docs/api/campaigns): campañas activas de una organización, con el `embedUrl` firmado de los juegos de marketplace.
- [Errores](https://southgames.ai/docs/guides/errors): forma de los errores y códigos estables.

## SDKs de integración

- [Instalación del SDK Flutter](https://southgames.ai/docs/sdk/installation): dependencia, inicialización e identificación de usuarios.
- [Juegos de marketplace en el SDK Flutter](https://southgames.ai/docs/sdk/marketplace): widget de WebView que aloja el juego y habla el protocolo postMessage.
- [Paquete npm @southgames/js](https://www.npmjs.com/package/@southgames/js): SDK JavaScript/TypeScript para apps web.

## IA y automatización

- [Servidor MCP](https://southgames.ai/docs/mcp/overview): acceso a los datos de una organización desde clientes MCP con OAuth 2.0.
- [Recursos MCP](https://southgames.ai/docs/mcp/resources): qué expone el servidor.

## Documentación completa

- [Índice de documentación](https://southgames.ai/docs): guías, API REST, SDKs, webhooks y métricas.