Description
Introduction
Note: For the latest information, please refer to the GitHub repository.
Xxsx Smart Core is a Forge mod that integrates AI large language models into Minecraft, enabling natural language game control via the /ai command.
Players describe their needs in natural language, and the AI autonomously analyzes the intent and executes corresponding Minecraft commands, supporting multi-turn iteration to complete complex tasks. A free shared API key is included out of the box, with support for custom personal API keys.
Key Features
- Natural Language AI Chat — AI can complete tasks and return results by executing Minecraft commands and other methods
- Game State Queries — AI can query player info, block types, item properties, crafting recipes, nearby entities, and more
- PMX Voxel Architecture — Parses MMD model files and converts them to Minecraft block structures via surface voxelization and CIELAB color matching
- Knowledge Base System — Built-in mod knowledge base in the JAR (with planned gradual integration of various mods) and supports external extensions; AI queries automatically as needed
- Per-Player API Configuration — Each player can independently configure their own API key and model
- Multi-Model Switching — Supports in-game switching between custom API providers compatible with OpenAI Chat Completions format
- Context Auto-Compression — When the token limit is exceeded, choose between truncation or AI summarization
- Session Persistence — Conversation history automatically restored when the same player reconnects
- Most configuration options available in
config/xxsx_builder-common.toml
Commands
Refer to in-game prompts for accuracy
/ai [message]— Chat with AI in natural language (requires cheats by default)/ai build [PMX path] [scale]— Parse a PMX model and generate a voxel structure (defaults to player's current coordinates; you can also send the file path and requirements directly to the AI and let it handle the invocation)/ai model [model name]— Switch AI model/ai stop— Interrupt current task
Compatibility
Theoretically compatible with all mods, no matter how complex or niche — though it may consume more tokens. The built-in free model has limited capability; we recommend connecting to the DeepSeek open platform. If you have access to free credits from other providers, most will also outperform the built-in model.
DeepSeek is affordable under normal use, unless you are constantly using it for command-driven building (especially large or complex structures).




