原创 工具 世界管理 ArkOpsAi-智能服务器管理助手 2.3.2

ArkOps-Ai​

筑梦方舟网络科技工作室 (DreamArk Studio) 版权所有

点击展开...

ArkOps-Ai 是一个基于 AI 的 Minecraft 服务器智能运维管理插件，适用于 PurpurMC/PaperMC 服务端。通过自然语言交互，让服务器管理变得更加智能和高效。

---

核心特性​

• AI 驱动运维：通过 /ops 命令使用自然语言管理服务器，支持复杂多步骤任务
• @ops 聊天功能：在游戏聊天栏直接 @ops 与 AI 对话，全体玩家可见
• Skill 扩展系统：模块化插件架构，支持开发者开发外部 Skill 扩展 AI 能力
• 玩家信息获取：查看玩家手持物品、所在群系、面前方块等详细信息
• 上下文记忆：智能维护与每位玩家的对话历史，支持配置化调整
• 四级权限系统：从玩家到超级管理员的细粒度权限控制
• 国际化支持：内置英文和中文语言包
• 全面服务器管理：重启、停止、重载、插件管理、玩家管理、世界管理等

---

权限等级​

---

快速开始​

安装步骤​

1. 下载插件：从 Releases 页面下载最新的 ArkOps-Ai-2.0.0.jar
2. 部署插件：将 jar 文件放入服务器的 plugins 文件夹
3. 启动服务器：启动或重启 Minecraft 服务器
4. 配置插件：编辑 plugins/ArkOps-Ai/config.yml 配置文件
5. 添加 API Key：在配置文件中填入你的 AI API Key

环境要求​

• Minecraft 服务端：PurpurMC / PaperMC 1.20+
• Java 版本：Java 21 或更高版本
• AI API：兼容 OpenAI 接口的服务（如 DeepSeek、阿里云百炼等）

---

配置说明​

config.yml​

# 语言设置 (en, zh)
language: "zh"

# OpenAI 兼容 API 配置
# 支持所有兼容 OpenAI 接口的服务:
# - OpenAI: api-url: "https://api.openai.com/v1/chat/completions"
# - DeepSeek: api-url: "https://api.deepseek.com/chat/completions"
# - 阿里云百炼: api-url: "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
openai:
api-key: "YOUR_API_KEY_HERE" # API Key
model: "qwen3.5-plus" # 模型名称
api-url: "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
timeout: 60 # 超时时间 (秒)
max-tokens: 2000 # 最大响应 token 数
temperature: 1.0 # 温度参数 (0-2)

# 频率限制配置
rate-limit:
enabled: true # 是否启用频率限制
window-seconds: 60 # 时间窗口 (秒)
max-requests-player: 5 # 玩家最大请求次数
max-requests-admin: 0 # 管理员最大请求次数 (0=不限制)
max-requests-super-admin: 0 # 超级管理员最大请求次数
max-requests-console: 0 # 控制台最大请求次数

# 上下文配置
context:
enabled: true # 是否启用上下文
max-messages-per-player: 5 # 每个玩家的消息数量

# 聊天触发器配置
chat-trigger:
enabled: true # 是否启用聊天触发器
trigger: "@ops" # 触发词

permissions.yml​

在 plugins/ArkOps-Ai/permissions.yml 中配置玩家权限：

players:
# 按 UUID 配置权限
6f12f43f-150b-3437-9836-651e535176ec:
name: "PlayerName"
level: "SUPER_ADMIN"

# 按名称索引 (用于快速查找)
players_by_name:
PlayerName: "6f12f43f-150b-3437-9836-651e535176ec"

使用指南​

聊天功能​

在游戏聊天栏输入 @ops 你的问题 即可与 AI 对话，所有玩家都能看到对话内容和 AI 回复。

示例：

@ops 现在服务器上有几个玩家？<br>@ops 帮我查看一下 Steve 的详细信息<br>@ops 今天的天气怎么样？<br>

自然语言示例​

ArkOps-Ai 能够理解自然语言，因此你可以使用灵活的命令：

/ops restart the server please
/ops what plugins are installed?
/ops set the time to sunset
/ops give me 64 diamonds
/ops teleport me to the spawn
/ops who is online right now?

Skill 扩展系统​

ArkOps-Ai 支持开发者通过 Skill 系统扩展 AI 能力。

快速开始​

1. 复制模板：复制 skill-template 目录作为你的 Skill 项目
2. 实现接口：实现 Skill 接口
3. 编译部署：编译并将 jar 放置到 plugins/ArkOps-Ai/skills/ 目录
4. 重启生效：重启服务器加载 Skill

开发文档​

详细开发文档请查看 docs/SKILL_DEVELOPMENT.md

注意事项​

• Skill ≠ Bukkit Plugin：注册事件必须使用主插件实例
• onEnable(JavaPlugin mainPlugin) 接收主插件实例
• 依赖作用域设为 provided

示例 Skill​

项目包含两个示例 Skill：

• 经济管理系统：展示如何集成经济插件
• 世界编辑工具：展示如何操作世界和方块

许可证​

本项目采用 MIT 许可证 - 你可以自由使用、修改和分发本项目。

---

支持与反馈​

• 问题反馈：在 GitHub Issues 提交 Issue
• 功能请求：欢迎提交 Feature Request
• 贡献代码：欢迎提交 Pull Request

---

贡献指南​

我们欢迎社区贡献！如果你想参与开发：

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

---

筑梦方舟网络科技工作室 - 让 Minecraft 服务器管理更智能