Подключить ИИ к вашему серверу Hytale

Плагин MCP (Model Context Protocol) революционизирует способ управления вашим сервером Hytale. Он позволяет подключать ИИ-ассистентов, таких как ChatGPT, Claude, Codex или Gemini, непосредственно к вашему серверу для автоматизации сложных задач, автоматического строительства структур или администрирования вашего сервера на естественном языке.

MCP - это стандартизированный протокол, который позволяет ИИ-ассистентам безопасно взаимодействовать с внешними приложениями. Для Hytale это означает, что ваш ИИ может видеть состояние сервера, размещать блоки, управлять игроками и выполнять команды.

Совместимые ИИ-ассистенты

• Claude (Anthropic) - Ассистент от Anthropic, отличный для сложных задач
• ChatGPT (OpenAI) - ИИ от OpenAI, идеален для естественных разговоров
• Codex - Приложение OpenAI, оптимизированное для программирования
• Gemini (Google) - ИИ от Google, производительный и универсальный

• Автоматизированное строительство
  Попросите ИИ построить замок, дом или любую структуру. ИИ рассчитает необходимые блоки и разместит их автоматически.
• Упрощённое администрирование
  Управляйте игроками, просматривайте логи, рассылайте сообщения... всё на естественном языке.
• Помощь в модерации
  Отслеживайте активность сервера и принимайте решения с помощью ИИ.
• Разработка и тестирование
  Быстро тестируйте игровые механики или конфигурации без написания кода.

• ✔ Сервер Hytale: Работающий сервер Hytale (см. наше руководство по созданию)
• ✔ Плагин WebServer: Плагин Nitrado WebServer должен быть установлен (обязательная зависимость)
• ✔ ИИ-ассистент: Учётная запись в Claude, ChatGPT, Codex или Gemini
• ✔ Сеть: HTTP/HTTPS доступ к вашему серверу из интернета

После первого запуска отредактируйте файл mods/MCP/config.json для настройки токенов аутентификации и прав доступа.

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

Важная безопасность

Настройка для Codex (OpenAI)

В приложении Codex добавьте сервер MCP со следующими параметрами:

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

Настройка для Claude Desktop

Добавьте следующую конфигурацию в файл конфигурации Claude Desktop:

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

Настройка для ChatGPT

Для ChatGPT используйте API OpenAI с совместимым клиентом MCP или настройте через интерфейс Custom Actions.

Строительство и местность

• Разместить блок в точных координатах
• Разместить несколько блоков одной операцией (до 1000)
• Выровнять прямоугольную зону на заданной высоте
• Искать и перечислить доступные типы блоков

Управление игроками

• Просмотреть список подключённых игроков
• Получить позицию и поворот игрока
• Отправить личное сообщение игроку
• Дать предметы игроку

Администрирование сервера

• Выполнить любую команду сервера
• Рассылка сообщения всем игрокам
• Просмотреть логи сервера с фильтрацией
• Получить информацию о текущем мире

Вот основные инструменты, которые ИИ может использовать через MCP:

Пример 1: Построить дом

Запрос: "Построй мне небольшой деревянный дом с окнами и дверью в координатах X:100, Y:64, Z:200"

Пример 2: Подготовить плоскую местность

Запрос: "Выровняй местность от X:0 до X:50 и от Z:0 до Z:50 на высоте Y:70"

Пример 3: Отправить приветственное сообщение

Запрос: "Отправь приветственное сообщение всем новым игрокам"