Configuration

Configuration

Aicraft uses two config files in plugins/Aicraft/:

File	What it controls
config.yml	AI provider, model, system prompt, timeouts
web.yml	Web UI, database, rate limits, account linking

Restart the server after editing either file.

config.yml

endpoint: "http://localhost:11434/v1/chat/completions"
api-key: "ollama"
model: "llama3.2"
system-prompt: "You are a helpful assistant inside a Minecraft server. Keep replies concise and game-friendly."
timeout-seconds: 120
max-history-messages: 20

Option	Description
endpoint	Full URL to /v1/chat/completions
api-key	Sent as Authorization: Bearer …. Use any placeholder (e.g. ollama) if auth is not required
model	Model name your provider expects
system-prompt	Prepended to every new chat
timeout-seconds	HTTP timeout for AI requests
max-history-messages	Max user + assistant messages kept in the AI context window

web.yml

enabled: true
port: 8765
bind-address: "0.0.0.0"

database:
  type: sqlite
  sqlite-file: "aicraft.db"
  postgres:
    host: "localhost"
    port: 5432
    database: "aicraft"
    username: "aicraft"
    password: ""

rate-limits:
  default-chats-per-day: 50

linking:
  link-code-expiry-minutes: 2
  web-session-days: 30

Option	Description
enabled	Enable or disable the web UI
port	Web server port (default 8765)
bind-address	0.0.0.0 = all interfaces; 127.0.0.1 = localhost only
database.type	sqlite or postgres
database.sqlite-file	SQLite filename inside plugins/Aicraft/
database.postgres.*	Postgres connection settings
rate-limits.default-chats-per-day	Default max new chats per player per 24h
linking.link-code-expiry-minutes	How long /ailink codes stay valid
linking.web-session-days	How long a linked web session lasts

See Database and AI Providers for setup details.