NPC Workshop

官方合作伙伴

我们很荣幸与 Kinetic Hosting 合作，他们帮助支持本模组的持续开发。确实是一家价格优惠、支持到位的好主机商。

# NPC Workshop – 一个全能 jar：NPC 制作器、对话编辑器、任务系统、商店、传说书与图书馆、声望与记忆、NPC 闲聊、礼物、语音、日常作息、世界生成、过场动画命令、供编辑者使用的地图、游戏内指南，以及 5,500+ 行可直接使用的 NPC 对话，或从头创建你自己的对话。无需附加组件，无需前置库模组，无需安装其他任何东西。

✦ 设计一个世界，而不只是一个存档

大多数 NPC 工具会把你的工作绑定到一张地图上。NPC Workshop 不会。你构建你的角色、他们的故事以及他们居住地的规则——之后创建的每个世界都会自动填充他们。

**在游戏内构建你自己的 NPC。** 按 **N** 打开工坊：皮肤、行为、对话、任务、商店、传说书、性格、声望与生成——全在菜单中。无需 JSON，无需数据包，无需代码。

NPC Workshop 专为**整合包作者、地图作者和服务器服主**打造，他们想要一个感觉有人居住的世界：有名字和故事的村民、记得你所作所为的守卫、一旦信任你就会给你更好价格的商人，以及出现在你尚未探索的废墟中的陌生人。

每位玩家还会获得一本**游戏内指南书**，逐章解释一切，并带有搜索框。

—

– ✦你可以构建什么

一个活生生的村庄——一个开商店的铁匠、一个白天巡逻晚上回家的守卫、议论玩家的邻居，以及一旦城镇信任你就会降低的价格。
一条横跨地图的任务链——一封要送到下一个城镇的信、一把为地穴交付的钥匙、一个要猎杀的Boss，以及一个解锁世界中新 NPC 的奖励。
一个恐怖故事——僵尸掉落的撕碎日记页、一个记得你名字的诡异陌生人、在烛光下低语雾中某物的 NPC。
一个只在沙漠夜晚出现的旅行商人，出售稀有书籍，天亮前就消失。
一张带过场动画的冒险地图——NPC 走到门口、转向你、说话并打开他们的对话，全部由命令方块控制。
一个整合包的全部传说——谈论其他模组怪物和地点的角色、可收集的书籍，以及一个追踪它们的图书馆。

✦ 你决定世界何时苏醒

每个世界都有自己的开关。直接在创建世界界面选择“开启”或“等待”——然后先建造你的基地、测试你的整合包或只是探索。当你准备好时，在菜单中按“开启”（或从命令方块或任务奖励运行 /npcw world on），NPC 就会开始到来。你在此期间探索过的任何东西都不会错过。

## ✦ NPC 创建器

每个 NPC 都是一个你构建一次并可随意生成的配置文件。更改配置文件后，由它生成的所有 NPC 都会更新。

– **皮肤：** 按 **浏览**（或将 PNG 拖到窗口上）上传 64×64 皮肤。它会自动发送给每位玩家。Steve 或 Alex 手臂。
– **外观：** 大小从 0.3 到 3（碰撞箱也如此）、名称标签始终显示 / 看着时显示 / 隐藏、名称颜色、发光轮廓、隐形。
– **声音：** 来自游戏、其他模组或资源包的受伤、死亡和空闲声音——带有预览按钮。
– **属性：** 生命值、速度和伤害可设为固定数值，或**像玩家用其武器攻击一样**（锋利和力量计入）。
– **装备：** 每个盔甲和手部槽位，带有可搜索的物品选择器，包括模组物品。
– **态度：** 友好（从不战斗）、中立（反击）或敌对，外加无敌。
– **行为：** 静止、游荡、巡逻、守卫、跟随、逃跑或攻击——如果你愿意，夜晚可以不同。战斗者可以是**近战或远程**（箭、火球、雪球）。
– **死亡：** 重生计时器、经验值、聊天中的遗言、掉落装备，以及带有数量和几率的战利品表。
– **安全编辑：** 每次保存都会保留可恢复的旧版本，带着未保存的更改离开时会先询问。
– **易于学习：** 将鼠标悬停在任何按钮上可获得帮助，每个长列表都有可拖动的滚动条，指南书涵盖了其余内容。

