⚡︎ 全新服务器运行时 – 人工智能 ⚡︎
“Minecraft 服务器的 AI 层。”
✔ 多 API 支持 • ✔ RAG 知识库 • ✔ 简单且强大 • ✔ 高度可定制 • ✔ 极低延迟
MC 版本: 1.16.x – 1.26.x • JAR 大小: 6.5 MB • AI 模型: Gemini, Claude, OpenAI • 自主工具调用
🌐︎ NSR-AI 是什么?
NSR-AI (New Server Runtime – Artificial Intelligence) 是一款高性能的 Minecraft AI 插件,它充当智能中间件,弥合先进的大型语言模型与 Minecraft 服务器环境之间的差距。它不仅仅是一个简单的聊天工具;它是一个智能生态系统,将 AI 编织进你世界的方方面面——从自动化的员工支持到具有情感智慧的同伴。
🚀︎ 为什么选择 NSR-AI?
-
多 API 主权 — 你永远不会被锁定在单一提供商上。可以实时在 Gemini、Claude 和 OpenAI 之间切换。
-
无妥协的安全性 — 通过我们的 三重加密(AES-256-GCM),你的 API 密钥在数学上被锁定到你的服务器和玩家 UUID 上。
-
高性能智能 — 基于完全 异步管道 构建,NSR-AI 对服务器的 TPS 影响 非常小。
-
自适应叙事记忆 — 通过 记忆蒸馏,你的 AI 记得你的历史、服务器的传说以及玩家的名字。
🛠︎ 混合智能引擎
NSR-AI 为你的服务器提供多功能数字基础设施:
-
7x24 小时智能支持代理: 使用 RAG(检索增强生成) 从你的 knowledge.json 库中提供精确答案,充当完美的员工助手。
-
情感化游戏同伴: 通过独特的 mood(情绪)(HAPPY, FURIOUS, TIRED)、羁绊等级和独特关系来驱动 宠物情感系统。
-
动态内容生成器: 生成沉浸式的符合 lore 的任务描述和对话,并根据每个玩家的具体旅程进行调整。
-
隐私优先的玩家实用程序: 允许玩家自带密钥,管理私有的“检查点”,并控制自己的 AI 环境。
-
零停滞架构: 在后台处理复杂的 AI 逻辑,使服务器的心跳保持在完美的 20.0 TPS。
-
可扩展的开发框架: 一个用于增长的基础,通过 /aia 命令门户提供强大的 开源附加组件 API。
-
自主操作与工具执行: 原生基于流的工具调用,带有 10 个通用的内置工具(自动合成、物品栏检查与整理、空间雷达、铁砧优化器、多命令执行、交互式审批)以及动态运行时自定义工具。
🛡︎ 技术深入解析
-
零知识安全标准: 使用三层认证加密(AES-256-GCM)。即使文件被盗,你的 API 密钥对其他人来说仍然是不可读的。文件系统权限限制为仅所有者读写。
-
上下文感知记忆蒸馏: AI 不会忘记,而是像“写日记”一样记录你的对话。它将历史摘要为单个记忆消息,以保持数千条消息的上下文活跃。
-
免员工知识逻辑(RAG): 将你的 knowledge.json 变成活数据库。系统提取问题的“意图”,为 AI 提供事实性的“作弊表”,防止幻觉。
-
自愈合基础设施: 一个自动化的后台系统监控错误并静默应用安全补丁。如果一个 AI 提供商失败,系统可以自动切换到备用提供商。
⚙︎ 核心功能
-
自主函数调用与 ReAct 智能体循环 — NSR-AI 从被动的聊天助手转变为自主的游戏内同伴,实时评估游戏状态并执行多步操作。
-
10 个原生通用内置工具 — 免手合成(auto_craft)、物品栏 GUI 检查(get_inventory)、360° 环境雷达(get_world_environment)、长期记忆图钉(pin_knowledge)、零惩罚铁砧优化(anvil_enchant_optimizer)、物品整理与潜影盒处理(inv_arrange)、多命令批量执行(execute_command)、交互式玩家审批(execute_command_with_approval)、智能命令起草(draft_command_to_chat)以及插件命令发现(plugin_command_lookup)。
-
动态自定义工具引擎 — 无需编译 Java JAR 即可创建和热重载你自己的自定义 AI 工具。支持零代码声明式 YAML(.yml)、完整的 JavaScript(.js,使用 Nashorn ES6)、文件夹包以及受防 Zip Bomb 保护的归档文件(.zip),直接位于 plugins/NSR-AI/custom_tools/ 内部。
-
零延迟异步 AI 引擎 — 完全与 Minecraft 主线程解耦,NSR-AI 确保即使在繁重的 AI 处理和工具执行期间,服务器也能保持 20 TPS。
-
隐私与匿名化层 — 一个强大的、可选的隐私系统(/ai opt in),在数据到达外部 AI 提供商之前掩码玩家名称和 IP 地址。
-
开发者 API 与拦截器 — 高级 API,允许附加组件实时拦截和修改玩家输入或 AI 响应。
-
多 API 集成与提供商检测 — 无缝切换 Gemini、Claude 和 OpenAI。系统具备 自动提供商检测 功能,实现零配置设置。
-
平滑的 API 密钥轮换与负载均衡 — 自动循环使用多达 20 个密钥。如果一个密钥达到速率限制,系统会智能地回退到下一个密钥,以实现零停机时间。
-
三重安全架构 — API 密钥受到 Server Master Key(服务器主密钥)、Player Master Key(玩家主密钥)和 Project Key(项目密钥)跨 AES-256-GCM 加密的保护。
-
高级知识系统 (RAG) — 使用 检索增强生成 和混合意图识别,从你的传说与事实中查找精准答案。
-
AI 宠物情感系统 — 驯服并绑定具有独特性格、情绪和背包的宠物。包含一个安全系统,可与好友共享宠物访问权限。
-
高级记忆与上下文感知 — 具备 AI 驱动的 摘要 和实时 上下文跟踪 功能,确保对话连贯且不产生延迟。
-
大师级聊天管理 — 完全掌控你的对话历史。使用 /ai chat 配合 异步持久化日志 保存、恢复或删除对话。
-
专业管理员模式 — 通过安全代码访问高级管理工具。在游戏中通过 潜行 或使用专用命令可立即停用。
-
自动配置加密 — 添加到 config.yml 的任何纯文本密钥在插件重载时都会自动加密,防止纯文本泄露。
-
用户友好的错误处理 — 接收清晰的错误消息及可行的解决方案,以便即时修复问题。
-
主动维护与自动修复器 — 一个自动化系统,监控、下载并应用关键的 安全补丁 和 Bug 修复,以保持服务器稳定运行。
-
统一附加组件系统 (/aia) — 一个标准化的模块化框架,所有扩展(如 Player Stats 或 AFK Tracker)均通过 /aia 命令门户进行管理。
-
流畅的 UI/UX 与 AI 感知 — 专业的 Cyber-Console 界面,带有交互式的 [Stop]、[Edit] 和 [Regenerate] 按钮以及动态状态指示器。
? 2.0-pre 更新内容 — 实用工具、自动化与命令精通更新
NSR-AI v2.0-pre 将插件转变为全能的自主游戏内伴侣和命令引擎,支持原生基于流的工具调用:
? 功能摘要表
| 功能 / 工具 |
函数名称 |
主要用途 |
关键能力 |
| ⚒️ 自动合成引擎 |
auto_craft |
免手动物品合成 |
2x2 网格放置,3x3 工作台队列,副手扫描,智能父材质分解(例如铁块 $\rightarrow$ 铁锭) |
| ?️ 物品栏与生命体征检查 |
get_inventory |
逐槽位 GUI 布局检查 |
玩家生命值/饥饿值生命体征,GUI 槽位布局地图 (0-40),自定义物品显示名称,精确耐久度统计(剩余/最大/百分比),潜影盒扩展 |
| ? 世界与空间雷达 |
get_world_environment |
实时环境与导航雷达 |
精确 X/Y/Z 坐标,俯仰角/偏航角,正北/南/东/西朝向维度,生物群系,游戏内时钟时间,天气,方块/天空光照,怪物生成危险度 |
| ? 标记事物与知识 |
pin_knowledge |
长期记忆与自动 RAG 标记 |
双层 knowledge.json 存储:直接人格提示注入 + 已标记路径点/笔记的自动 RAG |
| ? 铁砧附魔优化器 |
anvil_enchant_optimizer |
零损耗铁砧排序 |
二叉合并树算法,总经验值计算,水平流程图,以及动画化的 500ms 自动合成会话 |
| ? 物品栏管理 |
inv_arrange |
网格排序、堆叠与物品处理 |
左上到右下槽位排序 (9-35),快捷栏堆叠合并 (0-35),快捷栏暂存 (0-8),盔甲自动穿戴/卸下,潜影盒打包与解包,丢弃物品 |
| ⚡ 多命令执行器 |
execute_command |
自主命令执行 |
分号/换行符多命令批处理,引号感知解析,结构化 JSON 结果数组,OP 工具豁免规则 |
| ? 命令审批 |
execute_command_with_approval |
修改状态的安防守卫 |
交互式聊天按钮 ([✅ APPROVE] / [❌ CANCEL]),原子执行,60 秒过期超时,经济安防守卫 |
| ✏️ 智能命令草稿 |
draft_command_to_chat |
交互式聊天预输入 |
可点击的 SUGGEST_COMMAND 聊天组件,将修正后的命令预输入到玩家聊天输入框中 |
| ? 插件与命令查找 |
plugin_command_lookup |
服务器命令发现 |
动态运行时扫描已安装的服务器插件、注册的命令、别名和 Bukkit 帮助主题 |
| ? 通用流适配器 |
StreamProviderAdapter |
多 LLM 流标准化 |
用于 Anthropic Claude (input_json_delta)、OpenAI 和 Google Gemini 后端的多个块 SSE 参数累积 |
| ? 动态自定义工具引擎 |
CustomToolManager |
模块化独立扩展性 |
零代码 YAML (.yml)、JavaScript (.js)、文件夹包 (index.js) 以及防 Zip-Bomb 保护的 ZIP 文件 (.zip),支持实时 /ai tools reload |
?️ 如何创建自定义工具指南
要了解如何逐步创建、配置和编码自定义工具,请点击此按钮:
? 直接链接:
🚀︎ 设置指南
-
下载: 获取 NSR-AI 的最新稳定版本。
-
安装: 将下载的 .jar 文件放入服务器的 /plugins 文件夹中。
-
配置: 启动服务器一次以生成文件。然后,打开位于 /plugins/NSR-AI/ 文件夹中的 config.yml,并在 api-keys 列表中添加你的 API 密钥。
-
重载并开始: 启动或重载服务器。一切就绪!
? BlackForge Studio AI 生态系统组合 ?
通过我们的三部分 AI 生态系统组合,将你的服务器变成一个互动、生动且响应迅速的世界。这些插件协同工作,创造出无与伦比的游戏体验:
-
NSR-AI Core Engine:服务器的基石与大脑。这是一款高性能、异步、支持多 API 的 Minecraft AI 插件,具备三层加密、记忆蒸馏和 RAG(检索增强生成)知识库功能。
-
Advanced Player Stats 3.0 (APS):一个独立分析引擎,可接入 NSR-AI API。具有 递归 AI 推理 功能——AI 能够“思考”并请求玩家统计数据(如击杀数、死亡数、游戏时长、弓术命中率、盾牌格挡次数,甚至聊天消息长度),同时无声地扫描物品栏以回答玩家的查询(例如:“比较前三名玩家的弓术命中率” 或 “我表现如何?”)。
-
ChatBuddy 1.0 (CB):一个自发的、自主的聊天伴侣。与仅在受命令时才说话的机器人不同,ChatBuddy 会阅读聊天内容,并使用模糊关键词匹配和莱文斯坦距离算法主动介入对话。它直接集成玩家统计信息、玩家死亡事件(附带俏皮话)以及成就系统!
获取这三款插件,构建完全自动化、沉浸式的角色扮演或辅助同伴设置,让你的玩家惊叹不已!
📜︎ 指令
管理员指令
/ai admin <activation_code> — 切换高级功能的管理员模式。
/ai admincode — 查看你的私有激活码(需要 OP 权限)。
/ai data all <page> — 分页显示知识库中存储的所有条目。
/ai add <keyword>, <message_content> — 添加新条目(需要确认)。
/ai remove <keyword> — 从知识库中移除特定条目。
/ai reload [f|features|nsr-ai|k|knowledge|c|config] — 重新加载特定的插件组件(OP 玩家可绕过管理员模式)。
/ai cache <clear|refresh> <player|all> — 管理其他玩家的会话历史记录。
/ai memory <clear|refresh> <player|all> — 管理其他玩家的对话记忆。
/ai tools — 显示所有注册的内置通用工具和自定义工具及其实时状态和版本。
/ai tools <name> — 检查详细的元数据、作者、版本、类型、描述和参数模式。
/ai tools reload — 热重载 plugins/NSR-AI/custom_tools/ 目录下的所有自定义工具,服务器零停机。
/ai reload tools — 通过主重载处理器热重载自定义工具的统一指令。
/ai migrate — 自动将数据从旧版 YAML 格式迁移并备份到 JSON 格式。
/aia addon — 列出所有已安装的附加组件及其状态(Active/Banned/Error/Inactive)。
/aia addon [addon_name] — 查看附加组件的版本、作者和描述。
/aia plugin — 列出所有注册的外部 API 插件。
/aia plugin [plugin_name] — 查看注册插件挂钩的详细元数据。
通用指令
/ai <message> — 开始或与 AI 继续对话。
/ai data <query> — 在服务器专属知识库中搜索答案。
/ai settings — 打开交互式 GUI 以切换自动摘要和更改上下文。
/ai version 或 /ai v — 查看当前插件版本及其完整更新日志。
/ai version bug — 查看修复模块的更新日志。
/ai version security — 查看安全模块的更新日志。
/ai help — 根据你的权限显示动态帮助菜单。
/ai cache <clear|refresh> — 清除或刷新你自己的对话会话。
/ai memory <clear|refresh> — 总结和管理你自己的 AI 记忆。
/ai confirm <code> — 确认待处理的知识库操作(120 秒后过期)。
/ai opt <in|out> — 切换隐私模式(匿名化姓名/IP 地址 & 阻止附加组件出现在聊天中)。
/ai disable — 立即停用你的管理员模式会话。
API 密钥管理
/ai apikey — 显示设置指南。(输入此指令后,直接在聊天中粘贴你的 API 密钥,或使用 'store-[your_key]' 永久保存)。
/ai apikey list — 列出所有你活跃的会话密钥和永久存储的密钥。
/ai apikey store <projectId> — 使用 ID 永久存储你最后一个会话密钥。
/ai apikey info [all|key-id] — 查看使用统计、错误和回退历史。
/ai apikey model <key-id> <new-model> — 为特定密钥更新 AI 模型。
/ai apikey clear [all|key-id] — 删除特定密钥或清空整个密钥列表。
/ai apikey fallback global <true|false> — 切换失败时回退到服务器密钥。
/ai apikey timer <key-id> remove — 重置密钥的“过载”状态。
/ai apikey msg save <true|false> — 切换对你活跃密钥的聊天日志记录。
/ai apikey context <id|all> <limit> — 设置令牌限制(例如 500, 32k, 128k)。
/ai apikey autosummary <id|all> <on|off> — 按密钥切换自动摘要功能。
/ai apikey autosummary limit <id|all> <%> — 设置摘要的记忆阈值。
聊天管理
/ai chat save <chat-name> — 保存你当前的对话历史记录。
/ai chat list — 列出你所有已保存的对话名称。
/ai chat list [chat-name] — 查看特定对话的所有已保存检查点。
/ai chat resume <chat-name> [checkpoint#] — 在检查点处加载对话。
/ai chat delete <chat-name> — 永久删除整个已保存的对话。
/ai chat delete <chat-name> [checkpoint#|all] — 删除特定或所有检查点。
AI 宠物系统
/ai pet — 查看你当前激活宠物的信息和统计信息。
/ai pet tame — 将你注视的命名宠物链接到 AI 系统。
/ai pet info [pet_name] — 查看宠物的详细统计、情绪和羁绊。
/ai pet nickname <nickname> — 为你链接的宠物设置独特的昵称。
/ai pet inv [pet_name] — 打开你宠物的物品栏。
/ai pet inv allow <pet_name> <player_name> — 授予朋友物品栏访问权限。
/ai pet inv disallow <pet_name> <player_name> — 撤销物品栏访问权限。
/ai pet share <pet_name> [allow] [relationship] — 创建一个 10 分钟的共享链接。
/ai pet link list — 查看你哪些宠物与他人共享。
/ai pet linked list — 查看与你链接的其他玩家拥有的宠物。
/ai pet unlink <宠物名称> — 解除你与别人宠物的关联。
---
### 权限
nsr-ai.use — 允许玩家使用 /ai 命令。(默认:true)
nsr-ai.admin — 允许玩家使用仅限管理员的 AI 命令。(默认:OP)
nsr-ai.reload — 允许玩家重载插件配置。(默认:OP)
nsr-ai.pet — 允许玩家与其宠物互动。(默认:true)
nsr-ai.aia — 允许玩家通过 /aia 管理 AI 附加组件。(默认:true)
---
<details><summary>示例配置 (`config.yml`)</summary>
```yaml
# NSR-AI 配置
admin-activation-code: '' # 留空以自动生成
default-gemini-model: gemini-3.8-flash
default-claude-model: claude-sonnet-5-5
default-openai-model: gpt-4o-mini
default-api-provider: all # 设置为 'all' 以自动检测 API 提供商。
api-keys:
- "YOUR_API_KEY_HERE"
config-version: 2
示例配置 (`features.yml`)
# NSR-AI 功能配置
# AI 和用户聊天消息的自定义颜色。
# 使用 Minecraft 颜色代码(例如 &c 表示红色,&a 表示绿色)。
chat-colors:
ai: '&b' # AI 回复使用浅蓝色
user: '&7' # 用户聊天消息使用灰色
# 显示给玩家的消息
messages:
ai-not-configured: '&cAI 聊天未正确配置。请联系服务器管理员。'
api-error: '&cAPI 错误:无法从 AI 获取响应。请稍后再试。'
permission-denied: '&c我没有权限为你执行该请求。'
no-valid-keys: '&c没有可用的有效 API 密钥。请联系服务器管理员。'
all-keys-rate-limited: '&c所有可用的 API 密钥当前均受速率限制。请稍后再试。'
global-key-fail:
- '&c服务器的 AI 服务暂时不可用。'
- '&c请稍后重试。'
system-prompt: "You are a helpful AI assistant for a Minecraft server. Your answers should be concise and to the point. Prioritize answering questions about Minecraft. Do not provide code snippets or programming advice. If asked for code, respond with the configured message."
# 自动记忆刷新(上下文感知)设置
global-max-context-tokens: 5000 # AI 在自动刷新前能记住的最大上下文令牌数
auto-memory-refresh: # 当玩家的上下文达到限制时,这将自动运行 '/ai memory refresh'。
enabled: true
limit: 20 # 阈值百分比(例如 20 表示当剩余 20% 上下文时刷新)
chat-prefixes:
ai: '&b[AI]'
user: '&7[%player_name%]'
admin-ai: '&c[AI]'
# 代码拦截器设置
code-blocker:
enabled: true
message: "&c这是一个用于娱乐和问答的游戏,不是用于编程的。"
simple-knowledge-yml-approve: false
command-toggles:
data: true # 控制 /ai data 和 /ai data all
admin-disable: true # 控制 /ai admin 和 /ai disable
version: true # 控制 /ai version 和 /ai v
add-confirm: true # 控制 /ai add 及其确认操作
remove-confirm: true # 控制 /ai remove 及其确认操作
reload: true # 控制 /ai reload
memory-clear: true # 控制 /ai memory clear 命令
memory-refresh: true # 控制 /ai memory refresh 命令
cache-clear: true # 控制 /ai cache clear 命令
cache-refresh: true # 控制 /ai cache refresh 命令
# AI 聊天使用的冷却时间设置
chat-cooldown:
enabled: false # 设置为 true 以启用 /ai 命令之间的冷却时间
duration: 5000 # 冷却持续时间,单位为毫秒(1000ms = 1 秒)
目录结构
NSR-AI/
├── addons/
│ ├── addon1.jar
│ └── addon1/
├── adminchathistory/
│ └── playername<uuid>/
│ ├── chat-01-01-2026.log
│ ├── chat-31-01-2026.log
│ └── <savedchatname>/
│ └── checkpoint1.blackforge
├── custom_tools/
│ ├── README.txt
│ ├── ban_abusive_player.js
│ ├── claim_daily_reward.yml
│ └── smart_base_defense.js
├── pets/
│ ├── playername<uuid>/
│ │ ├── chats.yml
│ │ └── data.yml
│ └── reserved_nicknames.yml
├── player_keys/
│ └── <uuid>/
│ ├── projectid.yml
│ ├── master.key
│ └── salt.bin
├── playerchathistory/
│ └── playername<uuid>/
│ ├── chat-18-01-2026.log
│ ├── chat-31-01-2026.log
│ └── <savedchatname>/
│ └── checkpoint1.blackforge
├── security/
│ ├── bug.txt
│ ├── master.key
│ ├── master_secret.conf
│ ├── security.jar
│ └── server.salt
├── summarychat/
│ └── playername<uuid>/
│ └── summary.txt
├── config.yml
├── features.yml
├── knowledge.json
└── privacy.yml
? 支持与开发
如需技术支持、错误报告和功能跟踪,请使用我们的官方开发渠道:
以更智能的玩法驱动你的世界。
由 BlackForge Studio 开发
⚡︎ New Server Runtime – Artificial Intelligence ⚡︎
“The AI Layer for Minecraft Servers.”
✔ Multi-API • ✔ RAG Knowledge • ✔ Simple & Powerful • ✔ Highly Customizable • ✔ Minimal Lag
MC Versions: 1.16.x – 1.26.x • JAR Size: 6.5 MB • AI Models: Gemini, Claude, OpenAI • Autonomous Tool Calling
🌐︎ What is NSR-AI?
NSR-AI (New Server Runtime – Artificial Intelligence) is a high-performance Minecraft AI plugin that acts as intelligent middleware bridging the gap between advanced Large Language Models and the Minecraft server environment. It is more than a simple chat tool; it is an intelligent ecosystem that weaves AI into the very fabric of your world—from automated staff support to emotionally intelligent companions.
🚀︎ Why Choose NSR-AI?
-
Multi-API Sovereignty — You are never locked into one provider. Switch between Gemini, Claude, and OpenAI in real-time.
-
Uncompromising Security — With our Triple-Layer Encryption (AES-256-GCM), your API keys are mathematically locked to your server and player UUIDs.
-
High-Performance Intelligence — Built on an entirely Asynchronous Pipeline, NSR-AI has very minimal impact on your server's TPS.
-
Adaptive Narrative Memory — Through Memory Distillation, your AI remembers your history, your server’s lore, and your players' names.
🛠︎ The Hybrid Intelligence Engine
NSR-AI serves as a multi-role digital infrastructure for your server:
-
24/7 Intelligent Support Agent: Uses RAG (Retrieval Augmented Generation) to provide exact answers from your knowledge.json base, acting as a perfect staff assistant.
-
Emotional Gameplay Companion: Powering the Pet Emotional System with unique moods (HAPPY, FURIOUS, TIRED), bond levels, and unique relationships.
-
Dynamic Content Generator: Generates immersive lore-friendly quest descriptions and dialogue that adapt to each player's specific journey.
-
Privacy-First Player Utility: Allows players to bring their own keys, manage private "checkpoints," and control their own AI environment.
-
Zero-Stall Architecture: Handles complex AI logic in the background, keeping the server's heartbeat at a perfect 20.0 TPS.
-
Extensible Developer Framework: A foundation for growth with a robust Open-Source Addon API via the /aia command portal.
-
Autonomous Action & Tool Execution: Native stream-based tool calling with 10 universal built-in tools (Auto-Crafting, Inventory Inspection & Sorting, Spatial Radar, Anvil Optimizer, Multi-Command Execution, Interactive Approvals) and dynamic runtime custom tools.
🛡︎ Technical Deep Dives
-
Zero-Knowledge Security Standard: Uses three-layer authenticated encryption (AES-256-GCM). Even if your files are stolen, your API keys remain unreadable to anyone else. Filesystem permissions are restricted to owner-only read/write.
-
Context-Aware Memory Distillation: Instead of forgetting, the AI "writes a diary" of your conversation. It summarizes history into a single memory message to keep context alive for thousands of messages.
-
Staff-Free Knowledge Logic (RAG): Turn your knowledge.json into a living database. The system extracts the "intent" of questions to provide the AI with factual "Cheat Sheets," preventing hallucinations.
-
Self-Healing Infrastructure: An automated background system monitors for bugs and applies security patches silently. If one AI provider fails, the system can automatically cycle to a fallback provider.
⚙︎ Core Capabilities
-
Autonomous Function Calling & ReAct Agent Loop — NSR-AI transforms from a passive chat assistant into an autonomous in-game companion, evaluating gameplay state in real-time and executing multi-step actions.
-
10 Native Universal Built-in Tools — Hands-free crafting (auto_craft), inventory GUI inspection (get_inventory), 360° environment radar (get_world_environment), long-term memory pins (pin_knowledge), zero-penalty anvil optimization (anvil_enchant_optimizer), inventory sorting and shulker handling (inv_arrange), multi-command batch execution (execute_command), interactive player approvals (execute_command_with_approval), smart command drafting (draft_command_to_chat), and plugin command discovery (plugin_command_lookup).
-
Dynamic Custom Tools Engine — Create and hot-reload your own custom AI tools without compiling Java JARs. Supports zero-code declarative YAML (.yml), full JavaScript (.js with Nashorn ES6), folder packages, and anti-zip-bomb protected archives (.zip) directly inside plugins/NSR-AI/custom_tools/.
-
Zero-Lag Asynchronous AI Engine — Completely decoupled from the Minecraft main thread, NSR-AI ensures your server maintains 20 TPS even during heavy AI processing and tool executions.
-
Privacy & Anonymization Layer — A robust, opt-in privacy system (/ai opt in) that masks player names and IPs before they reach external AI providers.
-
Developer API & Interceptors — Advanced API allowing addons to intercept and modify player input or AI responses in real-time.
-
Multi-API Integration & Provider Detection — Seamlessly switch between Gemini, Claude, and OpenAI. The system features Automatic Provider Detection for a zero-config setup.
-
Smooth API Key Rotation & Load Balancing — Cycle through up to 20 keys automatically. If a key hits a rate limit, the system intelligently falls back to the next key for zero downtime.
-
Triple-Layer Security Architecture — API keys are protected by AES-256-GCM encryption across the Server Master Key, the Player Master Key, and the Project Key.
-
Advanced Knowledge System (RAG) — Uses Retrieval Augmented Generation and Hybrid Intent Recognition to find precise answers from your lore and facts.
-
AI Pet Emotional System — Tame and link pets with unique personalities, moods, and inventories. Includes a secure system to share pet access with friends.
-
Advanced Memory & Context Awareness — Features AI-powered Summarization and real-time Context Tracking to keep conversations coherent without lag.
-
Master Chat Management — Take complete control of your dialogue history. Save, resume, or delete conversations using /ai chat with Asynchronous Persistent Logging.
-
Professional Admin Mode — Access advanced management tools through a secure code. Deactivate instantly by sneaking in-game or using the dedicated command.
-
Automatic Configuration Encryption — Any plain-text keys added to config.yml are automatically encrypted the moment the plugin reloads, preventing plain-text leaks.
-
User-Friendly Error Handling — Receive clear error messages with actionable solutions to fix issues instantly.
-
Proactive Maintenance & Auto-Fixer — An automated system that monitors, downloads, and applies critical Security Patches and Bug Fixes to keep your server stable.
-
Unified Add-on System (/aia) — A standardized modular framework where every extension like Player Stats or AFK Tracker is managed through the /aia command portal.
-
Sleek UI/UX & AI Awareness — A professional Cyber-Console interface with interactive [Stop], [Edit], and [Regenerate] buttons and animated status indicators.
? What's New in 2.0-pre — The Utility, Automation & Command Mastery Update
NSR-AI v2.0-pre transitions the plugin into a full autonomous in-game companion and command engine with native stream-based tool calling:
? Feature Summary Table
| Feature / Tool |
Function Name |
Primary Purpose |
Key Capabilities |
| ⚒️ Auto-Crafting Engine |
auto_craft |
Hands-free item crafting |
2x2 grid placement, 3x3 workbench queuing, off-hand scanning, smart parent-material breakdown (e.g. Iron Blocks $\rightarrow$ Ingots) |
| ?️ Inventory & Vitals Inspection |
get_inventory |
Slot-by-slot GUI layout inspection |
Player health/hunger vitals, GUI slot layout map (0-40), custom item display names, exact durability stats (remaining/max/%), Shulker Box expansions |
| ? World & Spatial Radar |
get_world_environment |
Real-time environment & navigation radar |
Exact X/Y/Z coords, pitch/yaw, cardinal facing direction, dimension, biome, in-game clock time, weather, block/sky light, mob spawn danger |
| ? Pin Things & Knowledge |
pin_knowledge |
Long-term memory & Auto-RAG pins |
Dual-tier knowledge.json storage: direct personality prompt injection + auto-RAG for pinned waypoints/notes |
| ? Anvil Enchant Optimizer |
anvil_enchant_optimizer |
Zero-penalty anvil sequencing |
Binary merge tree algorithm, total XP calculation, horizontal flowcharts, and animated 500ms auto-combine sessions |
| ? Inventory Management |
inv_arrange |
Grid sorting, stacking & item handling |
Top-left to bottom-right slot sorting (9-35), hotbar stack merging (0-35), hotbar staging (0-8), armor auto-equipping/unequipping, Shulker packing & unpacking, item dropping |
| ⚡ Multi-Command Executor |
execute_command |
Autonomous command execution |
Semicolon/newline multi-command batching, quote-aware parsing, structured JSON results array, OP utility exemption rules |
| ? Command Approvals |
execute_command_with_approval |
State-modifying security guard |
Interactive chat buttons ([✅ APPROVE] / [❌ CANCEL]), atomic execution, 60s expiration timeout, economy security guard |
| ✏️ Smart Command Drafter |
draft_command_to_chat |
Interactive chat pre-typing |
Clickable SUGGEST_COMMAND chat components that pre-type corrected commands into player chat input bars |
| ? Plugin & Command Lookup |
plugin_command_lookup |
Server command discovery |
Dynamic runtime scanning of installed server plugins, registered commands, aliases, and Bukkit help topics |
| ? Universal Stream Adapter |
StreamProviderAdapter |
Multi-LLM stream normalization |
Multi-chunk SSE argument accumulation for Anthropic Claude (input_json_delta), OpenAI, and Google Gemini backends |
| ? Dynamic Custom Tools Engine |
CustomToolManager |
Modular standalone extensibility |
Zero-code YAML (.yml), JavaScript (.js), Folder Packages (index.js), and Anti-Zip-Bomb protected ZIPs (.zip) with live /ai tools reload |
?️ How to Create Custom Tools Guide
To learn how to create, configure, and code custom tools step-by-step, click on this button:
? Direct URL:
🚀︎ How to Setup
-
Download: Get the latest stable version of NSR-AI.
-
Install: Place the downloaded .jar file into your server's /plugins folder.
-
Configure: Start your server once to generate the files. Then, open config.yml located in the /plugins/NSR-AI/ folder and add your API key to the api-keys list.
-
Reload & Go: Start or reload your server. You're all set!
? The BlackForge Studio AI Ecosystem Combo ?
Turn your server into an interactive, breathing, and responsive world with our three-part AI Ecosystem Combo. These plugins work hand-in-hand to create an unparalleled gameplay experience:
-
NSR-AI Core Engine: The foundation and brain of the server. A high-performance, asynchronous, multi-API Minecraft AI plugin featuring triple-layer encryption, memory distillation, and RAG knowledge base.
-
Advanced Player Stats 3.0 (APS): A standalone analytics engine that hooks into the NSR-AI API. Features Recursive AI Reasoning—the AI can "think" and request player stats (kills, deaths, playtime, bow accuracy, shield blocks, or even chat message length) and invisibly scan inventories to answer player queries (e.g., "Compare the top 3 players' bow accuracy" or "How am I doing?").
-
ChatBuddy 1.0 (CB): A spontaneous, autonomous chat companion. Unlike bots that only speak when commanded, ChatBuddy reads chat and autonomously jumps in using fuzzy keyword matching and Levenshtein distance. Integrates directly with player stats, player death events (with witty remarks), and achievements!
Get all three and build a fully automated, immersive roleplay or support companion setup that will blow your players away!
📜︎ Commands
Admin Commands
/ai admin <activation_code> — Toggle admin mode for advanced features.
/ai admincode — View your private activation code (Requires OP).
/ai data all <page> — Paginated display of all entries stored in the knowledge base.
/ai add <keyword>, <message_content> — Add a new entry (Requires confirmation).
/ai remove <keyword> — Remove a specific entry from the knowledge base.
/ai reload [f|features|nsr-ai|k|knowledge|c|config] — Reload specific plugin components (OP players bypass Admin Mode).
/ai cache <clear|refresh> <player|all> — Manage session history for other players.
/ai memory <clear|refresh> <player|all> — Manage conversation memory for other players.
/ai tools — Display all registered native universal tools and custom tools with live status and version.
/ai tools <name> — Inspect detailed metadata, author, version, type, description, and parameter schema.
/ai tools reload — Hot-reload all custom tools from plugins/NSR-AI/custom_tools/ with zero server downtime.
/ai reload tools — Unified command to hot-reload custom tools from the main reload handler.
/ai migrate — Automatically transfer and backup data from legacy YAML to JSON formats.
/aia addon — List all installed addons and their status (Active/Banned/Error/Inactive).
/aia addon [addon_name] — View version, author, and description for an addon.
/aia plugin — List all registered external API plugins.
/aia plugin [plugin_name] — View detailed metadata for a registered plugin hook.
General Commands
/ai <message> — Start or continue a conversation with the AI.
/ai data <query> — Search the server-specific knowledge base for answers.
/ai settings — Open the interactive GUI to toggle Auto-Summary and change Context.
/ai version or /ai v — View the current plugin version and its full changelog.
/ai version bug — View the changelog for the bug fix module.
/ai version security — View the changelog for the security module.
/ai help — Display the dynamic help menu based on your permissions.
/ai cache <clear|refresh> — Clear or refresh your own conversation session.
/ai memory <clear|refresh> — Summarize and manage your own AI memory.
/ai confirm <code> — Confirm a pending knowledge base action (expires in 120 seconds).
/ai opt <in|out> — Toggle privacy mode (Anonymize names/IPs & block addons from chat).
/ai disable — Instantly deactivate your admin mode session.
API Key Management
/ai apikey — Display the setup guide. (Type this command, then paste your API key directly in chat, or use 'store-[your_key]' to save it permanently).
/ai apikey list — List all your active session and permanent stored keys.
/ai apikey store <projectId> — Permanently store your last session key with an ID.
/ai apikey info [all|key-id] — View usage stats, errors, and fallback history.
/ai apikey model <key-id> <new-model> — Update the AI model for a specific key.
/ai apikey clear [all|key-id] — Delete specific keys or wipe your entire key list.
/ai apikey fallback global <true|false> — Toggle fallback to server keys on failure.
/ai apikey timer <key-id> remove — Reset the "Overloaded" status for a key.
/ai apikey msg save <true|false> — Toggle logging of chats for your active key.
/ai apikey context <id|all> <limit> — Set token limit (e.g., 500, 32k, 128k).
/ai apikey autosummary <id|all> <on|off> — Toggle auto-summarization per key.
/ai apikey autosummary limit <id|all> <%> — Set memory threshold for summary.
Chat Management
/ai chat save <chat-name> — Save your current conversation history.
/ai chat list — List all your saved conversation names.
/ai chat list [chat-name] — View all saved checkpoints for a specific conversation.
/ai chat resume <chat-name> [checkpoint#] — Load a conversation at a checkpoint.
/ai chat delete <chat-name> — Permanently delete an entire saved conversation.
/ai chat delete <chat-name> [checkpoint#|all] — Delete specific or all checkpoints.
AI Pet System
/ai pet — View information and stats for your currently active pet.
/ai pet tame — Link a named pet you are looking at to the AI system.
/ai pet info [pet_name] — View detailed stats, mood, and bond for a pet.
/ai pet nickname <nickname> — Set a unique nickname for your linked pet.
/ai pet inv [pet_name] — Open your pet's inventory.
/ai pet inv allow <pet_name> <player_name> — Grant inventory access to a friend.
/ai pet inv disallow <pet_name> <player_name> — Revoke inventory access.
/ai pet share <pet_name> [allow] [relationship] — Create a 10-minute share link.
/ai pet link list — View which of your pets are shared with others.
/ai pet linked list — View pets owned by other players you are linked with.
/ai pet unlink <pet_name> — Remove your connection to someone else's pet.
Permissions
nsr-ai.use — Allows players to use the /ai command. (Default: true)
nsr-ai.admin — Allows players to use admin-specific AI commands. (Default: OP)
nsr-ai.reload — Allows players to reload the plugin configuration. (Default: OP)
nsr-ai.pet — Allows players to interact with their pets. (Default: true)
nsr-ai.aia — Allows players to manage AI addons via /aia. (Default: true)
Example Configuration (`config.yml`)
# NSR-AI Configuration
admin-activation-code: '' # Leave blank to auto-generate
default-gemini-model: gemini-3.8-flash
default-claude-model: claude-sonnet-5-5
default-openai-model: gpt-4o-mini
default-api-provider: all # Set to 'all' for automatic provider detection.
api-keys:
- "YOUR_API_KEY_HERE"
config-version: 2
Example Configuration (`features.yml`)
# NSR-AI Feature Configuration
# Custom colors for AI and user chat messages.
# Use Minecraft color codes (e.g., &c for red, &a for green).
chat-colors:
ai: '&b' # Light blue for AI responses
user: '&7' # Gray for user's chat messages
# Messages displayed to players
messages:
ai-not-configured: '&cThe AI chat is not configured correctly. Please contact the server owner.'
api-error: '&cAPI Error: Could not get a response from the AI. Please try again later.'
permission-denied: '&cI don''t have permission to fulfill that request for you.'
no-valid-keys: '&cThere are no valid API keys available. Please contact the server owner.'
all-keys-rate-limited: '&cAll available API keys are currently rate-limited. Please try again later.'
global-key-fail:
- '&cThe server''s AI service is temporarily unavailable.'
- '&cPlease try again in a few moments.'
system-prompt: "You are a helpful AI assistant for a Minecraft server. Your answers should be concise and to the point. Prioritize answering questions about Minecraft. Do not provide code snippets or programming advice. If asked for code, respond with the configured message."
# Auto Memory Refresh (Context Awareness) settings
global-max-context-tokens: 5000 # Maximum tokens the AI can remember in context before auto-refresh
auto-memory-refresh: # This will automatically run '/ai memory refresh' when the player's context reaches the limit.
enabled: true
limit: 20 # Threshold percentage (e.g., 20 means it refreshes when 20% context remains)
chat-prefixes:
ai: '&b[AI]'
user: '&7[%player_name%]'
admin-ai: '&c[AI]'
# Code Blocker settings
code-blocker:
enabled: true
message: "&cThis is a game built for fun and answering, not for coding."
simple-knowledge-yml-approve: false
command-toggles:
data: true # Controls /ai data and /ai data all
admin-disable: true # Controls /ai admin and /ai disable
version: true # Controls /ai version and /ai v
add-confirm: true # Controls /ai add and its confirmation
remove-confirm: true # Controls /ai remove and its confirmation
reload: true # Controls /ai reload
memory-clear: true # Controls /ai memory clear command
memory-refresh: true # Controls /ai memory refresh command
cache-clear: true # Controls /ai cache clear command
cache-refresh: true # Controls /ai cache refresh command
# Cooldown settings for AI chat usage
chat-cooldown:
enabled: false # Set to true to enable a cooldown between /ai commands
duration: 5000 # Cooldown duration in milliseconds (1000ms = 1 second)
Directory Tree
NSR-AI/
├── addons/
│ ├── addon1.jar
│ └── addon1/
├── adminchathistory/
│ └── playername<uuid>/
│ ├── chat-01-01-2026.log
│ ├── chat-31-01-2026.log
│ └── <savedchatname>/
│ └── checkpoint1.blackforge
├── custom_tools/
│ ├── README.txt
│ ├── ban_abusive_player.js
│ ├── claim_daily_reward.yml
│ └── smart_base_defense.js
├── pets/
│ ├── playername<uuid>/
│ │ ├── chats.yml
│ │ └── data.yml
│ └── reserved_nicknames.yml
├── player_keys/
│ └── <uuid>/
│ ├── projectid.yml
│ ├── master.key
│ └── salt.bin
├── playerchathistory/
│ └── playername<uuid>/
│ ├── chat-18-01-2026.log
│ ├── chat-31-01-2026.log
│ └── <savedchatname>/
│ └── checkpoint1.blackforge
├── security/
│ ├── bug.txt
│ ├── master.key
│ ├── master_secret.conf
│ ├── security.jar
│ └── server.salt
├── summarychat/
│ └── playername<uuid>/
│ └── summary.txt
├── config.yml
├── features.yml
├── knowledge.json
└── privacy.yml
? Support & Development
For technical support, bug reporting, and feature tracking, please use our official development channels:
Powering your world with smarter gameplay.
Developed by BlackForge Studio
评论 0
登录后参与评分
还没有评论,来抢沙发吧