NPC引擎

NPC Engine

适用于 Minecraft 1.21.9+ 的交互式 NPC 系统，带有对话功能

NPC Engine 是一个数据包，用于创建带有对话系统、回复选项和电影级摄像机的 NPC。

---

🎯 功能

NPC

• 人偶（Mannequins） — 基于 minecraft:mannequin 的 NPC，支持自定义皮肤
• 其他实体 — 村民、僵尸、骷髅等
• 交互性 — 点击 NPC 即可开始对话
• 可视化编辑器 — 通过动作栏进行控制

对话

• 打字机效果 — 平滑的逐字显示
• 选择系统 — 带有多个回答选项的分支对话
• 导航 — 按下 Shift 跳到下一行
• 文本显示 — 文本显示在 NPC 上方

摄像机

• 电影模式 — 自动放大聚焦到 NPC
• 定位 — 摄像机位于 NPC 的侧面
• 平滑过渡 — 对话开始/结束时带有失明效果
• 恢复 — 自动将玩家返回到起始位置

---

🚀 安装

1. 将 npcs-engine 文件夹放入你世界的 datapacks 目录中
2. 运行 /reload

---

📋 使用方法

打开编辑器

/function _npsc:open

编辑器操作

• 鼠标滚轮 — 浏览菜单
• 右键（钓鱼竿上的胡萝卜） — 选择项目

编辑器菜单

项目	描述
📝 创建 NPC	创建一个新的 NPC
📋 列表	查看所有 NPC
💬 对话	对话编辑器
🎬 对话测试	运行一次对话测试
❌ 退出	关闭编辑器

与 NPC 交互

• 点击 NPC 开始对话
• Shift — 下一行
• 对话在最后一行后自动结束

---

🔧 开发者 API

创建一个 NPC

# 创建一个 mannequin NPC
function npcs:npc/create_player

# 创建一个 NPC 实体
function npcs:npc/create_entity

对话管理

# 添加一行对话
function npcs:dialog/editor/add_line {npc_id:1,text:"Hello, traveler!"}

# 添加一个选择
function npcs:dialog/editor/add_choice {npc_id:1,text:"Where shall we go?",choices:["North","South"]}

# 以编程方式开始对话
function npcs:dialog/start_play

数据存储

• 存储 npcs:data — NPC 和对话数据
• 存储 npcs:current_dialog — 当前激活的对话

---

📋 要求

• Minecraft：1.21.9+
• 权限：执行编辑器命令需要管理员权限

---

🎮 示例：任务 NPC

# 1. 创建一个 NPC
function npcs:npc/create_player

# 2. 添加对话（npc_id = 1）
function npcs:dialog/editor/add_line {npc_id:1,text:"Greetings, hero!"}
function npcs:dialog/editor/add_line {npc_id:1,text:"I have something for you" task."}
function npcs:dialog/editor/add_choice {npc_id:1,text:"Will you accept it?",choices:["Of course!","Not now"]}

---

使用 NPC Engine 创造栩栩如生的世界！ 💬✨