AI Chatbot

插件

· 作者 jejomic

AI 聊天机器人将智能 AI 对话带入你的服务器。玩家可以在游戏内直接与 AI 聊天,获取服务器信息、规则、玩法帮助或进行闲聊。默认情况下适用于整个服务器,并可通过自定义知识库进行完全配置

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

最新 1.0.0 · 26.2 · NeoForge

一键开服(送7天)

AI Chatbot 是适用于你服务器的游戏内 AI 聊天助手。玩家可以在聊天中向它打招呼或提问,它会基于你自己的服务器规则、背景设定和信息来回答——而不是提供通用的虚构答案。它还可以根据需要发放物品,且发放限制由你控制。

关于它的任何内容都不会预加载特定服务器的数据——所有默认配置都作为一个空模板分发,旨在被替换。你编写它所需的知识,它仅以你的口吻进行回答。

快速开始

  1. 安装。 将 jar 文件放入 plugins/(Paper)或 mods/(Fabric/Forge/NeoForge)目录,然后启动一次服务器。这将生成 config.yml、server-info.md 和一个 kb/ 文件夹。

  2. 获取免费的 Groq API 密钥(真正的永久免费套餐,无需信用卡):

    1. 在 console.groq.com 注册(支持 Google/GitHub/邮箱)。

    2. 前往 console.groq.com/keys,点击 Create API Key,为其命名(例如 mc-server),并复制该密钥——Groq 只会显示一次。

    3. 打开 config.yml(在步骤 1 中生成),并将密钥粘贴到 ai.apiKey 下。具体路径取决于你的平台:

      Platform config.yml path
      Paper plugins/mcAIChatbot/config.yml
      Fabric / Forge / NeoForge config/mcAIChatbot/config.yml
      ai:
        provider: "openai-compatible" # 已经是默认值 — Groq 使用此 wire format
        apiKey: "gsk_...paste your key here..."
        baseUrl: "https://api.groq.com/openai/v1"
        models:
          - "groq/compound"
          - "openai/gpt-oss-120b"
          - "openai/gpt-oss-20b"
      

      (模型阵容会随时间变化——如果这些模型不再可用,请查看 console.groq.com/docs/models 获取当前列表。跳过任何名为 prompt-guard 的模型——那是一个输入安全分类器,而非聊天模型。)

    保持此账户为无绑定支付方式的免费套餐账户——详见下方的 “Groq key” 部分,了解为何这很重要,以及如果密钥泄露该怎么办。

  3. 填写 server-info.md(简短的项目符号列表:服务器名称、规则、关键命令),并将其他玩家可能询问的内容对应的 .md 文件放入 kb/ 文件夹中。

  4. 保存,然后重载。 在游戏中运行 /mcaichatbot reload(或重启服务器)——即刻生效。

完整配置参考及每个选项的解释:见下方的“Setup guide”。

Groq key

Groq 是本项目默认指向的 AI 提供商,拥有真正的永久免费套餐——注册或生成密钥均无需信用卡。有关具体的注册和设置步骤,请参阅上方的 “Quick start” ——本节涵盖相关理由以及密钥泄露时的应对措施。

免费套餐

你的 API 密钥存在于运行 mc 服务器的机器上的明文配置文件(config.yml)中。如果托管环境遭到入侵、与其他租户共享,或被除你之外的人访问——这在廉价/共享游戏主机中很常见——该密钥可能会泄露。

  • 无绑定支付方法的免费套餐密钥如果泄露,风险较低:最坏的情况是有人耗尽你的免费速率限制,而你只需轮换密钥即可。不会产生账单。
  • 付费密钥或绑定了卡片的密钥如果泄露,则存在真实的财务风险:有人可能在被你察觉之前产生高额使用费用。

因此:创建一个免费的 Groq 账户,不要添加支付方式,并仅在此处使用该密钥。

如果泄露

