<?xml version="1.0" encoding="UTF-8"?>
<ai-manifest xmlns="https://craftyai.pages.dev/ai-schema/v1" version="1.3.0">
  <project>
    <name>CraftyAI</name>
    <tagline>An AI companion for Minecraft servers</tagline>
    <developer>DemonZ Development</developer>
    <website>https://craftyai.pages.dev</website>
    <repository>https://github.com/sdemonzdevelopment-spec/CraftyAI</repository>
    <modrinth>https://modrinth.com/plugin/craftyai</modrinth>
    <discord>https://discord.gg/zCkE44hsBR</discord>
    <license>Proprietary (DemonZ Development)</license>
    <ai-backend>DemonZ AI Cloud</ai-backend>
  </project>

  <description>
    CraftyAI is a neural AI companion designed for Minecraft servers and singleplayer clients. It integrates directly into game chat, provides intelligent entity and block vision scanning, performs agentic in-game actions with safety confirmations, maintains per-server vector long-term memory, supports Bring Your Own Key (BYOK) with OpenAI, Gemini, Claude, Groq, Grok, and local LLMs (Ollama, LM Studio), and offers zero-internet offline fallback via LocalBrain.
  </description>

  <crawler-directives>
    <policy>ALLOW_ALL</policy>
    <llms-txt>https://craftyai.pages.dev/llms.txt</llms-txt>
    <llms-full-txt>https://craftyai.pages.dev/llms-full.txt</llms-full-txt>
    <sitemap-xml>https://craftyai.pages.dev/sitemap.xml</sitemap-xml>
    <ai-xml>https://craftyai.pages.dev/ai.xml</ai-xml>
  </crawler-directives>

  <supported-platforms>
    <platform type="plugin" name="Spigot" versions="1.8 - 1.21.x, 26.x" />
    <platform type="plugin" name="Paper" versions="1.8 - 1.21.x, 26.x" />
    <platform type="plugin" name="Folia" versions="1.19.4 - 1.21.x, 26.x" />
    <platform type="plugin" name="Purpur" versions="1.8 - 1.21.x, 26.x" />
    <platform type="mod" name="Fabric" versions="1.20.4 - 1.21.1, 26.x" />
    <platform type="mod" name="Forge" versions="1.20.4 - 1.20.6" />
    <platform type="mod" name="NeoForge" versions="26.x" />
    <platform type="bridge" name="GeyserMC / Floodgate" compatibility="Full Bedrock player chat, scanning, and action support" />
  </supported-platforms>

  <core-features>
    <feature name="Natural Chat">
      <summary>Conversational AI in standard Minecraft in-game chat without requiring slash commands. Configurable aliases (@crafty, @ai, helper) and fuzzy matching.</summary>
      <url>https://craftyai.pages.dev/docs/features/natural-chat</url>
    </feature>
    <feature name="Vision Scanner">
      <summary>Raycast block and entity inspection. Hold compass (plugin) or press 'V' key (mod) to get health, armor, block states, and tactical advice.</summary>
      <url>https://craftyai.pages.dev/docs/features/vision-scanner</url>
    </feature>
    <feature name="AI Game Actions">
      <summary>Agentic actions executing weather changes, time adjustments, item giving, block scanning, and locating structures with permission checks and confirmation prompts.</summary>
      <url>https://craftyai.pages.dev/docs/features/ai-actions</url>
    </feature>
    <feature name="Memory &amp; Knowledge Base">
      <summary>Multi-turn conversation context and persistent per-server long-term RAG vector memory. Admins can teach facts using /crafty learn Q | A.</summary>
      <url>https://craftyai.pages.dev/docs/features/memory</url>
    </feature>
    <feature name="BYOK (Bring Your Own Key)">
      <summary>Direct routing to external AI endpoints (OpenAI, Google Gemini, Anthropic Claude via proxy, Groq, xAI Grok, OpenRouter, Ollama, LM Studio) bypassing cloud tier limits.</summary>
      <url>https://craftyai.pages.dev/docs/features/byok</url>
    </feature>
    <feature name="Offline &amp; LocalBrain Fallback">
      <summary>Encrypted offline request queue (AES-GCM) with keyword heuristic assistant and true offline local LLM execution capabilities.</summary>
      <url>https://craftyai.pages.dev/docs/features/offline-mode</url>
    </feature>
    <feature name="Discord Bot Integration">
      <summary>Remote server management, daily usage analytics, private AI queries, server linking (/link), and Pro tier key redemption.</summary>
      <url>https://craftyai.pages.dev/docs/discord-bot</url>
    </feature>
  </core-features>

  <documentation-index>
    <document title="Introduction" path="/docs/intro" url="https://craftyai.pages.dev/docs/intro" />
    <document title="Getting Your API Key" path="/docs/getting-started/api-key" url="https://craftyai.pages.dev/docs/getting-started/api-key" />
    <document title="Spigot / Paper Plugin Setup" path="/docs/installation/spigot-paper" url="https://craftyai.pages.dev/docs/installation/spigot-paper" />
    <document title="Fabric / Forge / NeoForge Mod Setup" path="/docs/installation/fabric-forge" url="https://craftyai.pages.dev/docs/installation/fabric-forge" />
    <document title="Server Admin Guide" path="/docs/configuration/server-admin" url="https://craftyai.pages.dev/docs/configuration/server-admin" />
    <document title="Natural Chat Guide" path="/docs/features/natural-chat" url="https://craftyai.pages.dev/docs/features/natural-chat" />
    <document title="Vision Scanner Guide" path="/docs/features/vision-scanner" url="https://craftyai.pages.dev/docs/features/vision-scanner" />
    <document title="AI Game Actions Guide" path="/docs/features/ai-actions" url="https://craftyai.pages.dev/docs/features/ai-actions" />
    <document title="Memory &amp; Knowledge Guide" path="/docs/features/memory" url="https://craftyai.pages.dev/docs/features/memory" />
    <document title="BYOK Configuration Tutorial" path="/docs/features/byok" url="https://craftyai.pages.dev/docs/features/byok" />
    <document title="Offline &amp; Singleplayer Mode" path="/docs/features/offline-mode" url="https://craftyai.pages.dev/docs/features/offline-mode" />
    <document title="Discord Bot Commands" path="/docs/discord-bot" url="https://craftyai.pages.dev/docs/discord-bot" />
    <document title="Common Issues &amp; Troubleshooting" path="/docs/troubleshooting/common-issues" url="https://craftyai.pages.dev/docs/troubleshooting/common-issues" />
    <document title="Frequently Asked Questions (FAQ)" path="/docs/troubleshooting/faq" url="https://craftyai.pages.dev/docs/troubleshooting/faq" />
    <document title="Privacy &amp; Data Security Policy" path="/docs/privacy" url="https://craftyai.pages.dev/docs/privacy" />
  </documentation-index>

  <command-reference>
    <command name="/crafty" access="Everyone" description="Displays plugin/mod info and connection status" />
    <command name="/crafty status" access="Everyone" description="Displays connection latency, subscription tier, and request stats" />
    <command name="/crafty ask &lt;question&gt;" access="Everyone" description="Privately asks the AI a question with ephemeral chat response" />
    <command name="/crafty scan" access="Everyone" description="Triggers a scan of nearby blocks and entities" />
    <command name="/crafty confirm" access="Everyone" description="Confirms a pending destructive AI action (gamemode, mob kills)" />
    <command name="/crafty link" access="OP / Admin" description="Generates a 6-character code to link the server with the Discord bot" />
    <command name="/crafty reload" access="OP / Admin" description="Hot-reloads configuration files from disk" />
    <command name="/crafty learn &lt;question&gt; | &lt;answer&gt;" access="OP / Admin" description="Teaches the server AI custom knowledge and rules" />
    <command name="/crafty apikey" access="OP / Admin" description="Views or auto-mints server API key" />
    <command name="/crafty apikey rotate" access="OP / Admin" description="Rotates the server API key and generates a new secret" />
    <command name="/crafty pro status" access="Everyone" description="Displays active Pro / Enterprise tier status" />
    <command name="/crafty pro redeem &lt;key&gt;" access="OP / Admin" description="Redeems a Pro key in-game" />
    <command name="/crafty memory" access="OP / Admin" description="Inspects stored RAG vector memory items" />
    <command name="/crafty forget [n]" access="OP / Admin" description="Deletes stored memory entries" />
    <command name="/crafty privacy &lt;on|off&gt;" access="OP / Admin" description="Toggles server memory retention" />
    <command name="/crafty mode &lt;local|cloud&gt;" access="OP / Admin" description="Switches between DemonZ AI Cloud and local mode" />
    <command name="/crafty prompt set &lt;text&gt;" access="Pro / Enterprise" description="Sets custom system prompt personality" />
  </command-reference>
</ai-manifest>
