Описание

# CraftyAI
### An in-game conversational AI companion for Minecraft
Talk in Minecraft chat, scan surroundings for mobs and resources, manage weather and time, and run game actions in-game. Free with 500,000 daily tokens.
> Have questions, ideas, or feedback? Join our community on the [CraftyAI Discord](https://discord.gg/zCkE44hsBR).
## Features
### In-Game AI Chat
Talk to Crafty in Minecraft chat. Ask for recipes, building advice, survival tips, or general conversation. Crafty handles typos, recalls recent conversations across sessions, and generates plain-text replies.
### Surroundings & Vision Scanner
Press **V** or ask Crafty in chat to look around. Crafty scans entities, mobs, blocks, and biomes within 32 blocks and reports observations in chat.
### Game Actions & Helper Commands
Authorized players and operators can ask Crafty to perform in-game actions:
- Change time (`make it day`, `set time to night`)
- Control weather (`clear the rain`, `make it a thunderstorm`)
- Heal and feed players
- Locate structures and biomes (`/locate structure`, `/locate biome`)
- Give items and execute permitted commands
### Safety & Confirmation
Crafty includes safety controls:
- Sensitive or disruptive commands require explicit player confirmation before execution.
- Cancel active action sequences with `/craftyclient cancel`.
- Non-operator players cannot trigger administrative or cheat commands.
### Bedrock Edition Support
CraftyAI supports Bedrock Edition players joining through GeyserMC and Floodgate, including prefixed gamertags (`.`, `*`, `-`) up to 36 characters long.
---
## Daily Token Tiers
CraftyAI is free. Higher tiers provide additional capacity for larger server networks:
| Tier | RPM | Requests / Day | Tokens / Day | Notes |
|---|---|---|---|---|
| **Free** | 30 | 100 | **500,000** | Quota for solo play and small servers |
| **Starter** | 100 | 1,000 | **1,000,000** | Limits for growing communities |
| **Pro** | 200 | 5,000 | **2,500,000** | Custom prompts and priority routing |
| **Enterprise** | 500 | 100,000 | **10,000,000** | High throughput for large multiplayer networks |
---
## Supported Versions and Loaders
Install the jar matching your exact loader and Minecraft version:
### Client / Server Mods
- **Fabric**: Minecraft `1.20.4`, `1.20.5`, `1.20.6`, `1.21` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, `26.2`, and `26.3` *(requires Fabric API)*.
- **NeoForge**: Minecraft `1.20.4`, `1.20.5`, `1.20.6`, `1.21` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, `26.2`, and `26.3`.
- **Forge**: Minecraft `1.20.4`, `1.20.6`, `1.21`, `1.21.1`, `1.21.3` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, and `26.2`.
### Server Plugin
- **Paper / Spigot / Purpur / Folia**: Minecraft `1.8` through `26.3` using `craftyai-spigot-1.4.1.jar`.
---
## Quick Setup
### For Singleplayer & Modded Clients (Fabric / Forge / NeoForge)
1. Download the jar for your loader and Minecraft version from the [Versions tab](https://modrinth.com/mod/craftyai/versions).
2. Drop the jar into your `.minecraft/mods` folder.
*(Fabric users: ensure [Fabric API](https://modrinth.com/mod/fabric-api) is also in your mods folder).*
3. Launch Minecraft.
4. Press **M** in-game to open settings and click **Auto-Mint Key**.
### For Dedicated Servers (Paper / Spigot / Purpur / Folia)
1. Download `craftyai-spigot-1.4.1.jar` from the [Versions tab](https://modrinth.com/mod/craftyai/versions).
2. Place the jar in your server's `plugins/` directory.
3. Start or restart your server. Crafty provisions a free API key on first launch.
4. Type in chat to start talking with Crafty.
---
## Keybinds & Commands
### Default Keybindings
| Key | Action |
|---|---|
| **M** | Open CraftyAI settings screen (rebindable in Controls) |
| **J** | Open CraftyAI direct chat window (rebindable in Controls) |
| **V** | Surroundings scan (rebindable in Controls) |
### Common Chat Commands
| Command | Description | Permission |
|---|---|---|
| `/crafty ask ` | Talk to Crafty via command | `crafty.chat` |
| `/crafty status` | Check connection and daily token usage | `crafty.chat` |
| `/crafty tasks` | List active scheduled reminders and tasks | `crafty.chat` |
| `/crafty tasks cancel ` | Cancel an active scheduled task | `crafty.chat` |
| `/crafty confirm` | Confirm a pending action requested by Crafty | `crafty.chat` |
| `/craftyclient cancel` | Abort an ongoing client action sequence | `crafty.use` |
| `/crafty apikey` | View or auto-mint your API key | `crafty.admin` |
| `/crafty reload` | Reload configuration | `crafty.admin` |
| `/crafty memory` | View recent conversation memory context | `crafty.use` |
| `/crafty forget` | Clear stored conversation memory | `crafty.use` |
---
## Privacy
- Chat prompts and scan data are processed to generate in-game responses. We cannot view your prompts, and data is not sold or shared with advertisers.
- **BYOK (Bring Your Own Key)**: Server administrators can supply their own API keys (such as Gemini or Groq) in configuration for data isolation.
- **Telemetry**: Crafty collects anonymous heartbeat pings and request volume counters to monitor edge stability. Disable telemetry by setting `enable_metrics: false` in `config.yml` (Plugin) or `telemetry_enabled: false` in client mod settings.
---
## Community & Support
- Found a bug or want to suggest a feature? Join our [Discord server](https://discord.gg/zCkE44hsBR) or open an issue on GitHub.
- Documentation: [craftyai.pages.dev](https://craftyai.pages.dev)
---
## Sponsored by Nexeu Hosting
[](https://nexeu.zip/)
Minecraft server hosting with fast deployment, dedicated hardware, and 24/7 support.
**[Explore hosting plans at nexeu.zip](https://nexeu.zip/)**
---
CraftyAI is an independent project and is not affiliated with Mojang, Microsoft, or Minecraft.