✦ 数据一览

7 种行为，可按白天和夜晚切换，近战或远程
16 种任务目标类型和 9 种奖励类型，带有步骤、链、时间限制和团队任务
36 种备注情境——从你手持的物品到你身后的生物
11 种性格 × 13 种主题的现成台词，外加 21 个其他模组的台词
5 个声望等级、记忆、礼物、语音、作息和 NPC 对 NPC 闲聊
20+ 条供地图作者使用的命令，带有 execute store 的结果
32 种菜单主题和 5 种字体
一本带搜索的 24 章游戏内指南书
无需一行代码

## ✦ 对话与任务——在一个菜单中

– 一个**对话编辑器**，看起来像真实的交谈窗口：编写 NPC 的台词，添加回答按钮，按 **Go >** 编写回复。
– **每页多行**——随机选择一行，所以问候语永远不会过时。
– **会思考的回答：** 仅在任务（未）开始、玩家携带物品、拥有标记、之前未选择过或已获得足够声望时显示回答。
– **会做事的回答：** 给予或拿走物品和书籍，开始 / 完成 / 重置任务，设置标记，改变声望，给予进度，添加到分数或运行命令。
– **页面地图**将整个对话显示为树状图，断开的链接以红色显示。**测试**像玩家一样播放它，带有模拟的任务进度。
– **模板：** 简单聊天、收集任务、一次性礼物、谣言和店主。
– **翻译：** `lang:` 行从资源包语言文件读取。

## ✦ 任务卡

– 几秒内制作任务：**收集、狩猎、交付、探索**或空白，带有三种措辞的现成 NPC 台词。
– **16 种目标类型：** 带来、杀死、挖掘、放置、合成、熔炼、拾取、使用、前往、交谈、阅读、进度、统计、标记、分数或命令——模组 ID、标签和“任何”都有效。将它们限制在生物群系、维度、夜晚或手持物品。
– **开始时给予：** NPC 在玩家接受时交给他们某物——一封要交付的密封信、一把地穴钥匙、一本要读的日记——如果任务失败则收回。
– **步骤**用于较长任务，**链**（“需要先完成此任务”），**时间限制**，**可重复**并带冷却。
– **奖励：** 物品、图书馆书籍、经验值、等级、标记、进度、分数、命令和声望。
– **团队任务：** 与附近的队友共享（原版队伍或 FTB Teams），带有可选的 **[加入]** 邀请。
– **游戏中：** 交谈窗口中的金色 **!** 表示接受，灰色 **?** 表示进度，金色 **?** 表示交付，以及 NPC 头顶可选的 **! / ? 标记**。
– **日志（J）：** 带有实时进度和剩余时间的活跃任务、已完成任务以及图书馆。

## ✦ 商店

– 熟悉的**村民交易界面**：玩家支付一两个物品并获得一个物品或一本传说书。
– **购买 X 次后售罄**和**补货**计时器。
– 可选：**价格跟随声望**——朋友支付更少，敌人根本无法交易。

## ✦ 书籍、传说与图书馆

– 在游戏内编写带有颜色和 `{player}` 的书籍，或将你手持的**书与笔**变成图书馆书籍。
– 在商店中**出售**它们，从回答和任务中**给予**它们，将它们**隐藏**在结构箱子中（原版和模组，从列表中选择），或让**生物掉落**它们——带有“被玩家杀死”选项，这样农场不算数。
– **撕页：** 将一本书分成 2–8 页，玩家收集并重新拼合。
– **图书馆**（日志 > 传说）列出每本传说书：找到的可再次阅读，缺失的显示为 **???** 并带有关于去哪找的提示。

## ✦ 人格——拥有自己生活的 NPC

*每个人格功能都有自己的开关，并且**默认关闭**，所以你的服务器只运行你开启的内容。*

