MinecraftGPT - GPT-3.5/4 (OpenAI) - MinecraftGPT - 在游戏中对话 ChatGPT

💡简介

此插件允许你在 Minecraft 中直接与 OpenAI 的 ChatGPT 进行异步对话。只需在游戏内聊天框中输入，即可获得 AI 的智能回复，为服务器增添独特的互动体验。

🎮安装与配置

环境要求

• 服务器需运行 Java 17 或更高版本。
• 支持 Java 17 的 Minecraft 版本均可使用（例如某些支持 Java 17 的 1.8 分支服务器）。

配置步骤

• 获取 API 密钥：前往 OpenAI 官网创建账户并生成 API 密钥。
• 设置密钥：将生成的 API 密钥填入插件配置文件 config.yml 中的 API_KEY 字段。
• 重启服务器：保存配置后，重启服务器以使更改生效。

🔧使用方法

开始与结束对话

• 使用 /chatgpt 命令即可开始与 ChatGPT 对话。之后，直接在聊天框中输入内容，AI 便会回复。
• 再次输入 /chatgpt 命令即可结束当前对话。

对话模式

插件提供三种不同的对话模式

• 单人模式 (Single)

- 执行 `/chatgpt` 或 `/chatgpt single` 开启。

- 只有发起命令的玩家可以与 AI 对话并看到对话内容。

• 广播模式 (Broadcast)

- 执行 `/chatgpt broadcast` 开启。

- 只有发起命令的玩家可以与 AI 对话，但服务器上的所有玩家都能看到对话内容。

• 全员模式 (Full)

- 执行 `/chatgpt full` 开启。

- 服务器上的所有玩家都可以与 AI 对话，并且所有人都能看到所有回复。

⭐命令与权限

命令列表

• /chatgpt 或 /chatgpt single - 开启单人对话模式。
• /chatgpt broadcast - 开启广播对话模式。
• /chatgpt full - 开启全员对话模式。
• /chatgpt reload - 重载插件配置。

权限节点

• minecraftgpt.command.single - 使用 /chatgpt (single) 的权限。
• minecraftgpt.command.broadcast - 使用 /chatgpt broadcast 的权限。
• minecraftgpt.command.full - 使用 /chatgpt full 的权限。
• minecraftgpt.command.reload - 使用 /chatgpt reload 的权限。
• minecraftgpt.receive - 拥有此权限的玩家可以“监听”到所有模式的 AI 对话（类似于监视权限）。

✨配置文件预览

以下是 config.yml 的核心部分预览：

command:
  no-permission: "&cYou do not have permission to use this command."
  invalid-type: "&cInvalid type. Valid types: &6{types}"
toggle:
  enabled: "&aChatGPT has connected. Say Hi!"
  disabled: "&cChatGPT has disconnected."
  error: "&cAn error occurred while processing your message."
send-messages-to-console: true
use-default-chat: false
format:
  - "&b%player%: &7%message%"
  - "&bAI -> %player%: &a%message%"
chatgpt:
  model: "gpt-3.5-turbo"
  temperature: 0.9
  max-tokens: 150
  top-p: 1.0
  frequency-penalty: 0.0
  presence-penalty: 0.6
  chat-priority: HIGH
  API_KEY: ""

关键配置说明

• API_KEY：必须填入你从 OpenAI 获取的有效密钥。
• model：可切换使用的 AI 模型，例如 gpt-3.5-turbo 或 gpt-4。
• format：自定义玩家消息和 AI 回复在游戏内的显示格式。
• chat-priority：插件处理聊天事件的优先级，除非必要，不建议修改。

❓常见问题与故障排除

错误提示

如果在对话时收到以下错误信息

An error occurred while processing your message.

这通常意味着向 OpenAI 发送的请求失败了。主要原因包括：

• API 密钥未配置或未重启：请检查 config.yml 中的 API_KEY 是否已正确填写，并确保已重启服务器。
• 网络问题：你的服务器可能无法访问 OpenAI 的 API 服务。
• API 密钥失效：你的 OpenAI API 密钥可能已被停用，需要前往 OpenAI 账户检查并生成新的密钥。

💡安装与使用

本插件需要 Java 17 运行环境。只要您的 Minecraft 服务端版本支持 Java 17（例如，某些支持 Java 17 的 1.8 分支服务器），即可使用。

配置步骤

• 首先，您需要拥有一个 OpenAI API 密钥。
• 前往 OpenAI 官网创建账户并生成 API 密钥。
• 将获取到的 API 密钥填入本插件的配置文件中。
• 保存配置文件并重启服务器，配置即可生效。

开始对话

• 在游戏中输入 /chatgpt 命令即可开始与 ChatGPT 对话。
• 之后，您直接在聊天栏中输入内容，机器人便会回复您。
• 再次输入 /chatgpt 命令即可结束当前对话。

🎮命令与权限

以下是所有可用命令及其对应的使用权限。

基础与单次对话

• 命令：/chatgpt 或 /chatgpt single
• 权限：minecraftgpt.command.single
• 说明：开启或结束与 ChatGPT 的私人对话。

广播回复

• 命令：/chatgpt broadcast
• 权限：minecraftgpt.command.broadcast
• 说明：开启对话模式，但 ChatGPT 的回复将对全服玩家可见。

完整上下文

• 命令：/chatgpt full
• 权限：minecraftgpt.command.full
• 说明：开启使用完整上下文模型的对话模式（通常指 GPT-4 等模型）。

重载插件

• 命令：/chatgpt reload
• 权限：minecraftgpt.command.reload
• 说明：在服务器运行时重新加载插件的配置文件。