Player

This entity is not in the FGD by default.
It should not be put directly in a map.

Source Engine

Team Fortress 2

Portal 2

Left 4 Dead series

Half-Life series

Counter-Strike series

Class hierarchy
CBasePlayer ↳CBaseCombatCharacter ↳CBaseFlex ↳CBaseAnimatingOverlay ↳CBaseAnimating ↳CBaseEntity

player is a point entity available in all Source games. The player itself or a bot. NPCs are not players. This entity still exists even if the player is dead.

Note:Keyvalues, inputs, outputs and Dimensions vary depending on game and engine version.^[Clarify]

Split

It has been suggested that this article or section be split into multiple articles. (Discuss)

Tip:In singleplayer, a pointer to the player can be acquired by using UTIL_GetLocalPlayer().

Important:This is a preserved entity in .
If the game has round restart mechanics this entity may not behave as expected:

More info

On a new round entities with this classname will intentionally not reset. You can use logic_auto to emulate resetting it. Killing it removes it forever, as it is not respawned on a new round. It cannot be spawned with a point_template. Parenting this with non-preserved entities may have undesirable effects.

Limitations/Bugs

Important:This entity is not intended to be placed in a map manually. Doing so will result in an instant fatal error on map load!

Keyvalues

Note:Keyvalues can be changed on a player with AddOutput.

Health (health) <integer>

The player's health.

Maximum Health (max_health) <integer>

The value of "health" cannot exceed this.

Base Velocity (BaseVelocity) <vector> !FGD

Adds to the velocity of the player.
Format: <x> <y> <z>

Todo: Test for games other than

Inputs

SetHealth <integerRedirectInput/integer>

Sets the player's health. Values clamped between 0 and max_health.

HandleMapEvent <stringRedirectInput/string>

Tells the game to perform a function, such as unlock an achievement. Hardcoded for specific map names.

SetHUDVisibility <booleanRedirectInput/boolean> (not in Half-Life 2 games)

Hides or displays the HUD.

Note:The menu can still be accessed, and some HUD elements such as kill-icons may still be visible.

Bug:In and , using this input with a parameter override of 0 will disable any weapon-switching of the target.

Todo: Test in other games.

  [todo tested in ?]

SetFogController <stringRedirectInput/string> (not in Half-Life 2 games)

Sets the env_fog_controller to use.

SpeakResponseConcept <stringRedirectInput/string> (not in Half-Life 2 games)

Speak the specified response concept immediately.

PerformForcedWeaponDeploy <stringRedirectInput/string> (only in ) !FGD

Forces the player to use specified weapon with pickup animation.

Note:Pickup animation doesn't always work, this somehow depends on player's ammo and other weapons.