立即在 console.groq.com/keys 轮换它——删除旧密钥并创建一个新密钥。不要只是从泄露的地方移除它;要假设它已经被他人看到。

绝对不要

  • 绝对不要将包含真实密钥的 config.yml 提交到公共仓库。
  • 绝对不要分发带有内置密钥的 jar 文件或配置——每次服务器安装都应生成并使用自己的密钥。
  • 绝对不要将支付方式附加到此密钥所属的账户。

Free key

此插件/模组需要来自 AI 提供商的 API 密钥才能工作(默认为 Groq——真正的永久免费套餐,无需信用卡)。永远只使用无绑定支付方法的免费套餐账户。 密钥存在于托管你服务器的机器上的明文配置文件中,而托管环境(尤其是廉价/共享托管)可能会被入侵或允许其他人访问文件系统。泄露的免费套餐密钥最多只会导致你在 $0 账户上受到速率限制;而泄露的付费密钥可能会产生真实的账单。有关 2 分钟的注册步骤,请参阅上方的 “Quick start”;有关完整理由,请参阅上方的 “Groq key”;有关数据发送去向,请参阅下方的 “Content disclosures”。

Content disclosures

本项目连接到第三方 AI API。 为了生成聊天回复,此插件/模组会将玩家问题的文本(以及你自己编写的简短服务器上下文——不包含个人玩家数据)发送到 AI 提供商的 API。默认情况下,该提供商是 Groq;配置也支持 OpenAI 兼容端点、OpenRouter 和 Anthropic,如果你选择切换的话。你必须自行提供该提供商的 API 密钥——未捆绑任何密钥,且在添加密钥之前,插件/模组不会执行任何操作。

本项目文档的所有 AI 提供商选项(Groq、OpenRouter 的 :free 模型、本地 Ollama)都有真正无需卡片的免费套餐——默认路径见上方的 “Groq key” 部分,并且不要在该账户上附加计费信息。

可选 Discord 中继。 如果你开启可选的 Discord webhook 中继功能,聊天行将通过你提供的 webhook URL 发布到 Discord 频道。此功能默认关闭,并且与 AI 密钥一样,是由你提供和控制凭据——对待 webhook URL 时要同样小心(不要分享它,如果泄露请轮换它)。

除了用于生成回复所需的聊天文本外,没有其他玩家数据离开你的服务器,这些数据直接发送到你配置的 AI 提供商。

Features

  • 在聊天中回答问题 — 输入 !ai <问题>(前缀可配置),回复将基于你的 server-info.md 和 kb/ 知识库文件生成。

  • 加入问候 — 当玩家登录时欢迎他们。

  • 人格模式 — 可选 friendly(友好)或 trashtalk(垃圾话)。

  • 可配置的聊天样式 — 机器人名称及消息的颜色/加粗效果,可通过聊天命令或 config.yml 进行设置。

  • 按玩家和服务器范围的对话记忆,使其能够在消息之间记住上下文。

  • 可选的物品发放功能 — AI 可根据请求发放物品,但受每日每玩家限制、堆叠大小限制以及独立的装备数量限制约束。默认关闭;只需一步即可启用

config 标志,如果你需要的话。

  • 批量 AI 调用 — 同一短时间窗口内来自多个玩家的问题合并为一个 AI 请求发出,而不是每个玩家单独发送,因此即使在繁忙的服务器上运行成本也很低。
  • 模型回退/轮换 — 在配置的多个模型之间进行切换,防止单个过载或触发速率限制的模型导致整个服务崩溃。
  • 可选的 Discord 中继 — 通过普通的入站 Webhook 将加入问候和 !ai 回复镜像到 Discord 频道。默认关闭;无需桥接插件。
  • 游戏内管理员命令 — 从聊天界面查看和修改大部分设置(/mcaichatbot config,

get、set、models)无需重启,或在手动编辑文件后使用 reload。

  • 崩溃安全状态持久化 — 冷却时间和对话记忆在重启后得以保留。

