Skip to main content

Frequently Asked Questions

Is CraftyAI free?​

Yes, the Free tier is free forever. Pro and Enterprise tiers add higher rate limits and custom prompts for servers that need more capacity.

Which Minecraft versions are supported?​

  • Plugin (Spigot, Paper, Folia, Purpur): 1.8 through 1.21.x
  • Mod (Fabric): 1.20.4 through 1.21.1, plus 26.x
  • Mod (Forge): 1.20.4 through 1.20.6

Which server software works with the plugin?​

Spigot, Paper, Folia, and Purpur all work. The same JAR runs on all of them.

Can I use my own AI provider?​

Yes. With BYOK, you can plug in your own Google Gemini API key. Your prompts go directly to Google instead of through our backend, and your rate limits are Google's instead of ours.

See the BYOK guide for setup instructions.

Does CraftyAI sell my data?​

No. We don't sell player data, chat content, or learned knowledge. The data we collect (described in our Privacy Policy) is used to run the service and improve abuse detection.

How do I disable telemetry?​

  • Plugin: Set enable_metrics: false in config.yml
  • Mod: Set telemetry_enabled: false in craftyai.json

Telemetry is just a heartbeat ping every 3 minutes. Disabling it doesn't affect AI features.

Can players abuse the AI to grief the server?​

CraftyAI has several protections:

  1. Player cooldowns prevent chat spam
  2. A blacklist blocks dangerous items (bedrock, command blocks, spawners)
  3. Destructive actions (gamemode changes, mob kills, command execution) require operator permissions
  4. Destructive actions also require an in-game confirmation before running

If a player does get a destructive action approved, they can only affect their own player state by default. Server-wide effects require crafty.admin permission.

How do I upgrade my tier?​

Run /crafty pro help in-game for instructions on getting a Pro key. Pro keys are issued through our Discord bot by server admins.

Can I change the AI's name?​

Yes. In your config:

  • Plugin: ai.name in config.yml
  • Mod: ai_name in the settings screen or craftyai.json

The AI will respond to whatever name you set, plus all the aliases you've configured.

What AI model does CraftyAI use?​

CraftyAI runs on an AI engine built and maintained by DemonZ Development. The model and infrastructure are closed source. We tune the system for gameplay, action execution, and game state reasoning.

Can I see my server's usage?​

In-game: /crafty status shows connection state and recent request count.

In Discord: /my-sessions shows every server linked to your account with daily token usage and request count.

How do I get support?​

Join our Discord and open a ticket. We respond within a day, usually faster.

Is the source code available?​

The client plugins and mods are closed source. The backend is also closed source. We may open-source specific components in the future, but there's no public repo right now.

Can I run CraftyAI offline?​

No. The AI backend runs on our servers. The plugin and mod can be installed without an internet connection, but the AI features won't work.

The plugin includes a "Local Mode" toggle in some builds, which falls back to canned responses when offline. It's a placeholder, not a full AI, intended for testing.

How do I report a bug?​

Open a ticket in Discord with:

  1. What you did
  2. What happened
  3. What you expected to happen
  4. Server version, plugin/mod version, and Minecraft version
  5. Relevant log output (redact any API keys before posting)