Server Admin Guide

As a server owner or administrator, you have full control over how CraftyAI operates on your server and what features are available to players.

Discord Bot Registration

To manage your server's AI features, you must register it via the CraftyAI Discord bot.

1. Join Discord: Join the CraftyAI Discord community.
2. Access Control Panel: Navigate to the #crafty channel and use the Control Panel.
3. Get API Key: Click "Get API Key" and enter your server's Session ID.

Bot Commands

You can interact with the Crafty bot using these commands:

• /panel - Opens the interactive Control Panel to obtain API Keys, view plans, and access links.
• /my-sessions - View your linked sessions, connection status, usage stats, memory usage, and tier information.
• /ask <question> - Ask CraftyAI a Minecraft question directly inside Discord.

Web Admin Panel

Once you have your API key, you can access the powerful Web Admin Panel at https://craftyai-admin.pages.dev (or the URL provided by the bot).

Login: Use your server's API key to authenticate.

Features:

• Dashboard: View server status, tier, monthly usage, and rate limit.
• Analytics: View detailed usage statistics and request history.
• Settings: Update server name, AI name, and view your API key.

Subscription Tiers

CraftyAI offers several subscription tiers to fit your server's needs. Your current tier is visible in the Admin Panel and via /my-sessions.

Tier	Rate Limit	Daily Requests	Daily Tokens	Max Compacted Memories
Free	30 RPM	100	10k	5
Starter	100 RPM	1,000	100k	50
Pro	500 RPM	10,000	1M	250
Enterprise	Custom	Custom	Custom	1,000

Note: The Vision Scanner feature requires the Pro tier or higher.

Security Strikes & In-Game Alerts

CraftyAI includes a built-in security gateway that monitors for suspicious activity, such as unauthorized access attempts or spoofed client versions.

• In-Game Alerts: All online Administrators (OPs) will receive real-time alerts in chat if a "Security Strike" is triggered for your session.
• Alert Format: §c§l[CraftyAI Warning] §7<message>
• Common Warnings:
  • Non-Minecraft client detected: Triggered if your mod/plugin version is outdated or mismatched.
  • Suspicious session traffic: Triggered if unauthorized tools try to use your Server ID.

AI Action Permissions

By default, the AI can suggest and execute actions like changing time, weather, or healing players. You can control this via:

1. Global Toggle: Set enable_actions: false (plugin) or ai_enable_actions: false (mod) in your config to disable all AI world modifications globally.
2. Permissions: Only players with the crafty.actions permission can have the AI execute actions for them. (Gamemode changes require crafty.actions.gamemode).

API Key Management

Viewing Your API Key

1. Login to the admin panel.
2. Navigate to the "API Key" section.
3. Click "Show" to reveal the key.

Regenerating Your API Key

If your key is compromised:

1. Login to the admin panel.
2. Navigate to the "API Key" section and click "Regenerate".
3. Update your config.yml or craftyai.json with the new key and restart your server.