Conectar IA ao seu servidor Hytale

O plugin MCP (Model Context Protocol) revoluciona a forma como gere o seu servidor Hytale. Permite conectar assistentes IA como ChatGPT, Claude, Codex ou Gemini diretamente ao seu servidor para automatizar tarefas complexas, construir estruturas automaticamente ou administrar o seu servidor em linguagem natural.

MCP é um protocolo padronizado que permite aos assistentes IA comunicarem de forma segura com aplicações externas. Para Hytale, isto significa que a sua IA pode ver o estado do servidor, colocar blocos, gerir jogadores e executar comandos.

Assistentes IA compatíveis

• Claude (Anthropic) - Assistente da Anthropic, excelente para tarefas complexas
• ChatGPT (OpenAI) - IA da OpenAI, ideal para conversas naturais
• Codex - Aplicação OpenAI otimizada para programação
• Gemini (Google) - IA da Google, potente e versátil

• Construção automatizada
  Peça à IA para construir um castelo, uma casa ou qualquer estrutura. A IA calcula os blocos necessários e coloca-os automaticamente.
• Administração simplificada
  Faça a gestão de jogadores, consulte os logs, difunda mensagens... tudo em linguagem natural.
• Moderação assistida
  Supervisione a atividade do servidor e tome decisões com a ajuda da IA.
• Desenvolvimento e testes
  Teste rapidamente mecânicas de jogo ou configurações sem escrever código.

• ✔ Servidor Hytale: Um servidor Hytale funcional (veja o nosso guia de criação)
• ✔ Plugin WebServer: O plugin Nitrado WebServer deve estar instalado (dependência obrigatória)
• ✔ Assistente IA: Uma conta no Claude, ChatGPT, Codex ou Gemini
• ✔ Rede: Acesso HTTP/HTTPS ao seu servidor a partir da Internet

Após o primeiro arranque, edite o ficheiro mods/MCP/config.json para configurar os tokens de autenticação e as permissões.

{
  "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
  }
}

Segurança importante

Configuração para Codex (OpenAI)

Na aplicação Codex, adicione um servidor MCP com os seguintes parâmetros:

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

Configuração para Claude Desktop

Adicione a seguinte configuração no ficheiro de configuração do Claude Desktop:

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

Configuração para ChatGPT

Para o ChatGPT, utilize a API OpenAI com um cliente MCP compatível ou configure através da interface Custom Actions.

Construção e terreno

• Colocar um bloco em coordenadas precisas
• Colocar vários blocos numa única operação (até 1000)
• Aplanar uma zona retangular a uma altura dada
• Pesquisar e listar os tipos de blocos disponíveis

Gestão de jogadores

• Ver a lista de jogadores conectados
• Obter a posição e rotação de um jogador
• Enviar uma mensagem privada a um jogador
• Dar objetos a um jogador

Administração do servidor

• Executar qualquer comando do servidor
• Difundir uma mensagem a todos os jogadores
• Consultar os logs do servidor com filtragem
• Obter informações sobre o mundo atual

Estas são as principais ferramentas que a IA pode utilizar através do MCP:

Exemplo 1: Construir uma casa

Prompt: "Constrói-me uma pequena casa de madeira com janelas e uma porta nas coordenadas X:100, Y:64, Z:200"

Exemplo 2: Preparar um terreno plano

Prompt: "Aplana o terreno de X:0 a X:50 e Z:0 a Z:50 à altura Y:70"

Exemplo 3: Enviar mensagem de boas-vindas

Prompt: "Envia uma mensagem de boas-vindas a todos os novos jogadores"