View source for Logic playerproxy

{{CD|CLogicPlayerProxy|file1=logic_playerproxy.cpp}}
{{this is a|point entity|name=logic_playerproxy|sprite=playerproxy_this_icon_from_black_mesa_game.png|game=Half-Life 2 series|game1=Portal series|game2=Alien Swarm|game3=Counter-Strike: Global Offensive|game4=Black Mesa}}

It is used to relay inputs/outputs to the player and back to the world.

{{note|Outputs will only fire on the first instance of this entity in the map.}}

{{note|This entity is primarily intended for use in singleplayer, but all of the games it is present in can be played in multiplayer as well, even if they were not designed with it in mind. Thus, the entity exhibits varying behavior in multiplayer depending on the game:
* In [[Orange Box]] games and Portal 2, outputs will fire correctly, with the player that triggered the output as the {{ent|!activator}}.
* In Orange Box games, inputs will affect the most recently connected player.
* In Portal 2, inputs will do nothing and produce the console message <code>Can't use logic player proxy in multiplayer!</code> (which is slightly erroneous, as outputs still work as mentioned previously).
* In Alien Swarm and CS:GO (which are multiplayer only), the entity does not function at all.
}}

== Keyvalues ==
{{KV Targetname}}
{{KV DamageFilter|Damage filter that also needs to be passed when player takes damage}}

== Inputs ==
{{I DamageFilter}}

=== {{hl2}}{{portal}}{{bms}} Half-Life 2, HL2 Episodes, Portal and Black Mesa ===

{{IO|RequestPlayerHealth|Requests the current player's health from the proxy. This will fire the PlayerHealth output with the value.}}
{{IO|SetFlashlightSlowDrain|Puts the player's flashlight in slow-power-drain mode (for Episodic darkness)}}
{{IO|SetFlashlightNormalDrain|Puts the player's flashlight to default power drain}}
{{IO|SetPlayerHealth|Sets the player's health to this value.|param=integer}}
{{IO|RequestAmmoState|Request the ammo state of the player. It will fire PlayerHasAmmo or PlayerHasNoAmmo outputs.}}
{{IO|EnableCappedPhysicsDamage|Cause player to take less damage from physics objects, and never more than 30 points from any individual strike.}}
{{IO|DisableCappedPhysicsDamage|Undo effects of EnableCappedPhysicsDamage}}

=== {{hl2}}{{portal}} Half-Life 2, HL2 Episodes and Portal ===

{{IO|LowerWeapon|Lowers the players weapon.}}
{{IO|SetLocatorTargetEntity|Set the entity that the HUD locator should track. (Usually a vehicle)|param=string|only={{ep2}}}}
:{{note|Also works in [[Episode One]] since [[Source 2007]], if the resources are ported.}}
{{IO|SuppressCrosshair|Hides the crosshair.|nofgd=1|only={{portal}}}}
:{{note|Unlike the command <code>crosshair 0</code>, the crosshair is enabled again when a new game is started or a save made before firing the input is loaded.}}
:{{note|Added in the March 3rd, 2010 update. Seems to be a backported Portal 2 input that was removed from Portal 2 before release.}}

=== {{portal2}} Portal 2 ===

{{IO|AddPotatosToPortalgun|Change portalgun bodygroup to show PotatOS.}}
{{IO|RemovePotatosFromPortalgun|Change portalgun bodygroup to not show PotatOS.}}
{{IO|SetDropEnabled|Set whether the player is allowed to drop a carried object.}}
{{IO|ForceVMGrabController|Force the player to use the view model grab controller for all objects that are picked up.}}
{{IO|ForcePhysicsGrabController|Force the player to use the physics grab controller for all objects that are picked up.}}
{{IO|ResetGrabControllerBehavior|Resets the grab controller used by the player to its default behavior.}}
{{IO|SetMotionBlurAmount|Forces the motion blur effect on the player. Set to <<nowiki>=</nowiki> 0 to disable this override.|param=float}}
{{IO|PaintPlayerWithPortalPaint|Displays a Conversion Gel splashing effect on the player's screen.|nofgd=1}}
{{Expand|title={{P2CE|4}} only inputs|
{{IO|SetFallDamageEnabled|Enables or disables fall damage on the player.|param=bool}}
{{IO|GiveBoots|Gives long fall boots to the player.}}
{{IO|RemoveBoots|Removes long fall boots to the player.}}
{{IO|GivePaintGunFull|Gives the player a full paint gun.}}
{{IO|GivePaintGunBasic|Gives the player a basic paint gun.}}
{{IO|RemovePaintGun|Removes the player's paint gun.}}
{{IO|RemovePortalGun|Removes the player's portal gun.}}
}}

== Outputs ==

=== {{hl2}}{{portal}}{{bms}} Half-Life 2, HL2 Episodes, Portal and Black Mesa ===

<!--PlayerDied and PlayerHealth are technically in all games, but can only fire in Half-Life 2/Portal/Black Mesa-->
{{IO|PlayerDied|Fires when the player dies.}}
{{IO|PlayerHealth|Outputs the player's current health value.|param=integer}}
{{IO|OnFlashlightOn|Fired when the player turns on their flashlight. This output has the value of how much energy the player had when this happened [0..1].|param=float}}
{{IO|OnFlashlightOff|Fired when the player turns off their flashlight. This output has the value of how much energy the player had when this happened [0..1].|param=float}}
{{IO|PlayerHasAmmo|Fired by request if the player has any ammo.}}
{{IO|PlayerHasNoAmmo|Fired by request if the player doesn't have any ammo.}}
{{IO|PlayerMissedAR2AltFire|Player fired an AR2 combine ball that didn't kill any enemies.|not={{hl2}}}}

=== {{portal2}}{{bms}}{{csgo}} Portal 2, Counter-Strike Global Offensive and Black Mesa ===

{{IO|OnDuck|Fired when a player starts to duck.}}
{{IO|OnUnDuck|Fired when a player releases the duck button.}}
{{IO|OnJump|Fired when a player jumps.}}
:{{bug|These are technically in Counter-Strike: Global Offensive and Black Mesa, but don't work.|hidetested=1}}

=== {{portal2}} Portal 2 ===

{{IO|OnPrimaryPortalPlaced|Fired when a Portal player successfully places the primary portal.}}
{{IO|OnSecondaryPortalPlaced|Fired when a Portal player successfully places the secondary portal.}}
{{IO|OnCoopPing|Fired in response to the unused <code>+coop_ping</code> command. Normal pings do not fire this output; use {{ent|info_player_ping_detector}} instead.|nofgd=1}}
<!--These are in regular Portal 2, but never fire because slowtime was removed-->
{{IO|OnStartSlowingTime|Fired when a Portal player initiates slow time.|only={{P2CE}}}}
{{IO|OnStopSlowingTime|Fired when a Portal player stops slowing time.|only={{P2CE}}}}


[[Category:IO System]]