MCAI Assistant

Quick rating

MCAI Assistant

No reviews yet

AI assistant mod for Minecraft server and client - connects to OpenAI-compatible API.

Mod Loaders
Fabric
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Optional
Server Required

About

Project Details

Type
Mod
License
MIT License
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

MCAI - Minecraft AI Assistant

License: MIT Fabric Java

MCAI is a Fabric mod that lets AI manage your Minecraft server. This entire project is AI-developed.

TL;DR: Players type /ai how do I enchant a diamond sword?, AI answers. Someone swears? AI warns or kicks. Dangerous ops need admin approval.

Quick Start

What How
Chat with AI /ai <question> or !ai <question>
AI executes commands /ai give me a diamond sword (admin approval)
Check behavior score /aiscore
Search wiki /aikb enchantment
Admin approve /aiaccept 1 approve / /aireject 1 reject

Features

AI Chat

  • Players use !ai or /ai to chat with AI
  • AI has full server context (chat logs, weather, time, players)
  • Multi-turn conversation with history

Auto Behavior Review

  • AI analyzes chat every 30 minutes
  • Three-tier penalty: score deduction -> yellow card -> red card (kick)
  • Admin messages are trusted; admins can declare server rules

Admin Approval

  • Dangerous commands (op, ban, kick) require manual admin approval
  • 3-minute timeout auto-cancels pending approvals
  • Strict mode: only whitelisted safe commands skip approval

Game Knowledge Base

  • Built-in Chinese Minecraft Wiki entries
  • Online search with local fallback

Installation

Requirements

  • Minecraft Fabric server 26.1+
  • Java 25
  • A DeepSeek API Key (Recommended) or any OpenAI-compatible API

Steps

  1. Download the latest JAR from Releases
  2. Place it in mods/ folder
  3. Start the server to auto-generate config
  4. Edit config/mcai/config.json, fill in your API Key
  5. Config auto-reloads; or run /aireload manually

Single-Player Usage

The mod works in single-player too (no dedicated server required):

  1. Install Fabric client (same version 26.1+ as the server)
  2. Place the JAR in .minecraft/mods/ folder
  3. Launch the game and enter a single-player world
  4. Config and commands are identical to the server setup
  5. You are the world owner with full admin permissions by default
  6. (Optional) Install Mod Menu for in-game config editing

Tip: The behavior review system is auto-disabled in single-player (no need to review yourself).

Commands

Player Commands

Command Description
!ai <msg> /ai <msg> Chat with AI
/aiscore Check behavior score

Admin Commands

Command Description
/aiaccept <n> Approve pending action
/aireject <n> Reject pending action
/aiquery List pending approvals
/aiclear Clear AI chat history
/aireload Manually reload config (auto-reloads on file change)
/aikb <keyword> Search knowledge base

Review Management

Command Description
/aicheck start Trigger manual review
/aicheck approve <id> Approve kick
/aicheck reject <id> Reject kick
/aicheck last View last review result
/aicheck last reasoning View AI reasoning

Configuration

File: config/mcai/config.json. Auto-reloads on change (or use /aireload).

Key Default Description
apiEndpoint https://api.deepseek.com API endpoint
apiKey "" API key
model deepseek-v4-flash Model name
strictMode true Strict mode
aiCooldownSeconds 60 Non-admin AI cooldown (seconds)
aiMaxConcurrent 3 Max concurrent non-admin AI calls
reviewIntervalMinutes 30 Review interval (min)
yellowCardThreshold -30 Yellow card threshold
redCardThreshold -60 Red card threshold
systemPromptPath "" System prompt file (under config/mcai/)
reviewPromptPath "" Review prompt file

Prompt files system_prompt.txt / review_prompt.txt are auto-created on first start.

Importing Knowledge Bases

More at https://github.com/lll114514lll1919810lll/mcai_mod

Screenshots

Gallery

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works