PlayerPed

PlayerPed is a term used in video game scripting and modding to refer to the player’s in-game character, specifically the Ped (pedestrian) entity that the player controls. It serves as a shorthand for the active player character in various APIs and native function references, and it is commonly seen in communities that work with Grand Theft Auto titles and related development tools.

In Grand Theft Auto titles such as GTA IV and GTA V, the PlayerPed represents the player’s avatar within the game world. The exact method to obtain a handle to this entity varies by platform and API, but it generally involves a function or property that returns the player’s Ped entity. In scripts, this handle is used to query or modify the character’s state, including location, health, animations, weapons, and current tasks. Examples of typical operations include moving the character, issuing tasks, checking whether the player is in a vehicle, or applying effects.

Scripting with PlayerPed often involves comparing it to other Peds (non-player characters) or using it as the target for commands, such as task sequences, combat actions, or interaction with the environment. It is important to distinguish the PlayerPed from other Peds in the world, such as NPCs or mounted riders, as it specifically represents the character controlled by the player.

Variations in naming exist across APIs and languages. Some environments provide direct properties like Game.Player.Character, while others expose a function such as PLAYER_PED_ID() or a global PlayerPed handle. Regardless of naming, the concept centers on the entity that models the player’s in-game avatar.