NSR-AI

插件

· 作者 BlackForge

Gemini + ChatGPT 驱动的 Minecraft AI 聊天:快速、智能且对服务器友好

0 本站下载 0 关注 更新于 2 周前

最新 2.0-pre · 26.3 · Bukkit / Paper

一键开服(送7天)

⚡︎ 全新服务器运行时 – 人工智能 ⚡︎

“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 为你的服务器提供多功能数字基础设施:

  1. 7x24 小时智能支持代理: 使用 RAG(检索增强生成) 从你的 knowledge.json 库中提供精确答案,充当完美的员工助手。

  2. 情感化游戏同伴: 通过独特的 mood(情绪)(HAPPY, FURIOUS, TIRED)、羁绊等级和独特关系来驱动 宠物情感系统。

  3. 动态内容生成器: 生成沉浸式的符合 lore 的任务描述和对话,并根据每个玩家的具体旅程进行调整。

  4. 隐私优先的玩家实用程序: 允许玩家自带密钥,管理私有的“检查点”,并控制自己的 AI 环境。

  5. 零停滞架构: 在后台处理复杂的 AI 逻辑,使服务器的心跳保持在完美的 20.0 TPS。

  6. 可扩展的开发框架: 一个用于增长的基础,通过 /aia 命令门户提供强大的 开源附加组件 API。

  7. 自主操作与工具执行: 原生基于流的工具调用,带有 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

?️ 如何创建自定义工具指南

要了解如何逐步创建、配置和编码自定义工具,请点击此按钮:

? 直接链接:


🚀︎ 设置指南

  1. 下载: 获取 NSR-AI 的最新稳定版本。

  2. 安装: 将下载的 .jar 文件放入服务器的 /plugins 文件夹中。

  3. 配置: 启动服务器一次以生成文件。然后,打开位于 /plugins/NSR-AI/ 文件夹中的 config.yml,并在 api-keys 列表中添加你的 API 密钥。

  4. 重载并开始: 启动或重载服务器。一切就绪!


? BlackForge Studio AI 生态系统组合 ?

通过我们的三部分 AI 生态系统组合,将你的服务器变成一个互动、生动且响应迅速的世界。这些插件协同工作,创造出无与伦比的游戏体验:

  1. NSR-AI Core Engine:服务器的基石与大脑。这是一款高性能、异步、支持多 API 的 Minecraft AI 插件,具备三层加密、记忆蒸馏和 RAG(检索增强生成)知识库功能。

  2. Advanced Player Stats 3.0 (APS):一个独立分析引擎,可接入 NSR-AI API。具有 递归 AI 推理 功能——AI 能够“思考”并请求玩家统计数据(如击杀数、死亡数、游戏时长、弓术命中率、盾牌格挡次数,甚至聊天消息长度),同时无声地扫描物品栏以回答玩家的查询(例如:“比较前三名玩家的弓术命中率” 或 “我表现如何?”)。

  3. 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 开发

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源