Troubleshooting

Troubleshooting

In-game

"No active chat. Start one with /newchat."

Run /newchat or /reopenchat <id> before /ai.

"Daily chat limit reached"

The player hit their 24h new-chat cap. Grant aicraft.chats.<n>, aicraft.chats.unlimited, or raise default-chats-per-day in web.yml.

"Failed to reach AI endpoint"

• Confirm the AI server is running (ollama serve, etc.)
• Check endpoint includes the full path: /v1/chat/completions
• If the model is on another machine, use that IP instead of localhost
• Check firewall / Docker networking between Minecraft and the AI host

HTTP 404 / model not found

• Pull the model: ollama pull <model>
• Match model in config.yml exactly to the provider's name

Slow or timed-out replies

• Increase timeout-seconds in config.yml
• Use a smaller/faster model

Web UI

Page won't load

• Confirm enabled: true in web.yml
• Check firewall / port forwarding for your configured port
• Look for Aicraft web UI running on http://... in server logs

"/ailink" — no pending web link

Enter your username on the web UI first, then run /ailink within the expiry window.

Link code expired

Start over: enter username on the web → /ailink in-game → enter code quickly.

Database

Postgres connection errors

• Verify the database exists and credentials in web.yml are correct
• Ensure the Minecraft server can reach the Postgres host and port

SQLite locked errors

Rare with normal use. Restart the server. Avoid copying the .db file while the server is running.