Nexa AI 聊天

Nexa AI 聊天

该Mod/插件将Nexa Ai Agent引入Minecraft。你在Minecraft中的伙伴！可通过聊天访问。你可以随时与它交谈，甚至让它执行行动。它掌握了你和环境的所有背景信息，所以当它说话时，你最好听着。

自动化

Nexa AI 聊天预览查看大图

Nexa AI（我的世界模组 + Paper 插件）

[!注意] 此页面包含模组/插件的详细信息。如果内容过多，您可以直接跳过并开始使用。只需安装模组/插件并运行命令 /nexa <消息> 即可快速上手。

Nexa AI 为我的世界添加了一个 AI 智能体。

  • 作为一个 Fabric / Forge / NeoForge 模组（客户端 + 服务端）运行
  • 也可作为 Paper 插件 使用，下载地址： 插件 Nexa AI

玩家可以在聊天中与 Nexa 对话，并且（在拥有相应权限的情况下）让它运行服务器工具，例如传送、定位结构、更改天气/时间等。

功能特性

  • 直接与 Nexa 聊天： /nexa <消息>
  • 智能体模式：
    • 执行前询问（默认）：特权操作会先预览，并需要确认后才能执行。
    • 自动执行：Nexa 可以自动执行允许的操作步骤（护栏规则仍然生效）。
  • 服务器护栏： 每位玩家的请求限制 + 全局工具冷却时间。
  • 自定义选项： 自定义助手名称 + 个性提示词。
  • 客户端界面： 按下 N 键或使用命令 /nexa-gui / /nex-gui 打开配置和聊天界面（Fabric/Forge/NeoForge 客户端）。
  • 内置工具（“函数调用”）： 服务端感知操作、环境查询和截图分析。
  • 自动消息： 可选的加入问候语 + 偶尔的空闲消息（服务器全局，可禁用）。
  • 更新通知与反馈： 检查更新并通过安全代理发送反馈。

支持的平台

  • Fabric：我的世界 26.2
  • Forge：我的世界 26.2
  • NeoForge：我的世界 26.2
  • Paper：我的世界 26.1.2 - 26.2+

所有平台共享一个基于 Java 25 兼容性编译的通用核心。

命令

聊天

  • /nexa <消息> — 与 Nexa 聊天。
  • /nexa confirm — 批准待执行的操作（执行前询问模式）。
  • /nexa cancel — 取消待执行的操作。

客户端界面

  • /nexa-gui（或 /nex-gui）— 打开配置界面（仅限 Fabric、Forge 和 NeoForge 客户端）。

配置 (/nex-config)

  • /nex-config clearchat — 清除您的聊天记录。
  • /nex-config feedback <消息> — 发送反馈（限每 24 小时一次）。
  • /nex-config mode show — 显示您当前的智能体模式。
  • /nex-config mode <ask|autonomous> — 设置您的个人智能体模式偏好。
  • /nex-config limits status — 显示限制和冷却时间。
  • /nex-config limits maxrequests <1..15> — 设置每个提示的最大请求数（需要管理员/OP 权限）。
  • /nex-config limits cooldown <秒> — 设置全局工具冷却时间（需要管理员/OP 权限）。
  • /nex-config custom name <名称> — 更改助手名称（需要管理员/OP 权限，最多 30 个字符 / 3 个词）。
  • /nex-config custom prompt <提示词> — 设置个性提示词（需要管理员/OP 权限，最多 1000 个字符）。
  • /nex-config custom reset — 将名称/提示词重置为默认值（需要管理员/OP 权限）。
  • /nex-config custom show — 查看您当前的自定义设置。
  • /nex-config automessages enable|disable|status — 切换加入/空闲自动消息（服务器全局）。

BYOK（自带密钥）

BYOK 是 按玩家 生效的，并且绕过默认代理进行聊天调用。

  • /nex-byok status — 显示 BYOK 当前状态。
  • /nex-byok toggle enable|disable — 启用/禁用 BYOK。
  • /nex-byok provider <google|openai|ollama|lmstudio|custom> — 选择提供商。
  • /nex-byok apikey <密钥> — 设置 API 密钥（云提供商必需）。
  • /nex-byok endpoint <url|default> — 设置端点 URL（用于本地/自定义提供商，或使用 default 重置）。
  • /nex-byok model <名称> — 设置模型名称。
  • /nex-byok tools enable|disable — 启用/禁用工具调用（主要用于本地端点）。
  • /nex-byok test — 测试当前 BYOK 配置并检查连接。

模式

执行前询问

Nexa 会提出一个操作预览，并在运行任何特权工具之前等待确认。可以通过聊天中的可点击按钮（[是] / [否]）或运行 /nexa confirm 批准（运行 /nexa cancel 拒绝）。排队超时时间为 30 秒。

自动执行

Nexa 可以在没有明确提示的情况下执行允许的工具。护栏规则仍然适用（冷却时间、请求限制和所需的权限）。

AI 提供商与 BYOK 配置

默认 AI 服务

默认情况下，Nexa 使用默认服务。它是免费的，但您可能会遇到速率限制、过载等情况。建议使用 BYOK 以获得最佳性能。

