# CraftyAI

> Neural AI companion for Minecraft servers and singleplayer clients, developed by DemonZ Development. Integrates in-game natural language chat, raycast vision scanning, agentic game actions with player confirmation safeguards, persistent vector long-term memory, BYOK support (OpenAI, Gemini, Claude, Groq, Grok, Ollama, LM Studio), and offline LocalBrain fallback.

- [Full Documentation for LLMs](https://craftyai.pages.dev/llms-full.txt): Complete consolidated documentation in one markdown file.
- [AI XML Manifest](https://craftyai.pages.dev/ai.xml): Machine-readable XML manifest with feature definitions, endpoints, and platform matrix.
- [XML Sitemap](https://craftyai.pages.dev/sitemap.xml): Standard XML sitemap.

## Getting Started & Installation

- [Introduction](https://craftyai.pages.dev/docs/intro): Overview of CraftyAI architecture, platform support (Spigot, Paper, Folia, Purpur, Fabric, Forge, NeoForge), and basic capabilities.
- [Getting Your API Key](https://craftyai.pages.dev/docs/getting-started/api-key): Guide on automatic key generation on first startup and Discord bot retrieval.
- [Spigot & Paper Plugin Setup](https://craftyai.pages.dev/docs/installation/spigot-paper): Installation on Spigot, Paper, Folia, Purpur, Java 8/17+ compatibility, and Bedrock GeyserMC/Floodgate support.
- [Fabric, Forge & NeoForge Mod Setup](https://craftyai.pages.dev/docs/installation/fabric-forge): Client and dedicated server setup on Fabric, Forge 1.20.4-1.20.6, Fabric 1.20.4-26.x, and NeoForge 26.x. In-game 'K' settings menu guide.

## Configuration & Server Management

- [Server Admin Guide](https://craftyai.pages.dev/docs/configuration/server-admin): Granular configuration, subscription tiers (Free, Starter, Pro, Enterprise), LuckPerms permissions, blocked dangerous items, and security alerts.
- [Discord Bot Guide](https://craftyai.pages.dev/docs/discord-bot): Linking servers via `/crafty link` and `/link`, usage metrics (`/stats`, `/my-sessions`), remote AI testing (`/ask`), and Pro key redemption (`/redeem`).

## Features & Mechanics

- [Natural Chat](https://craftyai.pages.dev/docs/features/natural-chat): Conversational in-game chat using aliases (@crafty, @ai, helper), fuzzy matching, game context awareness, and private `/ask` commands.
- [Vision Scanner](https://craftyai.pages.dev/docs/features/vision-scanner): Point-and-scan inspection for blocks and entities using Compass (plugin) or 'V' key (mod).
- [AI Game Actions](https://craftyai.pages.dev/docs/features/ai-actions): Automated in-game actions (time, weather, items, locate structures, timed delayed actions, compound commands) and confirmation safety flow.
- [Memory & Knowledge Base](https://craftyai.pages.dev/docs/features/memory): Short-term chat history and per-server long-term RAG vector memory with `/crafty learn Q | A`.
- [BYOK (Bring Your Own Key)](https://craftyai.pages.dev/docs/features/byok): Direct routing to custom AI endpoints (OpenAI GPT-5.6/4o, Google Gemini, Anthropic Claude via proxy, Groq, xAI Grok, OpenRouter, Ollama, LM Studio).
- [Offline & Singleplayer Mode](https://craftyai.pages.dev/docs/features/offline-mode): Offline singleplayer client support, LocalBrain heuristic assistant fallback, AES-GCM encrypted queue, and zero-internet local LLM setups.

## Troubleshooting & Policy

- [Common Issues](https://craftyai.pages.dev/docs/troubleshooting/common-issues): Solutions for connection timeouts, API key validation, mod loader dependencies, and rate limit errors.
- [Frequently Asked Questions (FAQ)](https://craftyai.pages.dev/docs/troubleshooting/faq): Pricing, data privacy, source code status, model details, and tier management.
- [Privacy Policy](https://craftyai.pages.dev/docs/privacy): Detailed data collection disclosure, session isolation, and encryption policies.

## Optional Resources

- [Modrinth Download](https://modrinth.com/plugin/craftyai): Official Modrinth project page.
- [Discord Community](https://discord.gg/zCkE44hsBR): Official DemonZ Development support server.
- [Official Website](https://demonzdevelopment.online): DemonZ Development homepage.