SyAI

插件

· 作者 Shiyuan

让 AI 集成到你的服务器中,进行 AI 聊天并接管游戏。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

SyAI - Minecraft AI 集成插件

SyAI 将 Minecraft 玩家与 AI 模型连接,支持在游戏内直接进行 AI 驱动的聊天对话和自主任务执行。


支持的 AI 模型

模型 提供商 API 格式
deepseek-v4-pro DeepSeek OpenAI
deepseek-v4-flash DeepSeek OpenAI
kimi-k2-6 Kimi (Moonshot) OpenAI
qwen3.7-plus Qwen (Alibaba) OpenAI
qwen3.7-max Qwen (Alibaba) OpenAI
glm-5.1 GLM (ZhipuAI) OpenAI
minimax-m3 MiniMax Anthropic

安装

  1. 下载 SyAI.jar 并将其放入服务器的 plugins/ 文件夹中。
  2. 启动或重启服务器。
  3. 编辑 plugins/SyAI/config.yml 以配置 API 密钥(详见下文)。
  4. 使用 /syai reload 重新加载配置,无需重启服务器。

配置 (config.yml)

# 是否使用管理员提供的 API 密钥
# 如果为 true,玩家将使用下面配置的密钥
# 如果为 false,玩家必须通过 /syai api 提供自己的 API 密钥
use-admin-api: true

# 管理员 API 密钥(仅在 use-admin-api 为 true 时使用)
admin-api-keys:
  deepseek-v4-pro: "sk-your-key-here"
  deepseek-v4-flash: "sk-your-key-here"
  kimi-k2-6: "sk-your-key-here"
  qwen3.7-plus: "sk-your-key-here"
  qwen3.7-max: "sk-your-key-here"
  glm-5.1: "your-key-here"
  minimax-m3: "your-key-here"

# 聊天和任务的默认模型
default-model: "deepseek-v4-flash"

# 聊天最大上下文消息数量
max-context: 100

# AI 任务设置
task:
  max-rounds: 50
  action-delay: 10

两种 API 密钥模式

管理员模式 (use-admin-api: true):
所有玩家共享由管理员配置的 API 密钥。玩家无需进行任何配置。

玩家模式 (use-admin-api: false):
每位玩家必须使用 /syai api <model> <key> 提供自己的 API 密钥。密钥存储在本地 JSON 文件 (api_keys.json) 中。


命令

命令 描述
/syai chat true 启用 AI 聊天模式 — 所有消息都将发送给 AI
/syai chat false 禁用 AI 聊天模式
/syai task <requirement> 让 AI 接管你的客户端以完成任务
/syai task cancel 取消当前的 AI 任务
/syai api <model> <key> 为某个模型设置你的个人 API 密钥
/syai model [name] 查看或更改你当前激活的模型
/syai status 查看你当前的状态
/syai reload 重新加载配置(仅限管理员)

AI 聊天模式

当聊天模式启用时,玩家在聊天中发送的每一条消息都会转发给 AI。AI 会结合对话上下文进行回复。

  • 每位玩家保留 100 条消息 的上下文。
  • AI 知晓玩家的 Minecraft 用户名。
  • AI 会使用玩家所使用的相同语言进行回复。
  • 当禁用聊天模式或玩家登出时,上下文会被清除。

AI 任务模式

AI 任务允许 AI 接管玩家的客户端并在世界中执行操作。AI 使用 函数调用(工具使用) 与游戏进行交互。

可用工具(共 18 个)

工具 描述
execute_command 执行玩家命令(管理命令被禁止)
send_message 发送聊天消息
move_to 传送至指定坐标
move_forward 沿面向方向前进
look_at 改变视角方向(偏航角/俯仰角)
get_position 获取当前位置和方向
get_inventory 查看物品栏内容
place_block 从物品栏放置方块
break_block 破坏方块
attack_entity 攻击最近的实体
interact_chest 查看/存入/取出箱子物品
drop_item 丢弃物品栏中的物品
switch_hotbar 切换手持快捷栏槽位(0-8)
switch_hand_item 交换两个物品栏槽位之间的物品
use_item 消耗/使用手持物品
get_nearby_blocks 扫描附近的方块
get_nearby_entities 列出附近的实体
finish_task 标记任务完成

命令安全性

出于安全考虑,AI 无法执行管理命令。以下类型的命令将被阻止:

  • 封禁/惩罚: /ban, /ban-ip, /kick, /mute, /warn, /jail, /tempban, /ipban, /pardon, /unban, /unmute
  • 操作员权限: /op, /deop, /stop, /restart, /reload, /plugins, /pl, /whitelist
  • 游戏操控: /kill, /gamemode, /give, /xp, /enchant, /effect, /summon, /clear, /difficulty, /gamerule, /time, /weather
  • 世界编辑: /setblock, /fill, /clone, /setworldspawn, /worldborder, // (WorldEdit)
  • 经济操控: /eco, /economy, /money give, /money take, /money set
  • 权限管理: /lp, /luckperms, /perm, /pex, /groupmanager
  • 服务器控制: /save-all, /save-off, /save-on, /timings, /spark, /paper, /purpur
  • 入侵行为: /invsee, /openinv, /vanish, /sudo, /force, /socialspy, /spectate

允许的命令 包括:/tpa, /tpahere, /tpaccept, /res tp, /money, /pay, /home, /spawn, /warp, /msg, /kit, /trade, /shop, /ah, /fly, /nick 以及其他常见的玩家命令。


权限

权限 默认值 描述
syai.use true (所有人) 访问所有 SyAI 命令
syai.admin op 访问 /syai reload

API 密钥隐私

  • 玩家 API 密钥本地存储在 plugins/SyAI/api_keys.json(JSON 文件)中。
  • 密钥绝不会传输给第三方——它们仅用于调用相应 AI 提供商的 API。
  • 当启用 use-admin-api 时,不需要单独的 Player 密钥。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源