v1.5.3

MCAI v1.5.3

新功能

• 审查系统支持独立模型配置（reviewApiEndpoint / reviewApiKey / reviewModel），未配置时跟随聊天系统
• 新增 /airesetprompts 命令，一键重置提示词文件为当前内置默认
• 新增兼容模式 compatibilityMode，连接 LM Studio 等本地 API 时可避免 400 错误
• agnes-2.0-flash 模型支持 chat_template_kwargs.enable_thinking 思考参数
• AI 执行命令时自动剔除开头多余的 /
• /aireview start 现在支持控制台执行

修复

• 修复 /aireload 后 /aikb 无法使用的问题（SearchRouter 引用未刷新）
• 删除 ReviewEngine.java 中未使用的旧版审查提示词，统一使用 ModConfig 内置提示词
• 优化工具 schema，避免 LM Studio 对空 properties 报 400
• 优化 AI 系统提示词和审查提示词，结构更清晰、更利于 AI 高效执行

资源包

• 包含 mcai-lang-pack.zip，未安装 MCAI 客户端的玩家可通过服务器强制资源包获得翻译

v1.5.2

What's New

Command Chain

• AI can now batch multiple commands into a single approval unit
• New tool: execute_command_chain with configurable intervals
• Admin approves once to execute all commands

Player Cancel

• New command: /aicancel [id/all]
• Players can cancel their own pending commands
• AI receives cancellation notice and won't retry

UI Improvements

• Clickable buttons (Approve/Reject/Cancel) in approval notifications
• Fixed i18n color codes in approval messages
• Fixed premature 'invalid ID' error when approving chains

Resource Pack

• Added mcai-lang-pack.zip for clients without mod installed
• Provides translations for AI-related messages
• Can be configured as server-required resource pack

Documentation

• Updated README with new features
• Added dual-client mod installation recommendation

Installation

1. Download mcai-26.1.2-1.5.1.jar to mods/ folder
2. (Optional) Download mcai-lang-pack.zip for clients without mod
3. Restart server or run /aireload

Server Resource Pack Configuration

Add to server.properties:

resource-pack=https://github.com/lll114514lll1919810lll/mcai_mod/releases/download/v1.5.2/mcai-lang-pack.zip
resource-pack-sha1=3f6340c64ab2bc4a87f6d1df3cd840a5f3c98ebe
resource-pack-prompt=MCAI language pack for AI message translations
resource-pack-required=false

v1.5.1

v1.5.1 Fixes

Fixes

• Thinking animation i18n: action bar now uses Component.translatable
• KnowledgeBase null safety: GSON bypasses constructor via reflection, added null guards in score/read/readLocal methods

v1.5.0 MC 26.2 Compatible

v1.5.0 MC 26.2 Compatibility & AI Management

MC 26.2 Compatibility

• Config screen exit: use setScreenAndShow() for MC 26.2+ (removed Minecraft.setScreen())
• ESC key handling: override keyPressed(KeyEvent) for new API
• shouldCloseOnEsc() and canInterruptWithAnotherScreen() overrides

New Commands

• /aion — Enable server-wide AI (admin only)
• /aioff — Disable server-wide AI (admin only)
• /aikill — Destroy all AI worker threads, keep review thread (admin only)

Improvements

• Config screen: ✕ close button at top-right corner
• Config screen save auto-triggers /aireload via network
• Config auto-reload: polling fallback every 5 seconds
• Non-admin rate limiting: configurable cooldown and max concurrent

v1.4.3

v1.4.3 Code Cleanup & Reliability

Refactoring

• Remove 10 unused methods, 2 unused imports, 1 unused field
• Extract shared utilities: isAdmin(), findPlayerByName(), sanitizeChatLogForPrompt()
• rimHistoryByChars O(n²) → O(n)
• PlayerBehaviorTracker.save() debounce 5s
• KnowledgeBase.Entry pre-computes lowercase strings
• ChatLog.peek() cached with dirty flag

