# Neblla

> SDK multijugador que se carga con una etiqueta `<script>`: salas, identidad, persistencia, amigos, pagos e IA sin servidor propio, sin npm y sin build. Las apps corren en play.neblla.com; se crean en developers.neblla.com o vía el servidor MCP en https://neblla.com/mcp.

## Cómo leer esta guía

El capítulo **core** es imprescindible: contrato de ficheros, modelo cliente/presentador/servidor, comunicación events-only y ciclo de vida de las salas. Léelo siempre antes de generar código. El resto de capítulos se cargan según lo que la app use (salas persistentes, pagos, IA, etc.). Vía MCP: tool `neblla_get_llms` con el parámetro `section` para pedir un capítulo concreto.

## Capítulos

- [Core — el contrato base](https://neblla.com/llms/core.txt): conexión, estructura de 6 ficheros, eventos, ciclo de vida, patrones de app y reglas clave.
- [Salas y emparejamiento](https://neblla.com/llms/salas.txt): lobby, bookRoom/joinRoom/startRoom, gathering, salas efímeras/públicas/privadas, room.data, historial y eventos de salas.
- [El servidor](https://neblla.com/llms/servidor.txt): modos peer-JS/peer-WASM/infra, setState, handover y sucesión, confirm() y anti-cheat, flags.
- [Identidad y persistencia](https://neblla.com/llms/identidad.txt): login SSO, scopes, guests, save() y merges, BBDD propia del dev, sessionExpired/reconnected.
- [Social](https://neblla.com/llms/social.txt): API de amigos, inviteToApp y comunicaciones dev↔usuario (inbox).
- [Compras (BETA)](https://neblla.com/llms/pagos.txt): productos, neblla.buy() con Stripe, consume, validatePurchase, evento purchase.
- [IA integrada](https://neblla.com/llms/ia.txt): neblla.ai(), presets, las 3 rutas de pago de tokens, límites y entrega diferida.
- [Publicar y cuotas](https://neblla.com/llms/publicar.txt): metadatos de galería y la tabla completa de consumos de cuota por acción.
- [Referencia del SDK](https://neblla.com/llms/referencia.txt): todos los métodos, eventos y propiedades con su firma, y la plantilla completa turn-based.
- [Servidor MCP](https://neblla.com/llms/mcp.txt): endpoint, OAuth, lista de tools y el flujo recomendado de creación de apps.

Versión completa en un solo fichero: https://neblla.com/llms-full.txt