Conectar IA a tu servidor Hytale

El plugin MCP (Model Context Protocol) revoluciona la forma en que gestionas tu servidor Hytale. Te permite conectar asistentes IA como ChatGPT, Claude, Codex o Gemini directamente a tu servidor para automatizar tareas complejas, construir estructuras automáticamente o administrar tu servidor en lenguaje natural.

MCP es un protocolo estandarizado que permite a los asistentes IA comunicarse de forma segura con aplicaciones externas. Para Hytale, esto significa que tu IA puede ver el estado del servidor, colocar bloques, gestionar jugadores y ejecutar comandos.

Asistentes IA compatibles

• Claude (Anthropic) - Asistente de Anthropic, excelente para tareas complejas
• ChatGPT (OpenAI) - IA de OpenAI, ideal para conversaciones naturales
• Codex - Aplicación de OpenAI optimizada para programación
• Gemini (Google) - IA de Google, potente y versátil

• Construcción automatizada
  Pídele a la IA que construya un castillo, una casa o cualquier estructura. La IA calcula los bloques necesarios y los coloca automáticamente.
• Administración simplificada
  Gestiona jugadores, consulta los logs, difunde mensajes... todo en lenguaje natural.
• Moderación asistida
  Supervisa la actividad del servidor y toma decisiones con la ayuda de la IA.
• Desarrollo y pruebas
  Prueba rápidamente mecánicas de juego o configuraciones sin escribir código.

• ✔ Servidor Hytale: Un servidor Hytale funcional (ver nuestra guía de creación)
• ✔ Plugin WebServer: El plugin Nitrado WebServer debe estar instalado (dependencia obligatoria)
• ✔ Asistente IA: Una cuenta en Claude, ChatGPT, Codex o Gemini
• ✔ Red: Acceso HTTP/HTTPS a tu servidor desde Internet

Después del primer inicio, edita el archivo mods/MCP/config.json para configurar los tokens de autenticación y los permisos.

{
  "auth": {
    "enabled": true,
    "adminTokens": ["your-admin-token-here"],
    "playerTokens": ["your-player-token-here"]
  },
  "maxBlocksBatch": 1000,
  "adminPermissions": {
    "set_block": true,
    "set_blocks": true,
    "flatten_terrain": true,
    "execute_command": true,
    "list_players": true,
    "send_message": true,
    "broadcast_message": true,
    "get_player_position": true,
    "list_blocks": true,
    "get_server_logs": true,
    "get_world_info": true,
    "give_item": true
  },
  "playerPermissions": {
    "set_block": false,
    "set_blocks": false,
    "flatten_terrain": false,
    "execute_command": false,
    "list_players": false,
    "send_message": false,
    "broadcast_message": false,
    "get_player_position": false,
    "list_blocks": false,
    "get_server_logs": false,
    "get_world_info": false,
    "give_item": false
  }
}

Seguridad importante

Configuración para Codex (OpenAI)

En la aplicación Codex, añade un servidor MCP con los siguientes parámetros:

{
  "mcpServers": {
    "hytale-server": {
      "url": "http://your-server:port/Top-Games/MCP/mcp",
      "headers": {
        "Authorization": "Bearer your-admin-token"
      }
    }
  }
}

Configuración para Claude Desktop

Añade la siguiente configuración en el archivo de configuración de Claude Desktop:

{
  "url": "http://your-server:port/Top-Games/MCP/mcp",
  "auth": {
    "type": "bearer",
    "token": "your-admin-token"
  }
}

Configuración para ChatGPT

Para ChatGPT, utiliza la API de OpenAI con un cliente MCP compatible o configura a través de la interfaz Custom Actions.

Construcción y terreno

• Colocar un bloque en coordenadas precisas
• Colocar varios bloques en una sola operación (hasta 1000)
• Aplanar una zona rectangular a una altura dada
• Buscar y listar los tipos de bloques disponibles

Gestión de jugadores

• Ver la lista de jugadores conectados
• Obtener la posición y rotación de un jugador
• Enviar un mensaje privado a un jugador
• Dar objetos a un jugador

Administración del servidor

• Ejecutar cualquier comando del servidor
• Difundir un mensaje a todos los jugadores
• Consultar los logs del servidor con filtrado
• Obtener información sobre el mundo actual

Estas son las principales herramientas que la IA puede utilizar mediante MCP:

Ejemplo 1: Construir una casa

Prompt: "Constrúyeme una pequeña casa de madera con ventanas y una puerta en las coordenadas X:100, Y:64, Z:200"

Ejemplo 2: Preparar un terreno plano

Prompt: "Aplana el terreno de X:0 a X:50 y Z:0 a Z:50 a la altura Y:70"

Ejemplo 3: Enviar mensaje de bienvenida

Prompt: "Envía un mensaje de bienvenida a todos los nuevos jugadores"