GeminiMC

插件

· 作者 XoperrDev

这是一个专为管理员设计的 Minecraft 插件,通过 AI(Gemini)来管理服务器,因为它提供免费 API 密钥。

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

最新 1.2.0 · 1.21.10 · Paper / Purpur

一键开服(送7天)

GeminiMC - 用于 Minecraft 服务器管理的 Gemini AI

一款强大的 Minecraft 插件,集成了 Google 的 Gemini AI,帮助服务器管理员通过自然语言命令管理他们的服务器。

功能特性

  • 自然语言界面:用普通英语向 Gemini 提问
  • 命令执行:AI 可以建议并执行服务器命令
  • 确认系统:在命令执行前进行审查(或启用自动接受)
  • 对话记忆:保持聊天历史记录以提供上下文感知的响应
  • 服务器上下文:AI 可访问服务器信息、玩家数据和最近的聊天记录
  • 仅限 OP 访问:安全——只有服务器操作员才能使用此插件
  • 双模型支持:同时使用 Gemini 2.0 Flash 进行规划和执行

要求

  • Minecraft 1.21+(Spigot/Paper 服务器)
  • Java 21 或更高版本
  • Google Gemini API 密钥

安装

  1. 下载插件 JAR 文件
  2. 将其放入服务器的 plugins 文件夹中
  3. 重启服务器
  4. 配置你的 API 密钥(参见设置部分)

设置

获取 Gemini API 密钥

  1. 前往 Google AI Studio
  2. 点击“创建 API 密钥”
  3. 复制你的 API 密钥

配置插件

  1. 在游戏中运行:/g setapikey YOUR_API_KEY_HERE
  2. 或者编辑 plugins/GeminiMC/config.yml 并在其中添加你的密钥

用法

基本命令

/g <问题>              - 向 Gemini AI 提问
/g setapikey <密钥>      - 设置你的 Gemini API 密钥
/g autoaccept <true|false> - 切换自动接受命令
/g clearhistory          - 清除对话历史
/g context view          - 查看当前服务器上下文
/g context clear         - 清除最近的聊天上下文
/g confirm               - 确认待处理的命令

/g cancel - 取消待执行的命令 /g help - 显示帮助信息

示例用法

基础问题

/g 当前在线玩家有多少?
/g 主世界现在几点?
/g 服务器使用了多少内存?

服务器管理

/g give all online players a diamond
/g teleport everyone to spawn
/g change the weather to clear
/g set the time to day in all worlds

复杂任务

/g create a new world called "mining" with seed 12345
/g ban player xyz for griefing
/g give op to player abc

命令确认

当 Gemini 建议执行命令时,你会看到:

⚠ AI 想要执行以下命令:
  • /give @a diamond 1
  • /say Diamonds for everyone!

[确认]  [取消]

点击按钮或输入 /g confirm 或 /g cancel。

自动接受模式

对于可信的操作,启用自动接受:

/g autoaccept true

命令将立即执行,无需确认。请谨慎使用此模式!

要禁用:

/g autoaccept false

工作原理

  1. 上下文收集:当你提出问题时,插件会收集当前服务器信息:

    • 在线玩家
    • 世界数据
    • 服务器性能(TPS、内存)
    • 最近的聊天消息
  2. AI 处理:你的问题和上下文将被发送至 Gemini AI

  3. 响应解析:分析 AI 的回复以提取命令建议

  4. 命令执行:如果存在命令建议:

    • 在普通模式下:你需要进行确认
    • 在自动接受模式下:命令将自动执行
  5. 历史记录追踪:对话会被保存以便后续使用

配置

编辑 plugins/GeminiMC/config.yml:

# 你的 Gemini API 密钥
api-key: ""

# 自动接受命令执行
auto-accept: false

# 保留的最大聊天记录数量
max-history: 50

# 包含在上下文中的最近聊天消息最大数量
max-chat-context: 10

# Gemini API 设置
gemini:
  planning-model: "gemini-2.0-flash-exp"
  execution-model: "gemini-2.0-flash-exp"
  api-url: "https://generativelanguage.googleapis.com/v1beta/models/"

安全

  • 仅限 OP:只有服务器操作员才能使用 /g 命令
  • 命令审查:所有命令在执行前均可审查(除非启用了自动接受)
  • 控制台执行:命令以控制台身份运行,拥有完整权限
  • 无外部访问:AI 无法访问除 Gemini API 之外的任何外部服务

从源码构建

  1. 克隆仓库
  2. 安装 Maven
  3. 运行:mvn clean package
  4. 在 target/GeminiMC-1.0.0.jar 中找到 JAR 文件

构建要求

  • Java 21 JDK
  • Maven 3.6+

构建命令

mvn clean package

故障排除

“API key not set” 错误

  • 在游戏中运行 /g setapikey YOUR_KEY
  • 或者将密钥添加到 config.yml 中

命令未执行

  • 确保你是 OP:/op yourname
  • 检查服务器日志是否有错误
  • 验证你的 API 密钥是否有效

AI 无响应

  • 检查网络连接
  • 验证是否可以访问 Gemini API
  • 检查服务器控制台的错误消息

“You must be an operator” 提示

  • 只有 OP 可以使用此插件
  • 请服务器管理员将你设为 OP:/op yourname

隐私与数据

  • 对话历史存储在本地 plugins/GeminiMC/histories/ 目录中
  • 问题和上下文会被发送至 Google 的 Gemini API
  • 不会向任何其他外部服务发送数据
  • 请查阅 Google 的 Gemini API 服务条款

支持

如有问题、疑问或建议:

  • 查看上面的故障排除部分
  • 查看服务器控制台日志
  • 确认你使用的是兼容的 Minecraft 版本(1.21+)

许可证

本插件按“原样”提供,用于服务器管理目的。

致谢

注意:此插件赋予 AI 执行服务器命令的能力。除非你完全信任 AI 的建议,否则在确认前务必仔细审查所有命令。请谨慎使用自动接受模式。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源