Neblla developer docs

Neblla is a platform to build and publish multiplayer web apps and games. Add one <script> tag and your HTML app gets rooms, real-time messaging (P2P WebRTC or server), player accounts and saved data, friends, in-app purchases and AI — no backend to run. Apps are hosted on play.neblla.com and listed in a public gallery.

• For AI agents: the MCP server at https://neblla.com/mcp (streamable HTTP, OAuth 2.1) lets an agent create apps, upload files, configure and publish them. Server card: /.well-known/mcp.json. Chapter: MCP server.
• SDK: <script src="https://neblla.com/connect/app/<appId>"></script> — full reference in SDK reference.
• HTTP API: OpenAPI 3.1 (public gallery, SDK loader, docs).
• Plain text for LLMs: /llms.txt (index) and /llms-full.txt (everything in one file).

The guide below is written in Spanish; every chapter is also available as plain text under /llms/<chapter>.txt.

Chapters

• Core — the base contract — txt
• Rooms and matchmaking — txt
• The server (peer, WASM, infra) — txt
• Identity and persistence — txt
• Friends and inbox — txt
• Community (beta) — txt
• Purchases (beta) — txt
• Built-in AI — txt
• Publishing and quotas — txt
• SDK reference — txt
• MCP server — txt

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: conexión, estructura de 6 ficheros, eventos, ciclo de vida, patrones de app y reglas clave.
• Salas y emparejamiento: lobby, bookRoom/joinRoom/startRoom, gathering, salas efímeras/públicas/privadas, room.data, historial y eventos de salas.
• El servidor: modos peer-JS/peer-WASM/infra, setState, handover y sucesión, confirm() y anti-cheat, flags.
• Identidad y persistencia: login SSO, scopes, guests, save() y merges, BBDD propia del dev, sessionExpired/reconnected.
• Social: API de amigos, inviteToApp y comunicaciones dev↔usuario (inbox).
• Comunidad (BETA): entries publicadas por los usuarios (neblla.community): publicar, listar/buscar/facetas, hilos por parentId, modos de moderación y cola de moderadores.
• Compras (BETA): productos, neblla.buy() con Stripe, consume, validatePurchase, evento purchase.
• IA integrada: neblla.ai(), presets, las 3 rutas de pago de tokens, límites y entrega diferida.
• Publicar y cuotas: metadatos de galería y la tabla completa de consumos de cuota por acción.
• Referencia del SDK: todos los métodos, eventos y propiedades con su firma, y la plantilla completa turn-based.
• Servidor MCP: 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