NPC工具包 | 文档 - Roblox 创作者中心

此项目及其文档的内容可以在Roblox的有限使用许可证下使用。

NPC（非玩家角色）可以为体验增添很多深度。以下所有NPC都可以进行视觉自定义，它们的行为可以修改，而僵尸/士兵甚至可以通过使用tag系统攻击玩家或其他角色以保卫某个区域。

要在游戏中使用NPC：

选择以下NPC工具包之一：

流口水的僵尸
士兵
RO-01机器人
NP-C 9000机器人
在NPC的物品页面上，点击绿色的获取按钮并确认交易。
在Studio中，打开工具箱。
选择工具箱的库存部分。
找到NPC并点击它以将其添加到地点中。

角色结构

每个NPC模型通常包含以下对象：

对象名称或 [类型]	类型	描述
动画	Folder	包含Animations，例如AttackAnimation或DeathAnimation。
初始姿势	Folder	包含姿势信息。
Animate	Script	在角色装配上加载和播放动画。有关更多详细信息，请参见Animate。
[配饰]	Accessory	可能是多个Accessories之一，如帽子、武器等。
生命值	Script	通常随时间恢复Humanoid的生命值。禁用此项会阻止角色恢复生命值。
类人	Humanoid	管理与Humanoid相关的属性，如Humanoid.Health、Humanoid.WalkSpeed、Humanoid.DisplayDistanceType等。
NPC	Script	定义特定于角色的行为，如漫游、攻击等。父对象包括以下对象： Maid (ModuleScript)定义了一个用于释放所用资源的有用类。 Ragdoll (ModuleScript)定义一个将角色转变为受物理影响的松弛身体的函数（父对象是定义多个帮助函数的RigTypes ModuleScript）。
RbxNpcSounds	Script	定义和管理与角色声音效果相关的行为，如奔跑、死亡等。
BodyParts	BasePart	通过Motor6D或约束对象连接到HumanoidRootPart或相邻身体部位的各种角色身体部位。有关更多详细信息，请参见BodyParts。
HumanoidRootPart	BasePart	一个被视为装配根部的特殊隐藏部件；这里也是角色Model的PrimaryPart。
Configuration	Configuration	包含调节各种行为的值对象。有关更多详细信息，请参见Configuration。

方括号 [] 指的是对象的一般信息，名称无关紧要。例如，[Model]指的是武器的Model，您可以将其重命名为任何有意义的名称。

设计说明

使用NPC工具包时，请牢记以下设计说明：

NPC的外观可以通过添加/修改各种[BodyParts]对象以及通过添加Accessory对象进行自定义。
士兵、流口水的僵尸和NP-C 9000机器人使用Rthro作为他们装配的基础。然而，RO-01机器人使用的是修改过的Rthro基础，添加了连接到UpperTorso的推进器部件，使用WeldConstraints。以这种方式使用简单的关节可以让您在不改变原始基装配的情况下为角色添加额外的几何体。
在基本层面上，NPC动画可以通过修改Animate脚本姿势中现有动画对象的AnimationId或Animations文件夹中的动画来进行自定义。此类更改实质上是资产交换 - 要改变更细的细节，您可以创建现有动画的自定义副本，并且要在不同条件下播放动画，您可以直接编辑Animate或NPC脚本。有关更多信息，请参见Animation。

Animate

NPC Model中的Animate Script处理与动画相关的配置，并包含以下对象：

对象名称或 [类型]	类型	描述
ScaleDampeningPercent	NumberValue	定义随着角色缩放而修改动画速度的方式（小于1表示动画播放在角色缩放时呈反向缩放）。
PlayEmote	BindableFunction	其他脚本可以调用这个函数以强制假设一个姿势。
[Pose]	StringValue	引用可播放的动画类别，如待机、跳跃、行走等。此对象可以作为任何数量的Animations的父对象。这些Animations有一个Weight（NumberValue），优先播放多种动画中的一种，同时假设姿势；通常用来增加待机和舞蹈姿势的多样性。

BodyParts

NPC Model中的BodyPart BasePart表示各种角色身体部位，并包含以下对象：

