Connettere IA al tuo server Hytale

Il plugin MCP (Model Context Protocol) rivoluziona il modo in cui gestisci il tuo server Hytale. Ti permette di connettere assistenti IA come ChatGPT, Claude, Codex o Gemini direttamente al tuo server per automatizzare compiti complessi, costruire strutture automaticamente o amministrare il tuo server in linguaggio naturale.

MCP è un protocollo standardizzato che permette agli assistenti IA di comunicare in modo sicuro con applicazioni esterne. Per Hytale, questo significa che la tua IA può vedere lo stato del server, posizionare blocchi, gestire i giocatori ed eseguire comandi.

Assistenti IA compatibili

• Claude (Anthropic) - Assistente di Anthropic, eccellente per compiti complessi
• ChatGPT (OpenAI) - IA di OpenAI, ideale per conversazioni naturali
• Codex - Applicazione OpenAI ottimizzata per la programmazione
• Gemini (Google) - IA di Google, performante e versatile

• Costruzione automatizzata
  Chiedi all'IA di costruire un castello, una casa o qualsiasi struttura. L'IA calcola i blocchi necessari e li posiziona automaticamente.
• Amministrazione semplificata
  Gestisci i giocatori, consulta i log, diffondi messaggi... tutto in linguaggio naturale.
• Moderazione assistita
  Supervisiona l'attività del server e prendi decisioni con l'aiuto dell'IA.
• Sviluppo e test
  Testa rapidamente meccaniche di gioco o configurazioni senza scrivere codice.

• ✔ Server Hytale: Un server Hytale funzionante (vedi la nostra guida di creazione)
• ✔ Plugin WebServer: Il plugin Nitrado WebServer deve essere installato (dipendenza obbligatoria)
• ✔ Assistente IA: Un account su Claude, ChatGPT, Codex o Gemini
• ✔ Rete: Accesso HTTP/HTTPS al tuo server da Internet

Dopo il primo avvio, modifica il file mods/MCP/config.json per configurare i token di autenticazione e i permessi.

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

Sicurezza importante

Configurazione per Codex (OpenAI)

Nell'applicazione Codex, aggiungi un server MCP con i seguenti parametri:

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

Configurazione per Claude Desktop

Aggiungi la seguente configurazione nel file di configurazione di Claude Desktop:

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

Configurazione per ChatGPT

Per ChatGPT, utilizza l'API OpenAI con un client MCP compatibile o configura tramite l'interfaccia Custom Actions.

Costruzione e terreno

• Posizionare un blocco a coordinate precise
• Posizionare più blocchi in una singola operazione (fino a 1000)
• Appiattire un'area rettangolare a un'altezza data
• Cercare ed elencare i tipi di blocchi disponibili

Gestione giocatori

• Vedere la lista dei giocatori connessi
• Ottenere la posizione e rotazione di un giocatore
• Inviare un messaggio privato a un giocatore
• Dare oggetti a un giocatore

Amministrazione server

• Eseguire qualsiasi comando server
• Diffondere un messaggio a tutti i giocatori
• Consultare i log del server con filtri
• Ottenere informazioni sul mondo attuale

Ecco i principali strumenti che l'IA può utilizzare tramite MCP:

Esempio 1: Costruire una casa

Prompt: "Costruiscimi una piccola casa in legno con finestre e una porta alle coordinate X:100, Y:64, Z:200"

Esempio 2: Preparare un terreno piatto

Prompt: "Appiattisci il terreno da X:0 a X:50 e Z:0 a Z:50 all'altezza Y:70"

Esempio 3: Inviare messaggio di benvenuto

Prompt: "Invia un messaggio di benvenuto a tutti i nuovi giocatori"