支持的平台

平台 Minecraft 版本
Paper 单个 jar 文件,向前兼容,从 1.21.11 到 26.x 系列
Fabric 1.21.11, 26.1, 26.2
Forge 1.21.11, 26.1, 26.2
NeoForge 1.21.11, 26.1, 26.2

所有平台均使用完全相同的 config.yml 结构和键名 —— 只需复制任意一个平台的配置文件到另一个平台即可直接使用。

安装指南

以下是在四种支持平台上的任何一款上安装、配置并运行 mc AI Chatbot 所需的全部信息。

安装

平台 jar 文件放置位置 首次启动时生成的文件
Paper plugins/ plugins/mcAIChatbot/config.yml, server-info.md, kb/
Fabric mods/ config/mcaichatbot/config.yml, server-info.md, kb/
Forge mods/ config/mcaichatbot/config.yml, server-info.md, kb/
NeoForge mods/ config/mcaichatbot/config.yml, server-info.md, kb/

选择与你的加载器和 Minecraft 版本(1.21.11、26.1 或 26.2 — Paper 提供一个涵盖所有这些版本的 jar)相匹配的 jar。启动服务器一次以生成上述文件,然后在填写以下两项内容之前,它不会提供任何有用的信息:API 密钥和你自己的服务器信息。

API 密钥

使用无绑定支付方式的基础套餐账户 —— 而非付费账户。 该项目的配置将 apiKey 以明文形式保存在服务器本地文件系统上的 config.yml 中;如果泄露,免费密钥仅面临速率限制的风险,而付费密钥则可能导致产生真实费用。下面提到的每个提供商选项都有无需信用卡的真实免费套餐。

shipped 的默认值是 Groq —— 请参阅上方的“快速开始”获取逐步注册指南,或上方的“Groq 密钥”了解对基础套餐要求的理由。

在 config.yml 的 ai: 下设置这四个字段:

ai:
  provider: "openai-compatible" # 预置默认值 —— 见下方的 Groq 密钥指南
  apiKey: "..." # 你自己的基础套餐密钥 —— 切勿在不同安装之间共享同一个密钥
  baseUrl: "https://api.groq.com/openai/v1"
  models:
    - "groq/compound"
    - "openai/gpt-oss-120b"
    - "openai/gpt-oss-20b"

(配置也支持 OpenRouter 和 Anthropic 作为替代提供商,如果你更愿意使用它们 —— 两者也有免费选项 —— 但本指南仅涵盖 Groq 路径,因为它是默认值且除了密钥本身外不需要额外设置。)

apiKey 是唯一需要直接编辑文件的字段 —— 有关其他所有设置的说明,请参见下方的“管理命令”。更改此设置后,运行 /mcaichatbot reload 或重启服务器。待处理的问题、物品发放冷却时间和对话历史在重新加载后都会保留 —— 只有 config.yml/server-info.md/kb/ 会被重新读取。需要相当于 OP 的权限(Paper: mcaichatbot.reload,默认 OP,别名 /maic;Fabric/Forge/NeoForge: 原版权限级别 4,与 /op 相同)。

服务器信息

没有任何预加载的特定服务器内容 —— 所有默认值都是旨在被替换的模板。

  • server-info.md —— 简短的事实要点:服务器名称、规则、游戏模式、关键命令/插件、链接。这会粘贴到每个提示中,因此请保持简洁。
  • kb/ —— 一个文件夹,而不是单个文件。根据需要放入任意数量的 .md 文件,用于存放 server-info.md 没有空间容纳的内容(游戏系统、背景故事、物品列表、活动规则)。预置了一个展示格式的示例文件 —— 删除示例,编写你自己的。如果顺序重要,文件按文件名顺序读取(01-..., 02-...)。给出清晰的标题/粗体文本 —— 这就是用来匹配玩家问题的内容。

