Skip to main content

Common Issues

If you're running into trouble with CraftyAI, check this list of common issues and their solutions.

1. "AI is not responding"​

  • Solution: First, verify you have a valid API key configured. Run /crafty status to check the connection. Check the server console for any explicit error messages. Finally, verify that your server has outbound internet connectivity to reach the CraftyAI Gateway.

2. "Invalid API key" / Unauthorized​

  • Solution: Verify you copied the key exactly as it was provided by the Discord bot, with no leading or trailing spaces. All official API keys must start with the prefix cai_. If your key seems broken, use the Discord Control Panel to regenerate it.

3. "Connection timeout"​

  • Solution: This usually indicates a firewall or proxy is blocking outbound traffic. Ensure your server can reach the internet. You can use /crafty test to force a connection test.

4. Plugin / Mod is not loading at all​

  • Solution:
    • For Spigot/Paper: Ensure you are running Java 17 or higher.
    • For Fabric/Forge: Check that you downloaded the correct version for your Minecraft release.
    • Also ensure you don't have conflicting plugins/mods.

5. Fabric mod crashes on startup​

  • Solution: CraftyAI requires the Fabric API mod to be installed alongside it. Make sure you have downloaded it from Modrinth and placed it in your mods/ folder. Also, if you are on Minecraft 1.26, ensure you are using the specific craftyai-fabric-26 jar.

6. Vision Scanner does nothing​

  • Solution: The Vision Scanner is a Pro tier feature. If you are on the Free or Starter tier, this feature is disabled. Also, ensure the player trying to use it has the appropriate permissions.

7. The AI is giving wrong answers​

  • Solution: CraftyAI doesn't know everything about every custom server. If it gets things wrong about your specific server rules or world, use the /crafty learn command to teach it the correct information!

8. "Rate limited" / Too Many Requests​

  • Solution: You have hit the limit for your subscription tier. The AI will pause responding until the rate limit window resets (usually the next minute or day). You can check your usage in the Discord bot /my-sessions.

9. Security strike warning in console​

  • Solution: The CraftyAI Gateway monitors for abuse. If you see this, it usually means your plugin version is severely outdated, or another tool is trying to spoof your Session ID. Always keep your plugin updated.

10. Config changes are not saving​

  • Solution: Make sure you use the /crafty reload command after editing the config.yml or craftyai.json files. If it still doesn't save, check your file permissions on your host.