Zh/Prop ragdoll

参见:  有关创建布娃娃的具体细节，详见$collisionjoints.

类层级
CRagdollProp ↳CBaseAnimating ↳CBaseEntity
physics_prop_ragdoll.cpp

不像NPC死亡时生成的布娃娃，地图制作者放置的布娃娃可以与环境动态的交互

prop_ragdoll是一个点实体(en)，可在所有的 起源 游戏中使用。是一个具有物理性质的布娃娃。布娃娃是一组约束在一起的物理对象的集合，用于模拟像尸体这样的关节物体，它们的物理模拟有着昂贵的性能开销.

警告:该实体生成的是服务端布娃娃，会与任何道具发生碰撞，但这会造成大量网络开销。通过默认休眠（勾选Start asleep Flag），禁用物理运动或禁用与动态道具的碰撞（不存在于FGD！在soild键值中使用0为参数），并仅在需要时启用物理运动，可以显著减少网络开销

错误:通过Hammer设置自定义动作并勾选Start Asleep Flag会导致渲染框无法更新，在生成时唤醒布娃娃一帧时间后再次休眠即可解决此问题  [todo tested in ?]

错误:在 传送门2中，布娃娃无法穿过传送门，这也在 传送门中经常发生  [todo tested in ?]

错误:预测时会忽略布娃娃，这会在触摸布娃娃时导致大量的预测错误  [todo tested in ?]

AltNames: 此实体也绑定到 physics_prop_ragdoll。

黑山特定提示和漏洞

注意:原始版本仍可作为prop_ragdoll_original使用。区别在于： prop_ragdoll_original无法通过爆炸造成碎尸 如果没有在Spawnflags勾选[4] Debris，撬棍的攻击可以击中prop_ragdoll_original（由于某些原因，撬棍的攻击判定会跳过prop_ragdoll） prop_ragdoll_original没有流血效果且不会产生印花 prop_ragdoll_original无法被拾取 prop_ragdoll_original有真实的子弹推力效果 错误: server side ragdolls created by NPCs never gib before loading save since the first Steam version, the same for gibs created by gibbed ragdolls. Use the workshop addon if you want to use server side ragdolls in your mod. crowbar's raycast skips/ignores server side ragdolls since the first Steam version. Tripmines do not gib ragddols In multiplayer ragdolls do not create hole decals and blood from bullets if [4] Debris spawnflag is enabled. If this flag is disabled - ragdolls still will not create blood effects and hand blood overlays.  [todo tested in ?]

Death Ragdolls/Ragdoll Transformation

When a NPC/player dies or an entity receives the BecomeRagdoll input, it normally creates a client-side ragdoll and copies most of its animation and visual data to it. Unlike server-side prop_ragdolls, these client-side ragdolls are handled completely on a per-client basis and are much cheaper and simpler than their server-side counterparts, at the expense of being virtually nonexistent on the server, being inconsistent across client perspectives, and only colliding with entities that have physics objects on the client (e.g. worldspawn).

However, a NPC will become a server-side ragdoll while it's under any of the following conditions:

• The NPC is inside the volume of a trigger_serverragdoll
• The NPC is killed by a vehicle in singleplayer
• The gravity gun is supercharged
• The NPC dies on fire while in Alyx darkness mode
• The NPC is a vital ally (e.g., npc_alyx)

These server-side death ragdolls will collide with physics objects and beyond, like any prop_ragdoll, but they are marked as debris and do not collide with each other. They do not collide with themselves either, unlike client-side ragdolls (fixed in Entropy : Zero 2 and 黑山). This is believed to be intentional behavior to reduce performance/networking costs.

错误:Server side ragdolls don't save blood decals. Fixed in Mapbase and 黑山.  [todo tested in ?]

注意:Most of this list theoretically applies to players as well, although that hasn't been tested.

警告:While most of the relevant animation/visual data is copied to ragdolls, some fields, like fade distances, are not transferred.

代码:This can be modified at CBaseAnimating::CopyAnimationDataFrom() in baseanimating.cpp for server-side ragdolls and C_BaseAnimating::CreateRagdollCopy() in c_baseanimating.cpp for client-side ragdolls.

Keyvalues

Name (目标名称) <target_source>[ Edit ]

这个名称是其他实体通过 输入/输出(en) 或其他 关键值(en)（如 parentname 或 target) 来引用该实体时使用的标识符。
该名称也会显示在 Hammer 编辑器的 2D 视图和 实体报告(en) 中。

参见:  所有实体均可使用的 通用键值、输入与输出(en)

Override Animation (angleOverride) <字符串(en)>

Filled in by the engine via hammer_update_entity. Do not edit by hand except to clear.

Non-Valve game specific

Health (health) <整数(en)> (仅存在于 之中) The amount of damage the ragdoll takes before gibbing. Character Manifest Mimic Name (MimicName) <字符串(en)> (仅存在于 之中) Choose a name or a classname from the character manifest to dress the ragdoll. GMODSandbox: Allow Physics Gun (gmod_allowphysgun) <布尔值(en)> (仅存在于 之中) If set, players cannot use Physics Gun on this entity. Sandbox Tool Whitelist (gmod_allowtools) <字符串(en)> (仅存在于 之中) If set, only given tools can be used on this entity. You need to supply the tool class names, the names of the .lua files of those tools. This also includes the context menu properties!

Flags

Debris : [4]

Don't collide with the player or other debris

Use 'Least Recently Used' Retirement ^[澄清]  : [4096] 不存在于FGD！

Allow Dissolve : [8192]

Motion Disabled : [16384]

Allow stretch : [32768]

Start asleep : [65536]

Inputs

StartRagdollBoogie

Begins ragdoll boogie effect for 5 seconds.

错误:This input is actually supposed to use a parameter for how long the ragdoll should boogie, but it uses the wrong field type in the data description.  [todo tested in ?]

代码修复:In CRagdollProp's data description, find DEFINE_INPUTFUNC( FIELD_VOID, "StartRagdollBoogie", InputStartRadgollBoogie ) and replace FIELD_VOID with FIELD_FLOAT.

EnableMotion / DisableMotion

Enable / disable physics simulation.

FadeAndRemove  (存在于自 以来)

Fade out then remove (kill) self. Parameter override = duration of fade.

AllowBloodPool  (仅存在于 之中) 不存在于FGD！

Сorpse once will create pool of blood (particle effect) if it is placed on brush.

注意:Not avaible for prop_ragdoll_original and prop_ragdoll_attached.

See Also

• env_ragdoll_boogie
• Prop Types Overview