与NPC聊天

Chat-with-NPC

该模组仍处于公开测试阶段，如果发现任何问题请提交 issue。如果你想使用最新版本，请自行编译源代码，参见 构建。

中文版本

1. 简介

Chat With NPC 允许玩家与 NPC 自由聊天，NPC 会根据其设置（基础提示词）以及所属分组（国家、城市、城镇等）的设置来回答问题。适用于 RPG 地图或解谜地图。NPC 不会改变游戏规则（如果你不使用高级功能）。如果你定义了相应内容，NPC 还可以根据聊天内容执行一些动作。

在未来的版本中，我们将添加创新功能，例如 NPC 之间互相聊天、NPC 对事件的观点等，使同一分组内的 NPC 可以相互互动。

2. 使用方法

如果 NPC 已被 OP 注册，任何玩家都可以通过按住 Shift 并点击 NPC 来与其对话。随后 NPC 会向玩家打招呼。

NPC 的发言可以被所有人看到（显示在其头顶的聊天气泡中），也可以被 NPC 周围一定范围内的玩家看到（显示在聊天栏中）。

附近的任何玩家都可以直接在聊天栏中回复 NPC（如果玩家附近有多个 NPC，则会回复最近的 NPC）。

如果你是管理员，请参阅安装了解更多信息。

3. 功能

1. 每个 NPC 都有自己的 Instructions（指令说明），并且可以属于一个 Group（分组）。
2. 每个 NPC 会通过 OpenAI 自动管理自己的对话上下文。
3. 每个 Group 也有自己的 Instructions 来描述它们，并且还可以记录一些易于更改的 Event（事件）。
4. 每个 Group 可以记录一个 ParentGroup（父分组），直到该分组的父分组为 Global，Global 不能有父分组。
5. 每个 NPC 的对话会结合他自己的 Instructions、本次对话的上下文（如果需要记忆则为所有对话）、他的 Group 及其所有 ParentGroup 的 Intructions，以及 Event 的内容。
6. 你可以定义 NPC 在对话中可以调用的 Functions（函数）。

4. 要求

• Minecraft 服务器 1.19.4 或更高版本
• Fabric Loader 0.12.0 或更高版本
• 包含 Fabric API

5. 安装

1. 将模组安装到 mods 文件夹后，从此处获取你的 OpenAI API 密钥，并使用 /npchat setkey <key> 命令进行设置。
2. 你可以使用命令中的命令来设置模组的基本配置。
3. 关于注册 NPC，请阅读 RegisterNPC。
4. 关于注册分组，请阅读 RegisterGroup。
5. 了解模组的配置，请阅读 Configuration。
6. 如果你想使用一些高级功能，请阅读 Advanced。

6. 命令

• /npchat - 查看配置状态
• /npchat help - 查看命令帮助
• /npchat enable/disable - 启用/禁用模组
• /npchat setKey <key> - 设置 OpenAI API 密钥
• /npchat setModel <model> - 设置 AI 模型
• /npchat setRange <range> - 设置对话范围
• /npchat setLanguage <language> - 设置回复语言
• /npchat setWordLimit <wordLimit> - 设置回复的字数限制
• /npchat setURL <url> - 设置 OpenAI API 代理 URL
• /npchat saveAll - 将所有数据保存到磁盘
• /npchat setChatBar <true/false> - 设置是否在左下角聊天栏显示对话，true 为显示，false 为隐藏。
• /npchat setBubble <true/false> - 设置是否在我们可爱的 NPC 上方显示对话气泡，true 为显示，false 为隐藏。
• /npchat setBubbleStyle Color <color preset> - 设置字体和背景的预设颜色。
• /npchat setBubbleStyle timeLastingPerChar <time> - 设置每个字符持续的时间，单位为秒。例如，将时间设置为 1.5 秒意味着 6 个字符的句子其气泡将显示总共 9 秒。

7. 待办列表

• 改进聊天气泡。
• NPC 之间互相聊天并交流他们对事件的观点。（参见高级）
• NPC 对他们 Group 中的每个事件都有自己的观点。
• NPC 根据聊天内容执行动作。（参见高级）

8. 构建

• AIMobs，作者 rebane2001 和 Eianex