这两者会在每次提问时实时重新读取 —— 无需为此进行重新加载。

物品发放

itemGiving:
  enabled: false # 总开关(默认关闭)— 设为 true 时,机器人会在被请求时发放物品
  maxPerDay: 10 # 每位玩家,滚动 24 小时窗口
  maxQuantity: 64 # 普通可堆叠物品
  maxEquipmentQuantity: 1 # 武器/护甲/工具等(原版最大堆叠数本就为 1)

将 enabled: false 不仅会阻止物品赠送的发生——AI 会被指示永远不要提供此类物品;如果 AI 无视该指令,插件会用一条简单的“此处已关闭物品赠送”消息覆盖其回复,而不是让一个承诺但未交付的物品漏过去。

其他可调参数

Key 作用
botName 在每个机器人消息前显示的聊天名称,默认为 "mcAi"
chatStyle 名称/消息的颜色和加粗样式,例如 chatStyle.nameColor: "blue"
personality "friendly" 或 "trashtalk" —— 机器人的语气
askPrefix 玩家输入的聊天前缀,默认为 "!ai"
batchWindowMs 队列中的问题作为一次 AI 调用发出的频率(默认 10 秒)
maxAsksPerWindow 每个窗口内接受的总问题数,跨所有玩家
askCooldownSeconds 每个玩家的独立节奏,与 batchWindowMs 无关
maxAskSubparts 单条消息可以同时解决多少个不同的请求
broadcastReplies true = 机器人回复发送到全服聊天;false = 仅控制台日志

此表中的所有键(以及上文物品赠送部分的键)也可以从聊天中更改——见下方的“管理员命令”。

Discord 中继

每条机器人聊天行(加入问候、!ai 回复)都可以通过传入的网络钩子(webhook)中继到 Discord 频道——无需桥接插件,默认关闭:

  1. 在 Discord 中:目标频道 → 设置 → 集成 → Webhooks → 新建 Webhook → 复制 Webhook URL。
  2. 在 config.yml 中:
    discord:
      webhookUrl: "https://discord.com/api/webhooks/..."
      username: "" # 可选 — 覆盖 Discord 显示的名称;留空则使用 webhook 自身的名称
    
  3. /mcaichatbot reload 或重启服务器。

将 webhookUrl 留空(默认值)可保持此功能关闭。中继失败(URL 错误、Discord 宕机、速率限制)将被记录并丢弃;它不会影响触发它的游戏内回复。

管理员命令

config.yml 中的大多数内容可以直接在游戏聊天中更改,而无需手动编辑文件:

  • /mcaichatbot config — 列出所有可编辑的键及其当前值。
  • /mcaichatbot get <key> / /mcaichatbot set <key> <value> — 查看或更改单个键,例如 /mcaichatbot set chatStyle.nameColor red 或 /mcaichatbot set personality trashtalk。
  • /mcaichatbot models list|add|remove <id> — 管理 ai.models 列表。
  • /mcaichatbot reload — 在手动编辑文件后重新读取 config.yml/server-info.md/kb/。

上述所有的 set/add/remove 操作都会自动重载——无需单独的 /mcaichatbot reload。ai.apiKey 是唯一例外:它不能通过命令查看或设置(密钥不应被回显到聊天或服务器日志中),因此该字段仍需直接编辑 config.yml。权限要求与 reload 相同(见上方的“API 密钥”部分)。

安全须知

  • 使用免费层级的 API 密钥和 Discord Webhook —— 原因见上方的“免费密钥”。
  • 切勿在任何地方提交包含真实密钥的 config.yml,也切勿分发内置了您密钥的 jar/config 文件——每次安装都需要独立的密钥。
  • 如果密钥意外出现在不应出现的地方(粘贴在聊天中、提交到公共仓库等),请立即在提供商的控制台中轮换密钥——不要仅仅从泄露处移除它。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源