AskAI

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

- Paper or Purpur 1.20.6+

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

```yaml

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 ```