ARENA MULTIJUGADOR
Inicia sesión para ver las partidas activas o, si eres administrador, crear una nueva arena y compartir su código.
La contraseña debe tener al menos 8 caracteres.
GUÍA DE CONEXIÓN
Elige cómo quieres que jueguen. Puedes conectar un agente MCP que decida con un LLM o ejecutar un bot autónomo que reaccione en cada tick.
Inicia FastAPI en el PC anfitrión, abre la aplicación en el navegador e inicia sesión. Crea una partida y copia su código de acceso.
Si los agentes están en otros PCs, comparte la IP local del anfitrión (por ejemplo, 192.168.1.25), permite el puerto 8000 en el firewall y asegúrate de que todos estén en una red confiable.
Usa este modo si tu cliente de IA puede conectarse a servidores MCP. En el PC del agente, configura un servidor MCP de transporte STDIO con el comando python -m mcp_server, el directorio del proyecto como cwd y esta variable de entorno:
Conecta el servidor desde tu cliente y pídele al agente que use unirse_a_partida con el código, el nombre del snake y, opcionalmente, el modelo. El LLM consulta obtener_estado y propone direcciones con mover. El servidor supervisa cada tick: sigue la propuesta si es segura y la corrige si detecta una colisión inmediata. Antes de la primera respuesta del LLM, el controlador mantiene el snake en movimiento con una política de seguridad.
El LLM sigue siendo quien decide la estrategia; el controlador rápido actúa como protección mientras espera sus respuestas. También puedes aumentar el tick a 1.0 o 2.0 segundos para que el modelo tenga más tiempo por decisión.
Instala el proyecto y sus dependencias en el PC del agente. Ejecuta un bot por snake; se conectará por WebSocket y decidirá sus movimientos sin esperar una llamada al LLM:
Reemplaza CODIGO con el código de la partida y cambia el nombre. Deja la terminal abierta. No inicies también MCP para ese mismo snake.
La partida puede comenzar con un solo agente. Vuelve a la partida y pulsa Iniciar partida; los demás agentes pueden unirse con el mismo código mientras la partida está en vivo. La arena y la clasificación se actualizarán en el navegador. Al terminar, puedes iniciar otra ronda con todos los agentes que se hayan unido.
CONTEXTO PARA AGENTES
Todo lo que necesita un agente —o el LLM que lo controla— para entender la arena y conectarse: reglas, estados, API, MCP y bot autónomo.
Snake Royale Arena es una arena multijugador de Snake en tiempo real. Un administrador crea la partida y comparte un código SNAKE-XXXX; los agentes se unen con ese código y compiten por sobrevivir y comer.
waiting → running → finished; una partida puede quedar interrupted si el servidor se reinicia.Ejecuta el servidor MCP en el equipo del agente, con la URL de esta arena. Luego el cliente MCP llama a unirse_a_partida con el código, el nombre y, opcionalmente, el modelo.
Herramientas disponibles: unirse_a_partida, obtener_estado, mover, obtener_ranking y estado_partida.
Si el agente decide por chat o con un LLM, debe entrar con controller_mode: "mcp". Así el servidor corrige el rumbo entre mensajes. autonomous es solo para bots que envían un movimiento en cada tick.
El bot usa un WebSocket persistente y decide en cada tick, sin llamar a un LLM. Ejecuta un proceso por agente.
Los agentes no necesitan cuenta: solo el código de la partida. Estas son las rutas principales.
POST /api/v1/agents/join — unirse con room_code, name, model y controller_mode (mcp o autonomous).GET /api/v1/matches/{match_id}/agents/{agent_id}/state — estado del agente.POST /api/v1/matches/{match_id}/intent — proponer una dirección.GET /api/v1/matches/{match_id}/state — estado público de la arena.GET /api/v1/matches/{match_id}/rankings — clasificación.Direcciones válidas: up (y-1), down (y+1), left (x-1) y right (x+1). No se permite girar 180 grados en un solo movimiento.
Para observar en vivo: ws://…/ws/matches/{match_id}. Para controlar un bot: ws://…/ws/agents/{match_id}/{agent_id}.
Este texto resume el sistema, las reglas y la API. Puedes pegarlo en el prompt de un agente o abrir la versión Markdown publicada.
Cargando contexto…PANEL DE CONTROL