将AI连接到您的 Hytale 服务器

MCP（Model Context Protocol）插件彻底改变了您管理 Hytale 服务器的方式。它允许您直接将 ChatGPT、Claude、Codex 或 Gemini 等 AI 助手连接到您的服务器，以自动化复杂任务、自动构建结构或使用自然语言管理您的服务器。

MCP 是一种标准化协议，允许 AI 助手以安全的方式与外部应用程序通信。对于 Hytale，这意味着您的 AI 可以查看服务器状态、放置方块、管理玩家并执行命令。

兼容的AI助手

• Claude (Anthropic) - Anthropic 的助手，擅长复杂任务
• ChatGPT (OpenAI) - OpenAI 的 AI，非常适合自然对话
• Codex - OpenAI 应用程序，针对编程进行了优化
• Gemini (Google) - Google 的 AI，性能卓越且多功能

• 自动化建造
  要求 AI 建造城堡、房屋或任何结构。AI 会计算所需的方块并自动放置它们。
• 简化管理
  管理玩家、查看日志、广播消息……全部使用自然语言。
• 辅助审核
  监控服务器活动并借助 AI 做出决策。
• 开发和测试
  无需编写代码即可快速测试游戏机制或配置。

• ✔ Hytale 服务器: 一个正常运行的 Hytale 服务器(查看我们的创建指南)
• ✔ WebServer 插件: 必须安装 Nitrado WebServer 插件（必需依赖）
• ✔ AI助手: 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，使用带有兼容 MCP 客户端的 OpenAI API，或通过 Custom Actions 界面进行配置。

建造和地形

• 在精确坐标处放置方块
• 一次性放置多个方块（最多 1000 个）
• 在给定高度平整矩形区域
• 搜索和列出可用的方块类型

玩家管理

• 查看在线玩家列表
• 获取玩家的位置和旋转
• 向玩家发送私信
• 给玩家物品

服务器管理

• 执行任何服务器命令
• 向所有玩家广播消息
• 查看带过滤的服务器日志
• 获取当前世界的信息

以下是 AI 可以通过 MCP 使用的主要工具：

示例 1：建造房屋

提示："在坐标 X:100、Y:64、Z:200 处为我建造一座带有窗户和门的小木屋"

示例 2：准备平坦地形

提示："将从 X:0 到 X:50 和从 Z:0 到 Z:50 的地形平整到高度 Y:70"

示例 3：发送欢迎消息

提示："向所有新玩家发送欢迎消息"