logic_playerproxy

类层级
CLogicPlayerProxy ↳CLogicalEntity ↳CServerOnlyEntity ↳CBaseEntity
hl2_player.cpp

logic_playerproxy是一个逻辑实体，可在 Half-Life 2 series、 传送门（系列）、 异形丛生、 反恐精英：全球攻势 和 黑山中使用。

用于在玩家和游戏世界之间传递输入/输出信号。

注意:输出仅会在地图中该实体的第一个实例上触发。

注意:此实体主要设计用于单人游戏，但所有包含该实体的游戏均可进行多人游戏：

• 在橙盒(en)游戏和传送门2(en)中，输出会正确触发，触发玩家将作为!activator
• 在橙盒游戏中，输入会影响最近连接的玩家
• 在传送门2中，输入无效并会在控制台显示Can't use logic player proxy in multiplayer!（此提示略有误差，因为输出仍可正常工作）
• 在异形丛生和CS:GO（纯多人游戏）中，该实体完全无效

键值

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

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

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

DamageFilter:

Damage Filter (damagefilter) <target_destination>

伤害过滤器（玩家受到伤害时需要通过的过滤器）

输入

DamageFilter:

SetDamageFilter <字符串(en)>

Sets the entity to use as damage filter. Pass in an empty string (no parameter) to clear the damage filter.

半条命2、HL2章节、传送门与黑山

RequestPlayerHealth

请求代理返回当前玩家生命值。将触发PlayerHealth输出。

SetFlashlightSlowDrain

将玩家手电筒设为慢速耗电模式（用于章节黑暗场景）

SetFlashlightNormalDrain

将玩家手电筒恢复默认耗电速度

SetPlayerHealth <整数(en)>

设置玩家生命值为指定值

RequestAmmoState

请求玩家弹药状态。将触发PlayerHasAmmo或PlayerHasNoAmmo输出。

EnableCappedPhysicsDamage

使玩家受到物理伤害减少，单次伤害不超过30点

DisableCappedPhysicsDamage

取消EnableCappedPhysicsDamage的效果

半条命2、HL2章节和传送门

LowerWeapon

放下玩家武器

SetLocatorTargetEntity <字符串(en)> (仅存在于 之中)

设置HUD定位器追踪的实体（通常是载具）

注意:如果移植了资源，自Source 2007(en)起在第一章(en)中同样有效

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

隐藏准星

注意:不同于命令crosshair 0，当新游戏开始或加载存档时会恢复显示

注意:添加于2010年3月3日更新。似乎是传送门2中被移除的输入功能的反向移植

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

标记玩家从游戏开始时统计排行榜

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

将当前时间、传送门和使用步数保存到排行榜

传送门2

AddPotatosToPortalgun

改变传送枪模型显示PotatOS

RemovePotatosFromPortalgun

改变传送枪模型不显示PotatOS

SetDropEnabled

设置玩家是否允许丢弃携带物品

ForceVMGrabController

强制玩家对所有拾取物品使用视图模型抓取控制器

ForcePhysicsGrabController

强制玩家对所有拾取物品使用物理抓取控制器

ResetGrabControllerBehavior

重置玩家的抓取控制器为默认行为

SetMotionBlurAmount <浮点型(en)>

强制设置玩家的动态模糊效果。设为<=0可禁用覆盖

PaintPlayerWithPortalPaint  不存在于FGD！

在玩家屏幕显示转换凝胶溅射效果

传送门 2：社区特供版专属输入

SetFallDamageEnabled <布尔值(en)> 启用或禁用玩家跌落伤害 GiveBoots 给予长坠靴 RemoveBoots 移除长坠靴 GivePaintGunFull 给予完整油漆枪 GivePaintGunBasic 给予基础油漆枪 RemovePaintGun 移除油漆枪 RemovePortalGun 移除传送枪

输出

半条命2、HL2章节、传送门与黑山

PlayerDied

玩家死亡时触发

PlayerHealth <整数(en)>

输出玩家当前生命值

OnFlashlightOn <浮点型(en)>

玩家开启手电筒时触发。输出值为发生时剩余电量[0..1]

OnFlashlightOff <浮点型(en)>

玩家关闭手电筒时触发。输出值为发生时剩余电量[0..1]

PlayerHasAmmo

当请求时触发（如果玩家有弹药）

PlayerHasNoAmmo

当请求时触发（如果玩家没有弹药）

PlayerMissedAR2AltFire  (不存在于 之中)

玩家发射AR2组合球但未击杀任何敌人时触发

传送门2、反恐精英：全球攻势和黑山

OnDuck

玩家开始下蹲时触发

OnUnDuck

玩家停止下蹲时触发

OnJump

玩家跳跃时触发

错误:这些在反恐精英：全球攻势和黑山中技术上存在，但实际无效

传送门2

OnPrimaryPortalPlaced

玩家成功放置主传送门时触发

OnSecondaryPortalPlaced

玩家成功放置副传送门时触发

OnCoopPing  不存在于FGD！

响应未使用的+coop_ping命令。普通ping不会触发此输出，请使用info_player_ping_detector替代

OnStartSlowingTime  (仅存在于 之中)

传送门玩家开始减速时间时触发

OnStopSlowingTime  (仅存在于 之中)

传送门玩家停止减速时间时触发