• **说明：**NPC 会对你手持的物品、生命值、天气、夜晚、附近的生物群系和任务发表评论。 
• – **11 种性格**（友善、暴躁、守卫、商人、学者、阴森、害羞、贵族、欢快、老兵、邪教徒）和 **13 种主题**（恐怖、奇幻、海盗、西部、科幻、蒸汽朋克、温馨、末日、军事、悬疑、魔法、科技、冒险）。自由组合 — 比如害羞的海盗、阴森的温馨旅店老板。
  – **模组台词**会对其他模组的生物和地点作出反应，且仅在安装了对应模组时触发。
  – **声望**分五个等级 — 憎恨、警惕、中立、喜欢、信任 — 可按 NPC 类型分别计算，也可由**整个群体共享**，例如全镇居民。性格会影响声望变化速度：暴躁的 NPC 需要更久才会熟络，欢快的 NPC 则很快就能原谅你。
  – **任务和需要信任才能解锁的回答**，会显示灰色锁定的 **!**，并由 NPC 用自己的语气说出「还不行」之类的台词。
  – **记忆：**NPC 会记得你离开过、打过他们、完成过他们的任务或送过礼物，并用自己的语气提起这些事 —「走了 4 天啊。我才没想你。才没有。」如果他们不喜欢你，就只记得不好的事。
  – **NPC 之间的闲聊：**附近的 NPC 会用对话气泡互相交谈，表现出各自的性格。他们会面对彼此、站着不动并点头，还可能聊起自己喜欢或讨厌的玩家。
  – **礼物：**有最喜欢、喜欢和讨厌的物品，并会显示爱心和相应反应。
  – **语音：**对话窗口逐字显示时会播放轻声呢喃 — 可用内置语音、游戏或模组中的任意音效，也可以使用**你自己的 .ogg 文件**。
  – **日常作息：**为地点设置活动时段（「06:00–18:00 工作，18:00–22:00 酒馆」）；远离玩家时，NPC 会直接出现在对应地点。
  – **台词手册：**每句台词都可以编辑，还能创建自己的性格和主题。

## ✦ 生成

– **生成规则**可以让 NPC 出现在游戏实际生成的结构中 — 原版和模组结构都支持，可通过搜索列表选择 — 也可以让 NPC 出现在各种生物群系、地表或洞穴中。
– 可设置概率、数量、世界上限、时间、天气、维度，以及生成位置（内部、周围、墙边或精确偏移位置）。
– **只在安全地点生成**（地面稳固、有头顶空间、没有熔岩），绝不生成区块，也不会在同一地点重复生成。
– **在此测试**可查看每条规则在你当前所在位置的效果。

*创建一次 — 每个新世界都能使用

• 你创建的所有内容 — NPC、皮肤、对话、任务、书籍、台词手册内容和生成规则 — 都会保存到整个游戏中，而不是只保存在某个世界里。
  创建新世界后即可使用：玩家探索时，生成规则会将你的 NPC 放置在村庄、遗迹、模组结构和各类生物群系中，让每个世界都能出现同一批角色。
  每个世界都有自己的故事：任务进度、声望、标记，以及哪些 NPC 已经出现过，都会按世界分别保存，所以新世界就是新的开始。
  整合包：附带 `config/npcworkshop/` 文件夹，每位玩家的新世界都会包含你完整的角色阵容、任务和背景故事 — 无需设置，也不需要命令。
  服务器：同样的配置也适用于专用服务器；玩家只需加入并开始探索。

## ✦ 地图制作者命令

所有命令都以 /npcw（或完整的 /npcworkshop）开头，并且需要管理员权限。唯一例外是 /npcwjoin，任何玩家都能使用。<npcs> 表示实体选择器，例如 @e[type=npcworkshop:npc,limit=1,sort=nearest]。

设置

/npcw help – 在聊天栏列出所有命令
/npcw editor – 打开 NPC Workshop 菜单（与 N 键功能相同）
/npcw list – 按 ID 列出所有 NPC 档案
/npcw reload – 重新读取 config/npcworkshop/ 中的所有文件（NPC、规则、任务、书籍、台词手册、设置）

当前世界

/npcw world – 显示当前世界中的 NPC Workshop 是否已开启或正在等待（结果为 1 或 0）
/npcw world on – 开启功能：生成规则开始生效，并发放《指南》
/npcw world off – 暂停功能：关闭期间不会自动生成任何内容