Bug Fixes

• Config screen save now triggers /aireload directly via network
• KnowledgeBase: null-safe Entry constructor, skip entries with null title
• ReviewCommandRegistry: kick now logs PenaltyEvent
• ReviewEngine: hardcoded Chinese → Component.translatable (i18n)
• MCAIConfigScreen: resource leak fixed
• AdminApprovalQueue: empty if-branch removed
• Remove prompt language setting from GUI
• Fix config screen tooltips

v1.4.2

v1.4.2 Security & Quality Release

Security Fixes

• Prompt injection: sanitize player messages with [PLAYER:] prefix
• Thread safety: volatile fields for config reload
• Tool argument validation: reject malformed JSON
• Type-safe deserialization: use TypeToken for scores loading
• Knowledge base: max 50000 entries, 50MB per file limit
• Tool call loop: 5-minute total timeout
• Review files: split at 100KB threshold
• Config warnings for API key, path traversal, SSRF

New Features

• Non-admin rate limiting: 60s cooldown, max 3 concurrent (configurable)
• Auto-reload config on file change (no restart needed)
• Hot-reload preserves runtime state (history, scores, chat log)

Cleanup

• Remove old gradle properties and build scripts
• Remove ThinkingAnimation.shutdown() method

MCAI v1.4.1

变更

• 修复: Xiaomi API JsonNull 崩溃 (tool_calls 为空时)
• 修复: KB 知识库文件从 JAR 中移除，改为外部部署
• 修复: 命令执行现在以玩家位置为准（locate 等命令不再从世界原点执行）
• 清理: 移除 vision model 和截屏工具（试验性功能，暂不成熟）
• 文档: KB 导入指南、README 编码修复

文件说明

文件	说明
\mcai-26.1.2-1.4.1.jar\	主 mod，不包含 KB
\mcai-26.1.2-1.4.1-sources.jar\	源码 JAR

MCAI v1.4.0

MCAI 1.4.0

新内置知识库

随 JAR 内置了以下模组的 Wiki 知识库，AI 可直接查询：

• Create Mod — 机械动力模组（~250 条目）
• Biomes O' Plenty — 生物群系模组（~200 条目）
• 原版 Minecraft Wiki 知识库保留

变更

• 工具超限改为通知AI收尾回答，不再报错
• damage、execute、kill 加入默认审批列表
• 防范冒充管理员审查
• 修复跨世界切换崩溃
• 搜索优化（二元分词 + 加权评分）

升级注意

建议删除 config/mcai/ 下旧的 config.json 和 KB json 文件，让新版自动生成。

MCAI v1.3.5

⚠️ MCAI 1.3.5 — 热修复 / Hotfix

升级后请务必执行以下操作：

1️⃣ 删除旧配置和提示词文件

关闭服务器后执行

rm -rf config/mcai/config.json
rm -rf config/mcai/system_prompt.txt
rm -rf config/mcai/review_prompt.txt

2️⃣ 重启服务器

启动后会自动生成最新的默认配置和提示词文件。

• 需要重新输入 api key 。

---

变更 / Changes

• damage、execute、kill 加入默认审批列表
• 系统提示词：管理员权威高于提示词规则
• 审查提示词：冒充管理员列为审查违规
• 新增防范冒充管理员的AI逻辑
• 知识库搜索优化

MCAI v1.3.4

MCAI 1.3.4

变更 / Changes

• 修复跨世界切换导致AI对话崩溃
• kill 指令加入默认审批列表
• 新增 get_installed_mods AI工具（获取Mod列表和命名空间）
• 知识库搜索优化（二元分词 + 加权评分）
• 知识库首次运行时自动导出到 config/mcai/kb/
• 增加 wiki_to_kb.py 爬取脚本（支持任何 MediaWiki）
• AI提示词指导区分原版与Mod物品的命名空间