FAQ & Troubleshooting

❓ FAQ & Troubleshooting

Find answers to common questions and solutions for technical issues here.

Since this mod relies on external AI services, errors can sometimes occur.

Common Error Codes:

Error 401 (Unauthorized): Your API key is invalid. Double-check that you copied it correctly without any extra spaces.
Error 429 (Too Many Requests): You have hit the "Rate Limit". Free tiers have limits on how many questions you can ask per minute. Wait 60 seconds and try again.
Error 404 (Not Found): The specific model you selected is currently unavailable or the API URL is incorrect.
Error 500 / 503 (Server Error): The AI provider (Google, Groq, or OpenAI) is currently having server issues. This is not a bug in the mod.

We have built-in protections to keep your assistant running:

Gemini Internal Fallback: If the high-speed Gemini 3.1 Flash Lite Preview is unavailable or fails, the mod automatically falls back to Gemini 2.5 Flash to ensure you still get an answer.
Provider Fallback: If one provider (e.g., Groq) is down completely, you can manually switch to your other configured keys (Gemini or OpenAI) in the settings menu.

How do I open the menu? The default key is K.
Customization: You can change this key at any time in the standard Minecraft Controls menu under the "AI Assistant" category.

No. The mod requires an active internet connection to communicate with the AI servers.

The AI can communicate in almost any language, but it is specially optimized for English and German.

Still having trouble? Please open an Issue on this GitHub repository or leave a comment on CurseForge!

Back to Home