对象名称或 [类型]	类型	描述
AvatarPartScaleType	StringValue	确定该部件的缩放方式；值可以是Classic、ProportionsNormal或ProportionsSlender。
OriginalSize	Vector3Value	确定当角色缩放为1时该部件的大小。
[Attachment]	Attachment	定义一个相对于单个部件的点，脚本、效果和对象（如Tool或Accessory）可以在定位时利用。
[Motor6D]	Motor6D	两个身体部件之间的动画关节。请注意，Animator依赖于Motor6Ds的名称，名称必须与创建动画时使用的Motor6Ds一致，因此请避免重命名此对象。
[Joint]	WeldConstraint, Constraint, JointInstance	两个身体部件之间的非动画关节。
[Sound]	Sound	常见于头部或HumanoidRootPart；播放受RbxNpcSounds脚本控制的装配中的声音。

Configuration

每个NPC在其层次结构中包含一个Configuration对象，该对象充当值对象的容器。这些对象由NPC脚本使用来调节各种行为。除非另有说明，否则这些适用于所有角色。

对象名称或 [类型]	类型	描述
DestroyOnDeath	BoolValue	在NPC死亡后不久导致整个NPC被销毁。禁用此选项可使ragdoll保持持久。
PatrolEnabled	BoolValue	使NPC在其起始位置周围徘徊。
PatrolRadius	NumberValue	定义NPC将从其起始位置漫游的最大距离，假设PatrolEnabled为真。
RagdollEnabled	BoolValue	使NPC在死亡时变得松弛，而不是拆散。
AttackDamage	NumberValue	定义当NPC攻击时受害者失去多少生命值。仅适用于僵尸和士兵工具包。
AttackDelay	NumberValue	定义射击之间的最小秒数。仅适用于士兵工具包。
AttackMode	NumberValue	指定士兵将攻击的对象，基于tagging系统。仅适用于士兵工具包。
AttackRadius	NumberValue	定义NPC在尝试攻击之前必须与潜在受害者之间的最大距离。仅适用于僵尸和士兵工具包。
ClipCapacity	NumberValue	定义士兵在需要重新装填之前可以发射的子弹数量。仅适用于士兵工具包。
ReloadDelay	NumberValue	定义在士兵的武器弹匣被重新装填之前必须经过多少秒。仅适用于士兵工具包。

分配标签

NPC脚本使用CollectionService标签来管理对其他角色和玩家的攻击性。可以按如下表中的方式分配各种标签：

要将标签分配给另一个NPC，请使用其属性的标签部分将其分配给NPC的顶级Model。

要将标签分配给Player角色，您可以在StarterCharacterScripts中添加一个Script，并调用CollectionService:AddTag()。例如：


local CollectionService = game:GetService("CollectionService")

CollectionService:AddTag(script.Parent, "SoldierEnemy")

标签	目的
SoldierEnemy 或 SoldierFriend	确定士兵是否应该攻击另一个角色，基于其AttackMode配置值。当士兵的AttackMode设置为1时，其他角色必须标记为SoldierEnemy才能被视为可攻击目标。当士兵的AttackMode设置为2时，所有没有SoldierFriend标签的对象都被视为可攻击目标。当士兵的AttackMode设置为3时，这些标签会被完全忽略，士兵将会攻击所有角色。
ZombieFriend	此标签用于僵尸确定其是否不应攻击某个角色。当应用时，僵尸对标记的角色变得和平。

标签

目的

SoldierEnemy 或 SoldierFriend

确定士兵是否应该攻击另一个角色，基于其AttackMode配置值。当士兵的AttackMode设置为1时，其他角色必须标记为SoldierEnemy才能被视为可攻击目标。当士兵的AttackMode设置为2时，所有没有SoldierFriend标签的对象都被视为可攻击目标。当士兵的AttackMode设置为3时，这些标签会被完全忽略，士兵将会攻击所有角色。

ZombieFriend

此标签用于僵尸确定其是否不应攻击某个角色。当应用时，僵尸对标记的角色变得和平。