放置 NPC

/npcw spawn <profile> [x y z] [count] – 在你所在位置生成 NPC，或在指定坐标生成；一次最多生成 32 个
/npcw despawn <npcs> – 从世界中移除 NPC

让 NPC 执行动作（过场动画和地图）

/npcw talk <player> <npc> – 为玩家打开该 NPC 的对话、任务或商店
/npcw say <npcs> <text> – NPC 在对话气泡中说出指定内容
/npcw nod <npcs> – NPC 对最近的玩家点头
/npcw look <npcs> <target> [seconds] – NPC 看向玩家或生物（默认 5 秒）
/npcw goto <npcs> <x y z> [stay] – NPC 移动到指定位置；stay 会将该地点设为新家
/npcw chat <npc> <npc> – 让两个 NPC 立即交谈，即使已关闭闲聊功能也可以
/npcw behavior <npcs> <behavior> – 切换 NPC 的行为：stationary（原地不动）、wandering（闲逛）、patrol（巡逻）、guard（守卫）、follow（跟随）、flee（逃跑）或 attack（攻击）；reset 会恢复档案中设置的行为

任务

/npcw quest list – 按 ID 列出所有任务卡
/npcw quest start <player> <quest> – 为玩家开始一项任务
/npcw quest complete <player> <quest> – 完成任务并发放奖励
/npcw quest fail <player> <quest> – 使任务失败（已交付的物品会被收回）
/npcw quest reset <player> <quest> – 重置任务，使玩家可以再次接取
/npcw quest status <player> <quest> – 结果 0 = 未开始，1 = 进行中，2 = 已完成
/npcw quest progress <player> <quest> <goal> <amount> – 增加目标进度（适用于脚本和命令方块）

玩家

/npcw rep <player> – 列出所有 NPC 对该玩家的看法
/npcw rep <player> <npc> get – 获取声望分数（结果范围为 -100 到 100）
/npcw rep <player> <npc> set <n> – 设置声望
/npcw rep <player> <npc> add <n> – 增加或降低声望
/npcw flag <player> list – 列出玩家的所有标记
/npcw flag <player> add <flag> – 为玩家添加标记
/npcw flag <player> remove <flag> – 移除玩家的指定标记
/npcw flag <player> clear – 移除玩家的所有标记
/npcw flag <player> has <flag> – 结果为 1 或 0（结果为 0 时命令会失败，因此 execute store success 也能使用）

书籍

/npcw book list – 按 ID 列出所有藏书
/npcw book give <player> <book> [page] – 给予玩家一本藏书，或其中一页残页

生成规则

/npcw spawnrule list – 列出所有生成规则及已关闭的规则
/npcw spawnrule enable <rule> – 开启指定规则（会保存设置）
/npcw spawnrule disable <rule> – 关闭指定规则（会保存设置）

所有玩家

/npcwjoin <id> – 加入队友共享的任务（聊天栏中的 [Join] 链接会运行此命令）

## ✦ 面向整合包和服务器

– **权限：**只有管理员（或你指定的权限等级）能看到工作台；其他玩家可以直接游玩。
– **分享：**导出单个 NPC（包含皮肤）、单条生成规则，或**将所有内容打包导出**，并可在任何地方导入。
– **自动备份** NPC、任务、书籍、规则和台词手册包。
– **随整合包附带 `config/npcworkshop/` 文件夹**，所有内容都会一并打包 — 每个新世界都能使用。
– **服务器设置**带搜索框；另有每位玩家独立的**个人设置**（32 种菜单主题、5 种字体、语音、悬停提示）。
– **性能开销低：**附近没有玩家时，NPC 会进入休眠；生成规则分小批次运行；任务只会为拥有任务的玩家运行。
– **编辑器工具：**查看所有 NPC 的地图和小地图；使用**问题扫描**检查模组更新后失效的链接和缺失物品；还能通过玩家检查器查看任务、标记和声望。

更多内容即将推出！

**问题和建议：***欢迎在评论区留言或发送消息*

—
字体：Liberation Sans / Liberation Serif（SIL Open Font License 1.1）以及 GNU FreeMono（GPL，附字体例外条款）。