AskChat

插件

· 作者 mrgucci1

一款 Minecraft 插件,允许玩家在聊天中提问并从 AI 获取答案

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

最新 1.5 · 26.2 · Bukkit / Paper

一键开服(送7天)

AskChat

一个用于服务器的 AI 聊天助手。玩家通过在聊天中使用 !ask <问题> 提问,由可配置的 AI 人格(默认为 "Notch")回答,并可调用工具以获取实时信息。

支持三种提供商——Gemini(默认)、Ollama(本地或云端)和 NVIDIA NIM,并提供针对 Web 搜索(Brave)和 Minecraft Wiki 的智能体工具使用功能。

示例

截图 2024-08-08 014911

截图 2024-08-08 015430

功能

  • 基于聊天的界面: 无需离开你的 Minecraft 世界即可提问并获取回答。
  • 可配置:
    • 自定义 AI 的提示词以引导其回复。
    • 更改聊天中机器人的名称。
    • 可选择将问题与答案同时广播至服务器。
  • 轻量级: 旨在将对服务器性能的影响降至最低。

安装

  1. 将对应的 jar 文件放入服务器的 plugins/ 目录中。
  2. 启动服务器一次,以生成 plugins/AiChatBuddy/config.yml。
  3. 停止服务器,编辑 config.yml(见下文),然后重新启动——或者在运行时直接编辑并执行 /aichat reload。

配置

默认 config.yml:

provider: gemini          # gemini | ollama | nvidia

bot-name: "Notch" private-questions: false # true = whisper replies, false = broadcast max-history: 8 # rolling per-player message history; 0 = stateless agent-max-steps: 8 # max tool-calling iterations before forcing a best-effort answer

prompt-template: | You are Notch — the ancient architect and silent overseer ... (full Notch persona, see config.yml)

providers: gemini: api-key: "" api-url: " temperature: 0.5 top-p: 0.99 ollama: base-url: " # or for cloud api-key: "" # cloud only model: "gpt-oss:20b" temperature: 0.7 nvidia: base-url: " api-key: "" # must start with nvapi- model: "meta/llama-3.3-70b-instruct" temperature: 0.5

tools: web-search: enabled: true api-key: "" # Brave Search API key; tool is hidden from the LLM if blank max-results: 3 minecraft-wiki: enabled: true max-results: 3


你只需填写想要使用的提供商(provider)和工具(tool)的 API 密钥。未配置的提供商或工具将被自动跳过。

---

## 获取 API 密钥

### Gemini(默认,提供免费层级)

1. 前往  
2. 使用 Google 账号登录。
3. 点击 **创建 API 密钥**。
4. 将密钥(以 `AIza…` 开头)复制到 `providers.gemini.api-key` 中。

通过编辑 `providers.gemini.api-url` 来切换模型 —— URL 中包含模型名称。默认值为 `gemma-4-31b-it`(支持函数调用、速度快、免费)。其他不错的选择:

- `gemini-2.5-flash` — 速度快、成本低、工具使用能力强。
- `gemini-2.5-pro` — 质量更好,速度较慢。
- `gemma-4-26b-a4b-it` — 更大的上下文窗口,每个 token 仅激活约 4B 参数。

### Brave Search(用于 `web_search` 工具)

1. 访问 <https://brave.com/search/api/>。
2. 点击 **Get Started** 并注册账号。
3. 订阅 **Free** 计划(每秒 1 次查询,每月 2000 次查询)。
4. 在仪表板中,于 **API Keys** 下创建一个 API 密钥。
5. 将其粘贴到 `tools.web-search.api-key` 中。留空则禁用网络搜索。

### NVIDIA NIM(免费层级)

1. 访问 <https://build.nvidia.com/>。
2. 使用 NVIDIA Developer 凭据登录。
3. 打开任意模型页面(例如 <https://build.nvidia.com/meta/llama-3_3-70b-instruct>)。
4. 点击右上角的 **Get API Key**。
5. 复制该密钥(以 `nvapi-` 开头),粘贴到 `providers.nvidia.api-key` 中。

推荐用于 `providers.nvidia.model` 的模型:
- `meta/llama-3.3-70b-instruct`(默认)
- `nvidia/llama-3.1-nemotron-70b-instruct`
- `mistralai/mixtral-8x22b-instruct-v0.1`

### Ollama

你可以 **本地** 运行 Ollama(免费、私密),或使用 Ollama 云服务。

**本地:**
1. 从 <https://ollama.com/download> 安装 Ollama。
2. 拉取一个支持工具调用的模型,例如 `ollama pull llama3.1` 或 `ollama pull qwen2.5`。
3. 在 `config.yml` 中配置:
   - `providers.ollama.base-url: "http://localhost:11434"`
   - `providers.ollama.api-key: ""`(本地运行无需此密钥)
   - `providers.ollama.model: "llama3.1"`(或你拉取的任意模型名称)

**云端:**
1. 在 <https://ollama.com/> 注册账号。
2. 在账户设置中生成一个 API 密钥。
3. 在 `config.yml` 中配置:
   - `providers.ollama.base-url: "https://ollama.com"`
   - `providers.ollama.api-key: "<your-key-key>"`
   - `providers.ollama.model: "gpt-oss:20b"`(或 `gpt-oss:120b`、`qwen3-coder:480b`、`deepseek-v3.1:671b`、`glm-4.7`、`kimi-k2.6` 等)

随时可通过编辑 `provider:` 并运行 `/aichat reload` 来切换提供商。

---

## 命令

| 命令 | 权限 | 描述 |
| ------- | ---------- | ----------- |
| `!ask <question>` | `aichatbuddy.ask`(默认:所有人) | 在聊天中向 AI 提问。 |
| `/aichat reload` | `aichatbuddy.reload`(默认:OP) | 重新加载 `config.yml` 并清除内存中的历史记录。 |
| `/aichat forget` | `aichatbuddy.forget.self`(默认:所有人) | 清除你自己的对话历史。 |
| `/aichat forget <player>` | `aichatbuddy.forget.others`(默认:OP) | 清除其他玩家的历史记录。 |

---

## 使用方法

在聊天中输入 `!ask` 后接你的问题,例如:`!ask How do I make a crafting table?`。AI 将回复答案。

## 支持与反馈

如果你有任何问题、错误或功能建议,请在 [GitHub]([link-to-your-github-repo](https://github.com/mrgucci1/AiChatBuddy) 上提交 Issue。

## 贡献

欢迎贡献!请随时 fork 本仓库并提交拉取请求。

## 许可证

本项目基于 [MIT 许可证](LICENSE) 开源。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源