第二大脑

第二大脑

一个 Fabric 模组，为你的 Minecraft 世界带来智能 NPC。创建由大语言模型控制、类似玩家的角色，它们能回应你的聊天消息并执行基本的玩家操作。

此模组完全在服务端运行，但客户端也必须安装以进行设置。

前置要求

• Minecraft 版本：1.20.1/1.21.1
• 运行中的 Ollama 服务器或 Player2 应用或 OpenAI API 密钥

模组安装

1. 下载模组：
   • 从 Modrinth 页面获取最新版本的 SecondBrain 模组。
2. 安装模组：
   • 将 secondbrain.jar 放入你的 Minecraft Fabric 服务器和客户端的 mods 文件夹中。
3. 启动 Minecraft：
   • 启动 Minecraft 客户端和服务器，即可使用！

与 Ollama/OpenAI 一起使用

注意：玩家必须是管理员才能执行以下命令

图形界面

• 使用 /secondbrain 命令打开图形界面，在此创建/生成、移除/删除或编辑 NPC。
• 也可以在此编辑基础配置。

命令（已弃用）

警告：此命令使用默认的 ollama/openai 设置！

1. 生成 NPC：
   • 使用 /secondbrain add <npc名字> <openai|ollama> 命令创建 NPC（目前仅支持 ollama）。（示例：/secondbrain add sailex428 OLLAMA）
2. 移除 NPC：
   • 使用 /secondbrain remove <npc名字> 命令从游戏世界中移除 NPC。

与 NPC 互动：

• 只需在聊天中发送消息即可与 NPC 互动。

设置 Ollama

Ollama（本地大语言模型）

1. 下载 Ollama：

   • 访问 Ollama 官网，下载适用于你操作系统的安装程序。

2. 安装并运行 Ollama：

   • 按照安装说明进行安装。
   • 启动 Ollama，并确保其在后台运行。

3. 连接至模组：

   • 使用图形界面创建/编辑 NPC，并输入你的 ollama 服务器地址（包含 http:// 的完整 URL；如果你在本地电脑上运行 ollama，直接使用已填入的地址即可）。

设置 OpenAI（付费）

1. 创建 API 密钥
   • 访问 OpenAI 官网，注册/登录并创建 API 密钥。
   • 复制创建的密钥。
2. 在模组中使用密钥
   • 打开图形界面，创建一个 LLM 类型为 OPENAI 的 NPC，并将密钥粘贴到密钥字段中。（密钥绝不会与任何有权访问图形界面的其他客户端共享，包括你的客户端。它会被保存在服务器上的 secondbrain 配置文件中。）

与 Player2 App 一起使用

模组会自动将 Player2 App 中选中的角色同步为你的单人游戏世界中的 NPC。 如果你更新了 Player2 App 中的描述/名字，可以使用 /secondbrain player2 SYNC 命令同步这些更改。 此模组无法更改角色的任何配置。

与 NPC 互动

• 在聊天中发送消息，或直接发送给特定 NPC
• 按住 alt（Windows）或 opt（macOS）键直接与 LLM/AI 对话
• 在配置图形界面中为任意 NPC 激活文本转语音，以听到 LLM/AI 的输出

设置 Player2（免费，有限制）

1. 下载 Player2 App

   • 访问 player2 官网，下载适用于你操作系统的 App。

2. 启动 App 并选择角色

   • 启动下载的 App，并选择你要用作 NPC 的角色。

许可证

本项目基于 LGPL-3.0 许可证授权。

免责声明

致谢

本项目使用了以下项目的组件：

• fabric-carpet
• automatone
• player2

感谢这些项目的开发者们所做的出色工作！