BYOK 模式

BYOK（自带密钥）允许每位玩家使用自己的提供商和密钥：

  • Google Gemini：默认端点 https://generativelanguage.googleapis.com/v1beta，默认模型 gemini-2.5-flash-lite（支持工具调用）。
  • OpenAI：默认端点 https://api.openai.com/v1，默认模型 gpt-5-chat-latest（支持工具调用）。
  • Ollama（本地）：默认端点 http://localhost:11434/v1（无需 API 密钥，自定义模型，工具调用开关）。
  • LM Studio（本地）：默认端点 http://localhost:1234/v1（无需 API 密钥，自定义模型，支持工具调用）。
  • 自定义：完全兼容 OpenAI 的自定义端点，自定义模型（支持工具调用）。

注意：BYOK 设置（包括 API 密钥）会安全地存储在服务器世界数据文件中。

Nexa 工具（函数调用）

Nexa 可以根据玩家的权限调用内置工具：

无特权工具（所有玩家可用）

  • getPlayerState：获取当前玩家的详细信息（位置、生命值、游戏模式、维度、难度、上次死亡位置）。
  • getInventorySummary：检查您的背包、主手/副手物品和盔甲栏的内容。
  • getEnvironmentInfo：获取当前环境条件（时间、天气、生物群系、朝向、难度、维度）。
  • getGameRules：读取服务器游戏规则的数值（例如 keepInventory、doDaylightCycle）。
  • getNearbyEntities：扫描半径 48 格内的实体（生物、玩家）。
  • saveLocation：将您当前坐标保存为自定义命名的位置。
  • removeLocation：移除一个已保存的位置或清除所有已保存的位置。
  • listSavedLocations：查看您所有已保存的位置及其坐标。
  • getAgentContext：查看 Nexa 当前的操作模式、服务器默认设置、护栏和权限。
  • analyzeScreenshot：截取客户端屏幕截图以视觉分析游戏状态（当客户端安装了模组时可用）。

特权工具（需要 nexa.admin / OP 状态）

  • locate（即使在执行前询问模式下也立即执行）：查找结构（例如村庄）或生物群系的坐标。
  • teleport（在执行前询问模式下排队）：传送到特定坐标。
  • timeSet（在执行前询问模式下排队）：设置服务器时间（预设如 day/noon/night/midnight 或数字刻数）。
  • weather（在执行前询问模式下排队）：更改服务器天气（clear、rain、thunder）并指定持续时间。
  • giveEffect（在执行前询问模式下排队）：应用状态效果，可自定义持续时间、放大倍数和粒子效果。
  • spawnEntity（在执行前询问模式下排队）：在您的位置或指定坐标生成特定实体（猪、僵尸等，最多 10 个实体）。

权限与特权

Nexa 集成了 LuckPerms 以在 Fabric、Forge、NeoForge 和 Paper 上进行精细权限控制。

权限节点

  • nexa.use — 访问 /nexa、/nex-config、/nex-byok 和 /nexa-gui（默认：所有玩家允许）。
  • nexa.admin — 管理操作（修改限制/冷却时间、自定义提示词、特权工具、服务器全局更改）。

原版后备机制（无 LuckPerms 时）

  • nexa.use 所有玩家均可访问。
  • nexa.admin 在专用服务器上回退到 OP / 游戏管理员权限，在单人游戏中回退到创造模式。

要求与安装

Java

  • 我的世界 26.2：通常需要 Java 25 运行。

安装

  • Fabric：安装 Fabric Loader + Fabric API，然后将 nexa-fabric*.jar 放入 .minecraft/mods/ 文件夹。
  • Forge：将 nexa-forge*.jar 放入 .minecraft/mods/ 文件夹。
  • NeoForge：将 nexa-neoforge*.jar 放入 .minecraft/mods/ 文件夹。
  • Paper：将 nexa-paper*.jar 放入 plugins/ 文件夹并重启服务器。

*提示：仅安装服务器 jar 即可使用服务端功能。安装客户端模组可启用界面（按键绑定 N）和截图分析。*

护栏（服务器）

  • 智能体模式：ASK_BEFORE_ACT 或 AUTONOMOUS
  • 每个提示的请求预算 (maxrequests) 和全局冷却时间 (cooldown)
  • 特权操作在“执行前询问”模式下会进行预览（并且可以被拒绝）。

合理使用、安全与隐私

  • 社区构建：请不要滥用默认服务（速率限制/护栏的存在是有原因的）。
  • AI 提供商条款：默认服务的提示/响应由 Google Gemini 处理。使用 BYOK 时，适用您所选提供商的条款。
  • 数据与安全：设置和 BYOK API 密钥按世界保存在 chatmc_locations.json 中。只向可信的个人授予服务器文件访问权限。
  • 反馈：通过 /nex-config feedback 提交的反馈消息会连同识别元数据一起发送到代理。

支持与贡献

如果您遇到问题、有反馈或希望贡献，请加入我们的 Discord 服务器。

Discord： https://discord.gg/Wvst4znsgk