AskAI
此插件允许你在游戏中与你喜欢的 AI 模型进行聊天。支持 OpenAI、Anthropic 和 Google Gemini。
在「玩家」模式下,每位玩家选择提供商和模型,通过 /chat 发送消息,并获得私密的 AI 回复。在「服务器」模式下,服务器设置统一的 API 密钥和模型,供所有玩家自由使用。
注意
此插件不适用于长篇对话。它采用单次问答(Q&A)格式运行。每条消息都会携带全新的上下文发送。
要求
命令
| 命令 |
描述 |
/chat <message> |
向当前激活的 AI 提供商发送消息 |
/chat setkey <provider> <key> |
为某提供商设置你的 API 密钥 |
/chat setmodel <provider> <model> |
设置某提供商使用的模型 |
/chat provider <provider> |
切换当前激活的提供商 |
/chat status |
显示你当前的配置和密钥状态 |
/chat reload |
无需重启即可重载 config.yml |
可用提供商:openai、anthropic、gemini
权限
| 权限 |
默认值 |
描述 |
askai.use |
所有玩家 |
使用 /chat 和 /chat status |
askai.setkey |
所有玩家 |
管理密钥、模型和提供商选择 |
askai.admin |
仅限 OP |
在服务器密钥模式下设置全服 API 密钥,重载配置 |
密钥模式
玩家模式(默认)
每位玩家自行设置和管理自己的 API 密钥。这是默认行为。
服务器模式
一组 API 密钥由管理员统一管理并共享给所有玩家。玩家仍可选择自己的提供商和模型,但 API 密钥来自服务器。
要启用此模式,请在 config.yml 中设置 key-mode: "server" 并运行 /chat reload。只有拥有 askai.admin 权限的玩家才能在此模式下设置密钥。
配置
# API 密钥存储的加密种子。首次使用前请设置一次。
# 在玩家已设置密钥后更改此值会导致其密钥无法恢复。
encryption:
seed: "CHANGE-ME-use-a-long-random-string-here"
# "player"(每位玩家设置自己的密钥)或 "server"(管理员设置共享密钥)
key-mode: "player"
# 每位玩家的速率限制
rate-limit:
requests: 10
window-seconds: 60
# 消息限制
max-message-length: 2000
max-response-tokens: 1024
# 附加到所有对话的系统提示词
system-prompt: "You are a helpful assistant in a Minecraft server."
# 启用的提供商列表
allowed-providers:
- openai
- anthropic
- gemini
AskAI
This plugin lets you chat with your favourite AI models in-game. Supports OpenAI, Anthropic, and Google Gemini.
On 'player' mode, each player picks a provider and model, sends messages with /chat, and gets private AI responses. On 'server' mode, the server sets a single API key and model for all players to use freely.
Note
This plugin is not meant for long conversations. It operates as a single shot Q&A format. Each message is sent with fresh context.
Requirements
Commands
| Command |
Description |
/chat <message> |
Send a message to your active AI provider |
/chat setkey <provider> <key> |
Set your API key for a provider |
/chat setmodel <provider> <model> |
Set which model to use for a provider |
/chat provider <provider> |
Switch your active provider |
/chat status |
Show your current config and key status |
/chat reload |
Reload config.yml without restarting |
Providers: openai, anthropic, gemini
Permissions
| Permission |
Default |
Description |
askai.use |
All players |
Use /chat and /chat status |
askai.setkey |
All players |
Manage keys, models, and provider selection |
askai.admin |
OP only |
Set server-wide API keys in server-key mode, reload config |
Key Modes
Player mode (default)
Each player sets and manages their own API keys. This is the default behavior.
Server mode
One set of API keys is shared by all players, managed by admins. Players can still choose their own provider and model, but the API key comes from the server.
To enable, set key-mode: "server" in config.yml and run '/chat reload'. Only players with askai.admin permission can set keys in this mode.
Configuration
# Encryption seed for API key storage. Set this once before first use.
# Changing it after players have set keys makes their keys unrecoverable.
encryption:
seed: "CHANGE-ME-use-a-long-random-string-here"
# "player" (each player sets own keys) or "server" (admin sets shared keys)
key-mode: "player"
# Rate limiting per player
rate-limit:
requests: 10
window-seconds: 60
# Message limits
max-message-length: 2000
max-response-tokens: 1024
# System prompt prepended to all conversations
system-prompt: "You are a helpful assistant in a Minecraft server."
# Which providers are enabled
allowed-providers:
- openai
- anthropic
- gemini
评论 0
登录后参与评分
还没有评论,来抢沙发吧