Connecter une IA à votre serveur Hytale

Le plugin MCP (Model Context Protocol) révolutionne la façon dont vous gérez votre serveur Hytale. Il permet de connecter des assistants IA comme ChatGPT, Claude, Codex ou Gemini directement à votre serveur pour automatiser des tâches complexes, construire des structures automatiquement ou administrer votre serveur en langage naturel.

MCP est un protocole standardisé qui permet aux assistants IA de communiquer avec des applications externes de manière sécurisée. Pour Hytale, cela signifie que votre IA peut voir l'état du serveur, placer des blocs, gérer les joueurs et exécuter des commandes.

Assistants IA compatibles

• Claude (Anthropic) - Assistant d'Anthropic, excellent pour les tâches complexes
• ChatGPT (OpenAI) - L'IA d'OpenAI, idéale pour les conversations naturelles
• Codex - Application OpenAI optimisée pour la programmation
• Gemini (Google) - L'IA de Google, performante et polyvalente

• Construction automatisée
  Demandez à l'IA de construire un château, une maison ou toute structure. L'IA calcule les blocs nécessaires et les place automatiquement.
• Administration simplifiée
  Gérez les joueurs, consultez les logs, diffusez des messages... tout en langage naturel.
• Modération assistée
  Surveillez l'activité du serveur et prenez des décisions avec l'aide de l'IA.
• Développement et tests
  Testez rapidement des mécaniques de jeu ou des configurations sans écrire de code.

• ✔ Serveur Hytale: Un serveur Hytale fonctionnel (voir notre guide de création)
• ✔ Plugin WebServer: Le plugin Nitrado WebServer doit être installé (dépendance obligatoire)
• ✔ Assistant IA: Un compte sur Claude, ChatGPT, Codex ou Gemini
• ✔ Réseau: Accès HTTP/HTTPS à votre serveur depuis Internet

Après le premier démarrage, éditez le fichier mods/MCP/config.json pour configurer les tokens d'authentification et les permissions.

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

Sécurité importante

Configuration pour Codex (OpenAI)

Dans l'application Codex, ajoutez un serveur MCP avec les paramètres suivants :

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

Configuration pour Claude Desktop

Ajoutez la configuration suivante dans le fichier de configuration de Claude Desktop :

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

Configuration pour ChatGPT

Pour ChatGPT, utilisez l'API OpenAI avec un client MCP compatible ou configurez via l'interface Custom Actions.

Construction et terrain

• Placer un bloc à des coordonnées précises
• Placer plusieurs blocs en une seule opération (jusqu'à 1000)
• Aplatir une zone rectangulaire à une hauteur donnée
• Rechercher et lister les types de blocs disponibles

Gestion des joueurs

• Voir la liste des joueurs connectés
• Obtenir la position et rotation d'un joueur
• Envoyer un message privé à un joueur
• Donner des objets à un joueur

Administration serveur

• Exécuter n'importe quelle commande serveur
• Diffuser un message à tous les joueurs
• Consulter les logs du serveur avec filtrage
• Obtenir des informations sur le monde actuel

Voici les principaux outils que l'IA peut utiliser via MCP :

Exemple 1 : Construire une maison

Prompt : "Construis-moi une petite maison en bois avec des fenêtres et une porte aux coordonnées X:100, Y:64, Z:200"

Exemple 2 : Préparer un terrain plat

Prompt : "Aplatis le terrain de X:0 à X:50 et Z:0 à Z:50 à la hauteur Y:70"

Exemple 3 : Envoyer un message de bienvenue

Prompt : "Envoie un message de bienvenue à tous les nouveaux joueurs"