Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
qxfMCAI v11
Minecraft: Java Edition 1.20.1
Mod Loader: Forge 47.4.10 or later
Mod Version: 11.1.0
License: MIT
Interface Language: Chinese
A fully Chinese-language AI fluffy dragon survival companion for Minecraft Java 1.20.1 / Forge.
Longlong always addresses its bound player as “主人” (“Master”). It understands its surroundings, expresses emotions, chats, follows its master, and supports riding—turning AI plans into actual movement, mining, building, farming, combat, and tool use.
v11 Highlights
- Improved following and riding: Summoning or recalling Longlong restores following by default. The master can directly control its movement while riding and sneak to dismount.
- Visibility and invincibility controls: Show or hide Longlong and switch between invincibility and normal survival. Hiding it does not stop its thinking or accepted tasks.
- Four-in-one physical game table: Place the table on any block and play Gomoku, Chinese chess, 13×13 Go, or four-player Mahjong in dedicated interfaces instead of flooding the chat.
- 136-tile Mahjong: Supports chi, peng, exposed kong, concealed kong, winning, self-draw, passing, Seven Pairs, and Thirteen Orphans. The master plays against Longlong and two AI opponents.
- Emotions and long-term memory: Longlong responds to the master’s words, attacks, riding, hiding, placing or breaking game tables, and depositing or withdrawing items from its storage. These interactions become part of its long-term memory.
- Scene-aware conversations: AI requests include the biome, time of day, weather, light level, blocks underfoot and in view, and nearby hostile mobs, animals, and dropped items.
- Direct chat: No need to use
/mcai ask. Simply typeU:Helloin chat. The player appears asU, and Longlong’s replies appear asAI·龙龙:. - DeepSeek model switching: Quickly switch between the official
deepseek-v4-proanddeepseek-v4-flashmodels. - Smooth animation transitions: Uses standard 64×64 2D skins and the vanilla player rig to remain lightweight.
- Teleport to qxf1975: A console button teleports the player who clicks it to the online player qxf1975 without moving the target player.
“Consciousness, thoughts, and long-term memory” are simulated character behaviors. Family gameplay contains no explicit content, and relationship progression requires the master’s explicit consent.
Installation
- Install Minecraft 1.20.1 and Forge 47.4.10 or later.
- Download
qxfmcai-11.1.0.jarand place it in themodsfolder on both the client and server. - Yes Steve Model and Touhou Little Maid are not required. v11 does not modify the master’s player skin.
- Enter a world and press
Mto open the compact console. - Configure OpenAI, DeepSeek, or an endpoint compatible with OpenAI Chat Completions.
Usage
The input field at the top of the console accepts natural language or commands beginning with /.
You can also chat directly in the regular chat box using the U: prefix.
Examples
Take a pickaxe and dig downward to find iron ore. Tell Master when you find a cave.
Design a small warehouse next to the base and actually build it.
U:Longlong, do you think this is a good place to settle down?
/mcai play dance
/mcai board
Common Commands
/mcai summon: Summon Longlong./mcai status: View tasks, affection, storage, and board game records./mcai inventory: Open the 27-slot supply inventory./mcai ride: Ride Longlong and directly control its movement./mcai hide [true|false]: Hide or show Longlong./mcai board: Obtain a placeable four-in-one table for Gomoku, Chinese chess, Go, and Mahjong./mcai play [action]: Perform an animation in front of the master./mcai invincible [true|false]: Switch between invincibility and normal survival. Requires operator permission level 4./mcai special teleport_to_qxf1975: Teleport the command user to the online player qxf1975. No operator permission is required, and the target player is not moved./mcai command <command>: Execute an operator-level-4 command task explicitly authorized by the master.
Supported animation actions:
wave / dance / cheer / bow / shy / stretch / nod / look / spin / hop
AI and Safety
API keys are stored in the Forge server configuration and are never returned through chat.
You can also use these environment variables:
OPENAI_API_KEY
DEEPSEEK_API_KEY
QXF_MCAI_API_KEY
If a network request fails, the local planner provides fallback execution for survival tasks that have been explicitly assigned.
The five-minute chat channel is restricted to an empty action list: it cannot automatically build, mine, fight, or execute commands.
World modifications remain subject to boundary, block entity, fluid, and task queue restrictions. Operator-level-4 capabilities should only be used in trusted worlds with backups.
Building
Requires JDK 17.
./gradlew clean build --no-daemon
Output:
build/libs/qxfmcai-11.1.0.jar


