@tlua/gmod 1.0.1

package/player.d.tlua

@@ -0,0 +1,3320 @@
+// AUTO-GENERATED tlua declarations. Do not edit by hand.
+
+/**
+ * Represents a player class.
+ *
+ * The player class hooks have one special field:
+ * * [Player](https://wiki.facepunch.com/gmod/Player) **Player** - The player for which a hook is called.
+ *
+ * **NOTE**: These hooks are used in [player_manager](https://wiki.facepunch.com/gmod/player_manager) this can't be [hooked](https://wiki.facepunch.com/gmod/hook.Add)
+ *
+ *
+ *
+ * @source https://wiki.facepunch.com/gmod/PLAYER_Hooks
+ */
+interface PLAYER {}
+
+/**
+ * This is a list of all methods only available for players. It is also possible to call [Entity](https://wiki.facepunch.com/gmod/Entity) functions on the Player.
+ * @source https://wiki.facepunch.com/gmod/Player
+ */
+interface Player extends Entity {}
+
+/**
+ * The player library is used to get the Lua objects that represent players in-game.
+ * @source https://wiki.facepunch.com/gmod/player(library)
+ */
+declare player: PlayerLib;
+
+interface PLAYER {
+    /**
+     * Called when the player's class was changed from this class.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:ClassChanged
+     */
+    ClassChanged(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called when the player dies
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PLAYER:Death
+     */
+    Death(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called from [GM:FinishMove](https://wiki.facepunch.com/gmod/GM:FinishMove).
+     *
+     * **WARNING**: This hook will not work if the current gamemode overrides [GM:FinishMove](https://wiki.facepunch.com/gmod/GM:FinishMove) and does not call this hook.
+     *
+     *
+     * **NOTE**: This hook is run after the [drive.FinishMove](https://wiki.facepunch.com/gmod/drive.FinishMove) has been called.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:FinishMove
+     */
+    FinishMove(self: PLAYER, mv: CMoveData): boolean;
+}
+
+interface PLAYER {
+    /**
+     * Called on player spawn to determine which hand model to use
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PLAYER:GetHandsModel
+     */
+    GetHandsModel(self: PLAYER): table;
+}
+
+interface PLAYER {
+    /**
+     * Called when the class object is created
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:Init
+     */
+    Init(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called on spawn to give the player their default loadout
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PLAYER:Loadout
+     */
+    Loadout(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called from [GM:Move](https://wiki.facepunch.com/gmod/GM:Move).
+     *
+     * **WARNING**: This hook will not work if the current gamemode overrides [GM:Move](https://wiki.facepunch.com/gmod/GM:Move) and does not call this hook.
+     *
+     *
+     * **NOTE**: This hook is run after the [drive.Move](https://wiki.facepunch.com/gmod/drive.Move) has been called.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:Move
+     */
+    Move(self: PLAYER, mv: CMoveData): boolean;
+}
+
+interface PLAYER {
+    /**
+     * Called after the viewmodel has been drawn
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/PLAYER:PostDrawViewModel
+     */
+    PostDrawViewModel(self: PLAYER, viewmodel: Entity, weapon: Entity): void;
+}
+
+interface PLAYER {
+    /**
+     * Called before the viewmodel is drawn
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/PLAYER:PreDrawViewModel
+     */
+    PreDrawViewModel(self: PLAYER, viewmodel: Entity, weapon: Entity): void;
+}
+
+interface PLAYER {
+    /**
+     * Called when we need to set player model from the class.
+     *
+     * **NOTE**: This will only be called if you have not overridden [GM:PlayerSetModel](https://wiki.facepunch.com/gmod/GM:PlayerSetModel) or call this function from it or anywhere else using [player_manager.RunClass](https://wiki.facepunch.com/gmod/player_manager.RunClass)
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PLAYER:SetModel
+     */
+    SetModel(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Setup the network table accessors.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:SetupDataTables
+     */
+    SetupDataTables(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called when the player spawns
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/PLAYER:Spawn
+     */
+    Spawn(self: PLAYER): void;
+}
+
+interface PLAYER {
+    /**
+     * Called from [GM:CreateMove](https://wiki.facepunch.com/gmod/GM:CreateMove).
+     *
+     * **WARNING**: This hook will not work if the current gamemode overrides [GM:SetupMove](https://wiki.facepunch.com/gmod/GM:SetupMove) and does not call this hook.
+     *
+     *
+     * **NOTE**: This hook is run after the [drive.StartMove](https://wiki.facepunch.com/gmod/drive.StartMove) has been called.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/PLAYER:StartMove
+     */
+    StartMove(self: PLAYER, mv: CMoveData, cmd: CUserCmd): boolean;
+}
+
+interface PLAYER {
+    /**
+     * Called when the player changes their weapon to another one causing their viewmodel model to change
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/PLAYER:ViewModelChanged
+     */
+    ViewModelChanged(self: PLAYER, viewmodel: Entity, old: string, _new: string): void;
+}
+
+interface Player {
+    /**
+     * Returns the player's AccountID part of their full SteamID.
+     *
+     * Since this does not include other vital parts of the SteamID such as "Account Type" and "Account Instance", it should be avoided, as AccountIDs are finite, and can theoretically be the same for multiple valid accounts.
+     *
+     * See [Player:SteamID](https://wiki.facepunch.com/gmod/Player:SteamID) for the text representation of the full SteamID.
+     * See [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) for a 64bit representation of the full SteamID.
+     *
+     * **NOTE**: In a `-multirun` environment, this will return `-1` for all "copies" of a player because they are not authenticated with Steam.
+     *
+     * For bots this will return values starting with `0` for the first bot, `1` for the second bot and so on.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AccountID
+     */
+    AccountID(self: Player): number;
+}
+
+interface Player {
+    /**
+     * **NOTE**: This function is only available in Sandbox and its derivatives.
+     * Adds an entity to the player's clean up list. This uses [cleanup.Add](https://wiki.facepunch.com/gmod/cleanup.Add) internally.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:AddCleanup
+     */
+    AddCleanup(self: Player, type: string, ent: Entity): void;
+}
+
+interface Player {
+    /**
+     * **NOTE**: This function is only available in Sandbox and its derivatives.
+     * Adds an entity to the player's list of entities of the same type. See [Player:GetCount](https://wiki.facepunch.com/gmod/Player:GetCount) to get the current count of entities of an entity type added with this function.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AddCount
+     */
+    AddCount(self: Player, str: string, ent: Entity): void;
+}
+
+interface Player {
+    /**
+     * Adds the provided amount to the player's death count.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:AddDeaths
+     */
+    AddDeaths(self: Player, count: number): void;
+}
+
+interface Player {
+    /**
+     * Adds the provided amount to the player's frag/kill count.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:AddFrags
+     */
+    AddFrags(self: Player, count: number): void;
+}
+
+interface Player {
+    /**
+     * Adds an entity to the player's list of frozen objects.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:AddFrozenPhysicsObject
+     */
+    AddFrozenPhysicsObject(self: Player, ent: Entity, physobj: PhysObj): void;
+}
+
+interface Player {
+    /**
+     * Sets up the voting system for the player.
+     * This is a really barebone system. By calling this a vote gets started, when the player presses 0-9 the callback function gets called along with the key the player pressed. Use the draw callback to draw the vote panel.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:AddPlayerOption
+     */
+    AddPlayerOption(self: Player, name: string, timeout: number, vote_callback: (voteNum: number) => boolean, draw_callback: function): void;
+}
+
+interface Player {
+    /**
+     * Plays a sequence directly from a sequence number, similar to [Player:AnimRestartGesture](https://wiki.facepunch.com/gmod/Player:AnimRestartGesture). This function has the advantage to play sequences that haven't been bound to an existing [Enums/ACT](https://wiki.facepunch.com/gmod/Enums/ACT)
+     * **WARNING**: This is not automatically networked. This function has to be called on the client to be seen by said client.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AddVCDSequenceToGestureSlot
+     */
+    AddVCDSequenceToGestureSlot(self: Player, slot: number, sequenceId: number, cycle: number, autokill?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets if the player can toggle their flashlight. Function exists on both the server and client but has no effect when ran on the client.
+     *
+     * This is a Lua method that internally uses [GM:PlayerSwitchFlashlight](https://wiki.facepunch.com/gmod/GM:PlayerSwitchFlashlight). If current gamemode overwrites that hook and doesn't respect [Player:CanUseFlashlight](https://wiki.facepunch.com/gmod/Player:CanUseFlashlight), this function will not have any effect.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AllowFlashlight
+     */
+    AllowFlashlight(self: Player, canFlashlight: boolean): void;
+}
+
+interface Player {
+    /**
+     * Lets the player spray their decal without delay
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:AllowImmediateDecalPainting
+     */
+    AllowImmediateDecalPainting(self: Player, allow: boolean): void;
+}
+
+interface Player {
+    /**
+     * Resets player gesture in selected slot.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AnimResetGestureSlot
+     */
+    AnimResetGestureSlot(self: Player, slot: number): void;
+}
+
+interface Player {
+    /**
+     * Restart a gesture on a player, within a gesture slot.
+     *
+     * **WARNING**: This is not automatically networked. This function has to be called on the client to be seen by said client.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AnimRestartGesture
+     */
+    AnimRestartGesture(self: Player, slot: number, activity: number, autokill?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Restarts the main animation on the player, has the same effect as calling [Entity:SetCycle](https://wiki.facepunch.com/gmod/Entity:SetCycle)( 0 ).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AnimRestartMainSequence
+     */
+    AnimRestartMainSequence(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Sets the sequence of the animation playing in the given gesture slot.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AnimSetGestureSequence
+     */
+    AnimSetGestureSequence(self: Player, slot: number, sequenceID: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the weight of the animation playing in the given gesture slot.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:AnimSetGestureWeight
+     */
+    AnimSetGestureWeight(self: Player, slot: number, weight: number): void;
+}
+
+interface Player {
+    /**
+     * Returns the player's armor.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Armor
+     */
+    Armor(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Bans the player from the server for a certain amount of minutes.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Ban
+     */
+    Ban(self: Player, minutes: number, kick?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Returns true if the player's flashlight hasn't been disabled by [Player:AllowFlashlight](https://wiki.facepunch.com/gmod/Player:AllowFlashlight).
+     *
+     * **NOTE**: This is not synchronized between clients and server automatically!
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:CanUseFlashlight
+     */
+    CanUseFlashlight(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Prints a string to the chatbox of the client.
+     *
+     * **WARNING**: Just like the [usermessage](https://wiki.facepunch.com/gmod/usermessage), this function is affected by the 255 byte limit!
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ChatPrint
+     */
+    ChatPrint(self: Player, message: string): void;
+}
+
+interface Player {
+    /**
+     * Checks if the limit of an entity type added by [Player:AddCount](https://wiki.facepunch.com/gmod/Player:AddCount) is hit or not. If it's hit, it will call the [GM:PlayerCheckLimit](https://wiki.facepunch.com/gmod/GM:PlayerCheckLimit) hook, and call [Player:LimitHit](https://wiki.facepunch.com/gmod/Player:LimitHit) if the hook doesn't return `false`.
+     *
+     * This will always return `true` in singleplayer, as singleplayer does not have limits.
+     *
+     * **NOTE**: This function is only available in Sandbox and its derivatives.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:CheckLimit
+     */
+    CheckLimit(self: Player, str: string): boolean;
+}
+
+interface Player {
+    /**
+     * Runs the concommand on the player. This does not work on bots. If used clientside, always runs the command on the local player.
+     *
+     * If you wish to directly modify the movement input of bots, use [GM:StartCommand](https://wiki.facepunch.com/gmod/GM:StartCommand) instead.
+     *
+     * **NOTE**: Some commands/convars are blocked from being run/changed using this function, usually to prevent harm/annoyance to clients. For a list of blocked commands, see [Blocked ConCommands](https://wiki.facepunch.com/gmod/Blocked_ConCommands).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ConCommand
+     */
+    ConCommand(self: Player, command: string): void;
+}
+
+interface Player {
+    /**
+     * Creates the player's death ragdoll entity and deletes the old one.
+     *
+     * This is normally used when a player dies, to create their death ragdoll.
+     *
+     * The ragdoll will be created with the player's properties such as [Position](https://wiki.facepunch.com/gmod/Entity:GetPos), [Angles](https://wiki.facepunch.com/gmod/Entity:GetAngles), [PlayerColor](https://wiki.facepunch.com/gmod/Player:GetPlayerColor), [Velocity](https://wiki.facepunch.com/gmod/Entity:GetVelocity) and [Model](https://wiki.facepunch.com/gmod/Entity:GetModel).
+     *
+     * You can retrieve the entity this creates with [Player:GetRagdollEntity](https://wiki.facepunch.com/gmod/Player:GetRagdollEntity).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:CreateRagdoll
+     */
+    CreateRagdoll(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Disables the default player's crosshair. Can be reenabled with [Player:CrosshairEnable](https://wiki.facepunch.com/gmod/Player:CrosshairEnable). This will affect [WEAPON:DoDrawCrosshair](https://wiki.facepunch.com/gmod/WEAPON:DoDrawCrosshair).
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:CrosshairDisable
+     */
+    CrosshairDisable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Enables the player's crosshair, if it was previously disabled via [Player:CrosshairDisable](https://wiki.facepunch.com/gmod/Player:CrosshairDisable).
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:CrosshairEnable
+     */
+    CrosshairEnable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is crouching or not ([FL_DUCKING](https://wiki.facepunch.com/gmod/Enums/FL) flag).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Crouching
+     */
+    Crouching(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the player's death count
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Deaths
+     */
+    Deaths(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Prints the players' name and position to the console.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DebugInfo
+     */
+    DebugInfo(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Detonates all tripmines belonging to the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DetonateTripmines
+     */
+    DetonateTripmines(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Disables world clicking for given player. See [Panel:SetWorldClicker](https://wiki.facepunch.com/gmod/Panel:SetWorldClicker) and [Player:IsWorldClickingDisabled](https://wiki.facepunch.com/gmod/Player:IsWorldClickingDisabled).
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DisableWorldClicking
+     */
+    DisableWorldClicking(self: Player, disable: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sends a third person animation event to the player.
+     *
+     * Calls [GM:DoAnimationEvent](https://wiki.facepunch.com/gmod/GM:DoAnimationEvent) with [PLAYERANIMEVENT_CUSTOM_GESTURE](https://wiki.facepunch.com/gmod/Enums/PLAYERANIMEVENT) as the event, data as the given data.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DoAnimationEvent
+     */
+    DoAnimationEvent(self: Player, data: number): void;
+}
+
+interface Player {
+    /**
+     * Starts the player's attack animation. The attack animation is determined by the weapon's HoldType.
+     *
+     * Similar to other animation event functions, calls [GM:DoAnimationEvent](https://wiki.facepunch.com/gmod/GM:DoAnimationEvent) with [PLAYERANIMEVENT_ATTACK_PRIMARY](https://wiki.facepunch.com/gmod/Enums/PLAYERANIMEVENT) as the event and no extra data.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DoAttackEvent
+     */
+    DoAttackEvent(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Sends a specified third person animation event to the player.
+     *
+     * Calls [GM:DoAnimationEvent](https://wiki.facepunch.com/gmod/GM:DoAnimationEvent) with specified arguments.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DoCustomAnimEvent
+     */
+    DoCustomAnimEvent(self: Player, event: number, data: number): void;
+}
+
+interface Player {
+    /**
+     * Sends a third person reload animation event to the player.
+     *
+     * Similar to other animation event functions, calls [GM:DoAnimationEvent](https://wiki.facepunch.com/gmod/GM:DoAnimationEvent) with [PLAYERANIMEVENT_RELOAD](https://wiki.facepunch.com/gmod/Enums/PLAYERANIMEVENT) as the event and no extra data.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DoReloadEvent
+     */
+    DoReloadEvent(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Sends a third person secondary fire animation event to the player.
+     *
+     * Similar to other animation event functions, calls [GM:DoAnimationEvent](https://wiki.facepunch.com/gmod/GM:DoAnimationEvent) with [PLAYERANIMEVENT_ATTACK_SECONDARY](https://wiki.facepunch.com/gmod/Enums/PLAYERANIMEVENT) as the event and no extra data.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DoSecondaryAttack
+     */
+    DoSecondaryAttack(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Show/Hide the player's weapon's viewmodel.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:DrawViewModel
+     */
+    DrawViewModel(self: Player, draw: boolean, vm?: number): void;
+}
+
+interface Player {
+    /**
+     * Show/Hide the player's weapon's worldmodel.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DrawWorldModel
+     */
+    DrawWorldModel(self: Player, draw: boolean): void;
+}
+
+interface Player {
+    /**
+     * Drops the players' weapon of a specific class.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DropNamedWeapon
+     */
+    DropNamedWeapon(self: Player, _class: string, target?: Vector, velocity?: Vector): void;
+}
+
+interface Player {
+    /**
+     * Drops any object the player is currently holding with either Gravity Gun, Physics Gun or `+use` (E key)
+     *
+     * See also [Entity:ForcePlayerDrop](https://wiki.facepunch.com/gmod/Entity:ForcePlayerDrop).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DropObject
+     */
+    DropObject(self: Player, entity?: Entity): void;
+}
+
+interface Player {
+    /**
+     * Forces the player to drop the specified weapon
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:DropWeapon
+     */
+    DropWeapon(self: Player, weapon?: Weapon, target?: Vector, velocity?: Vector): void;
+}
+
+interface Player {
+    /**
+     * Force puts the player into a specified vehicle.
+     * This **does not** bypass [GM:CanPlayerEnterVehicle](https://wiki.facepunch.com/gmod/GM:CanPlayerEnterVehicle).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:EnterVehicle
+     */
+    EnterVehicle(self: Player, vehicle: Vehicle): void;
+}
+
+interface Player {
+    /**
+     * Equips the player with the HEV suit.
+     *
+     * Allows the player to zoom, walk slowly, sprint, pickup armor batteries, use the health and armor stations and also shows the HUD.
+     * The player also emits a flatline sound on death, which can be overridden with [GM:PlayerDeathSound](https://wiki.facepunch.com/gmod/GM:PlayerDeathSound).
+     *
+     * The player is automatically equipped with the suit on spawn, if you wish to stop that, use [Player:RemoveSuit](https://wiki.facepunch.com/gmod/Player:RemoveSuit).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:EquipSuit
+     */
+    EquipSuit(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Forces the player off the current ladder if they are on one.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:ExitLadder
+     */
+    ExitLadder(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Forces the player to exit the vehicle if they're in one.
+     *
+     * This function will bypass [GM:CanExitVehicle](https://wiki.facepunch.com/gmod/GM:CanExitVehicle). See also [GM:PlayerLeaveVehicle](https://wiki.facepunch.com/gmod/GM:PlayerLeaveVehicle)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:ExitVehicle
+     */
+    ExitVehicle(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Enables/Disables the player's flashlight.
+     *
+     * [Player:CanUseFlashlight](https://wiki.facepunch.com/gmod/Player:CanUseFlashlight) must be true in order for the player's flashlight to be changed.
+     * [GM:PlayerSwitchFlashlight](https://wiki.facepunch.com/gmod/GM:PlayerSwitchFlashlight) can block this function.
+     *
+     * **NOTE**: Added in [2025.11.12](https://gmod.facepunch.com/changelist/4026), the `gmod_flashlight` attachment is used as a source for the player's flashlight. In thirdperson, the playermodel and weapon worldmodel are checked; in firstperson, the viewmodel is checked. If the attachment isn't found, default engine functionality is used.
+     *
+     * The light sprite attached to the playermodel when the flashlight is on will also follow the playermodel's `gmod_flashlight` attachment if it exists.
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Flashlight
+     */
+    Flashlight(self: Player, isOn: boolean): void;
+}
+
+interface Player {
+    /**
+     * Returns true if the player's flashlight is on.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:FlashlightIsOn
+     */
+    FlashlightIsOn(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the amount of frags a player has.
+     *
+     * **NOTE**: The value will change depending on the player's kill or suicide: +1 for a kill, -1 for a suicide.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Frags
+     */
+    Frags(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Freeze the player. Frozen players cannot move, look around, or attack. Key bindings are still called. Similar to [Player:Lock](https://wiki.facepunch.com/gmod/Player:Lock) but the player can still take damage.
+     *
+     * Manages the [FL_FROZEN](https://wiki.facepunch.com/gmod/Enums/FL#FL_FROZEN) flag on the player.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Freeze
+     */
+    Freeze(self: Player, frozen?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Returns the player's active weapon.
+     *
+     * If used on a [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer)() and the player is spectating another player with `OBS_MODE_IN_EYE`, the weapon returned will be of the spectated player.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetActiveWeapon
+     */
+    GetActiveWeapon(self: Player): Weapon;
+}
+
+interface Player {
+    /**
+     * Returns the player's current activity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:GetActivity
+     */
+    GetActivity(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the direction that the player is aiming.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAimVector
+     */
+    GetAimVector(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Returns true if the players' model is allowed to rotate around the pitch and roll axis.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAllowFullRotation
+     */
+    GetAllowFullRotation(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is allowed to use their weapons in a vehicle or not.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAllowWeaponsInVehicle
+     */
+    GetAllowWeaponsInVehicle(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns a table of all ammo the player has.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAmmo
+     */
+    GetAmmo(self: Player): table;
+}
+
+interface Player {
+    /**
+     * Gets the amount of ammo the player has.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAmmoCount
+     */
+    GetAmmoCount(self: Player, ammotype: any): number;
+}
+
+interface Player {
+    /**
+     * Gets if the player will be pushed out of nocollided players.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetAvoidPlayers
+     */
+    GetAvoidPlayers(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns true if the player is able to walk using the (default) alt key.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCanWalk
+     */
+    GetCanWalk(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Determines whenever the player is allowed to use the zoom functionality.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCanZoom
+     */
+    GetCanZoom(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the player's class id.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetClassID
+     */
+    GetClassID(self: Player): number;
+}
+
+interface Player {
+    /**
+     * **NOTE**: This function is only available in Sandbox and its derivatives.
+     * Gets the total amount of entities of an entity type added by [Player:AddCount](https://wiki.facepunch.com/gmod/Player:AddCount).
+     *
+     * Default types:
+     * ```
+     * balloons
+     * buttons
+     * cameras
+     * dynamite
+     * effects
+     * emitters
+     * hoverballs
+     * lamps
+     * lights
+     * npcs
+     * props
+     * ragdolls
+     * sents
+     * thrusters
+     * vehicles
+     * wheels
+     * ```
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCount
+     */
+    GetCount(self: Player, type: string, minus?: number): number;
+}
+
+interface Player {
+    /**
+     * Returns the crouched walk speed multiplier.
+     *
+     * See also [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed) and [Player:SetCrouchedWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetCrouchedWalkSpeed).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCrouchedWalkSpeed
+     */
+    GetCrouchedWalkSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the last command which was sent by the specified player. This can only be called on the player which [Global.GetPredictionPlayer](https://wiki.facepunch.com/gmod/Global.GetPredictionPlayer)() returns.
+     *
+     * **NOTE**: When called clientside in singleplayer during [WEAPON:Think](https://wiki.facepunch.com/gmod/WEAPON:Think), it will return nothing as the hook is not technically predicted in that instance. See the note on the page.
+     *
+     *
+     * This will fail in [GM:StartCommand](https://wiki.facepunch.com/gmod/GM:StartCommand).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCurrentCommand
+     */
+    GetCurrentCommand(self: Player): CUserCmd;
+}
+
+interface Player {
+    /**
+     * Gets the current applied view offset, which transitions between the player's standing and ducked view offset depending on their duck state.
+     *
+     * Do not confuse with [Player:GetViewOffset](https://wiki.facepunch.com/gmod/Player:GetViewOffset) and [Player:GetViewOffsetDucked](https://wiki.facepunch.com/gmod/Player:GetViewOffsetDucked), which always return the standing or ducked offset respectively.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetCurrentViewOffset
+     */
+    GetCurrentViewOffset(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Gets the entity the player is currently driving via the [drive](https://wiki.facepunch.com/gmod/drive) library.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetDrivingEntity
+     */
+    GetDrivingEntity(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns driving mode of the player. See [Entity Driving](https://wiki.facepunch.com/gmod/Entity_Driving).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetDrivingMode
+     */
+    GetDrivingMode(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns a player's duck speed (in seconds)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetDuckSpeed
+     */
+    GetDuckSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the entity the player is currently using, like func_tank mounted turrets or +use prop pickups.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetEntityInUse
+     */
+    GetEntityInUse(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns a table with information of what the player is looking at.
+     *
+     * The results of this function are **cached** clientside every frame.
+     *
+     * Uses [util.GetPlayerTrace](https://wiki.facepunch.com/gmod/util.GetPlayerTrace) internally and is therefore bound by its limits.
+     *
+     * See also [Player:GetEyeTraceNoCursor](https://wiki.facepunch.com/gmod/Player:GetEyeTraceNoCursor).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetEyeTrace
+     */
+    GetEyeTrace(self: Player): TraceResult;
+}
+
+interface Player {
+    /**
+     * Returns the trace according to the players view direction, ignoring their mouse (holding C and moving the mouse in Sandbox).
+     *
+     * The results of this function are **cached** clientside every frame.
+     *
+     * Uses [util.GetPlayerTrace](https://wiki.facepunch.com/gmod/util.GetPlayerTrace) internally and is therefore bound by its limits.
+     *
+     * See also [Player:GetEyeTrace](https://wiki.facepunch.com/gmod/Player:GetEyeTrace).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetEyeTraceNoCursor
+     */
+    GetEyeTraceNoCursor(self: Player): TraceResult;
+}
+
+interface Player {
+    /**
+     * Returns the FOV of the player.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetFOV
+     */
+    GetFOV(self: Player): number;
+}
+
+interface Player {
+    /**
+     * 		Returns the color of a player's flashlight.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:GetFlashlightColor
+     */
+    GetFlashlightColor(self: Player): Color;
+}
+
+interface Player {
+    /**
+     * Returns the steam "relationship" towards the player.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:GetFriendStatus
+     */
+    GetFriendStatus(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Gets the hands entity of a player
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetHands
+     */
+    GetHands(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the widget the player is hovering with their mouse.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetHoveredWidget
+     */
+    GetHoveredWidget(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * 		Retrieves the minimum and maximum [Vectors](https://wiki.facepunch.com/gmod/Vector) of the [Axis-Aligned Bounding Box (AABB)](https://en.wikipedia.org/wiki/Minimum_bounding_box) used for the [Player's](https://wiki.facepunch.com/gmod/Player) physics and movement [Hull Traces](https://wiki.facepunch.com/gmod/util.TraceHull).
+     *
+     * 		See also: [Player:SetHull](https://wiki.facepunch.com/gmod/Player:SetHull), [Player:SetHullDuck](https://wiki.facepunch.com/gmod/Player:SetHullDuck), [Player:GetHullDuck](https://wiki.facepunch.com/gmod/Player:GetHullDuck)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetHull
+     */
+    GetHull(self: Player): (Vector, Vector);
+}
+
+interface Player {
+    /**
+     * 		Retrieves the minimum and maximum [Vectors](https://wiki.facepunch.com/gmod/Vector) of the [Axis-Aligned Bounding Box (AABB)](https://en.wikipedia.org/wiki/Minimum_bounding_box) used for the [Player's](https://wiki.facepunch.com/gmod/Player) physics and movement [Hull Traces](https://wiki.facepunch.com/gmod/util.TraceHull) while they are crouching (or "Ducking").
+     *
+     * 		See also: [Player:SetHullDuck](https://wiki.facepunch.com/gmod/Player:SetHullDuck), [Player:GetHull](https://wiki.facepunch.com/gmod/Player:GetHull), [Player:SetHull](https://wiki.facepunch.com/gmod/Player:SetHull)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetHullDuck
+     */
+    GetHullDuck(self: Player): (Vector, Vector);
+}
+
+interface Player {
+    /**
+     * Retrieves the value of a client-side [ConVar](https://wiki.facepunch.com/gmod/ConVar). The [ConVar](https://wiki.facepunch.com/gmod/ConVar) must have a [FCVAR_USERINFO](https://wiki.facepunch.com/gmod/Enums/FCVAR) flag for this to work.
+     *
+     * On client this function will return value of the local player, regardless of which player the function was called on!
+     *
+     * See [Player:GetInfoNum](https://wiki.facepunch.com/gmod/Player:GetInfoNum) for the same function that automatically converts the string to a number.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetInfo
+     */
+    GetInfo(self: Player, cVarName: string): string;
+}
+
+interface Player {
+    /**
+     * Retrieves the numeric value of a client-side convar, returns nil if value is not convertible to a number. The [ConVar](https://wiki.facepunch.com/gmod/ConVar) must have a [FCVAR_USERINFO](https://wiki.facepunch.com/gmod/Enums/FCVAR) flag for this to work.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetInfoNum
+     */
+    GetInfoNum(self: Player, cVarName: string, _default: number): number;
+}
+
+interface Player {
+    /**
+     * Returns the jump power of the player
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetJumpPower
+     */
+    GetJumpPower(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the player's ladder climbing speed.
+     *
+     * See [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed) for normal walking speed, [Player:GetRunSpeed](https://wiki.facepunch.com/gmod/Player:GetRunSpeed) for sprinting speed and [Player:GetSlowWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetSlowWalkSpeed) for slow walking speed.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetLadderClimbSpeed
+     */
+    GetLadderClimbSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the timescale multiplier of the player movement.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetLaggedMovementValue
+     */
+    GetLaggedMovementValue(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the maximum amount of armor the player should have. Default value is 100.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetMaxArmor
+     */
+    GetMaxArmor(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the player's maximum movement speed.
+     *
+     * See also [Player:SetMaxSpeed](https://wiki.facepunch.com/gmod/Player:SetMaxSpeed), [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed) and [Player:GetRunSpeed](https://wiki.facepunch.com/gmod/Player:GetRunSpeed).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetMaxSpeed
+     */
+    GetMaxSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns whenever the player is set not to collide with their teammates.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetNoCollideWithTeammates
+     */
+    GetNoCollideWithTeammates(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the the observer mode of the player
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetObserverMode
+     */
+    GetObserverMode(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the entity the player is currently observing.
+     *
+     * Set using [Player:SpectateEntity](https://wiki.facepunch.com/gmod/Player:SpectateEntity).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetObserverTarget
+     */
+    GetObserverTarget(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns a **P**ersistent **Data** key-value pair from the SQL database. (`sv.db` when called on server, `cl.db` when called on client)
+     *
+     * Internally uses the [sql](https://wiki.facepunch.com/gmod/sql) library. See [util.GetPData](https://wiki.facepunch.com/gmod/util.GetPData) for cases when the player is not currently on the server.
+     *
+     * **NOTE**: This function internally uses [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64), it previously utilized [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) which can cause collisions (two or more players sharing the same PData entry). [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData) now replaces all instances of [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) with [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) when running [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData)
+     *
+     *
+     * **NOTE**: PData is not networked from servers to clients!
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPData
+     */
+    GetPData(self: Player, key: string, _default?: any): string;
+}
+
+interface Player {
+    /**
+     * Returns a player's character model color.
+     *
+     * The part of the model that is colored is determined by the model's materials, and is therefore different for each model.
+     *
+     * See [Player:GetWeaponColor](https://wiki.facepunch.com/gmod/Player:GetWeaponColor) for the accompanying function for the weapon color.
+     *
+     * **NOTE**: Override this function clientside on any Entity (including a player) with a supported model set (such as default player models) and returned color will apply to the model. This is done via the `PlayerColor` [matproxy](https://wiki.facepunch.com/gmod/matproxy).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPlayerColor
+     */
+    GetPlayerColor(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Returns a table containing player information.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPlayerInfo
+     */
+    GetPlayerInfo(self: Player): table;
+}
+
+interface Player {
+    /**
+     * Returns the widget entity the player is using.
+     *
+     * Having a pressed widget stops the player from firing their weapon to allow input to be passed onto the widget.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPressedWidget
+     */
+    GetPressedWidget(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the weapon the player previously had equipped.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPreviousWeapon
+     */
+    GetPreviousWeapon(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns players screen punch effect angle. See [Player:ViewPunch](https://wiki.facepunch.com/gmod/Player:ViewPunch) and [Player:SetViewPunchAngles](https://wiki.facepunch.com/gmod/Player:SetViewPunchAngles)
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetPunchAngle
+     * @deprecated You should use Player:GetViewPunchAngles instead.
+     */
+    GetPunchAngle(self: Player): Angle;
+}
+
+interface Player {
+    /**
+     * Returns players death ragdoll. The ragdoll is created by [Player:CreateRagdoll](https://wiki.facepunch.com/gmod/Player:CreateRagdoll).
+     * **NOTE**: Calling [Entity:GetPos](https://wiki.facepunch.com/gmod/Entity:GetPos) server-side with this function then will return the position where [Player:CreateRagdoll](https://wiki.facepunch.com/gmod/Player:CreateRagdoll) was used, as it is a hl2mp_ragdoll which is a serverside point entity that creates a clientside ragdoll for everyone (opposed to prop_ragdoll that is serverside and networks).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetRagdollEntity
+     */
+    GetRagdollEntity(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the player's sprint speed.
+     *
+     * See also [Player:SetRunSpeed](https://wiki.facepunch.com/gmod/Player:SetRunSpeed), [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed) and [Player:GetMaxSpeed](https://wiki.facepunch.com/gmod/Player:GetMaxSpeed).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetRunSpeed
+     */
+    GetRunSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the position of a Player's view
+     *
+     * **NOTE**: This is the same as calling [Entity:EyePos](https://wiki.facepunch.com/gmod/Entity:EyePos) on the player.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetShootPos
+     */
+    GetShootPos(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Returns the player's slow walking speed, which is activated via +WALK keybind.
+     *
+     * See [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed) for normal walking speed, [Player:GetRunSpeed](https://wiki.facepunch.com/gmod/Player:GetRunSpeed) for sprinting speed and [Player:GetLadderClimbSpeed](https://wiki.facepunch.com/gmod/Player:GetLadderClimbSpeed) for ladder climb speed.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetSlowWalkSpeed
+     */
+    GetSlowWalkSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the maximum height player can step onto.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetStepSize
+     */
+    GetStepSize(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the player's HEV suit power.
+     *
+     * This will only work for the local player when used clientside.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetSuitPower
+     */
+    GetSuitPower(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the number of seconds that the player has been timing out for. You can check if a player is timing out with [Player:IsTimingOut](https://wiki.facepunch.com/gmod/Player:IsTimingOut).
+     *
+     * **NOTE**: This function is relatively useless because it is tied to the value of the `sv_timeout` ConVar, which is irrelevant to the description above. [This is not considered as a bug](https://discord.com/channels/565105920414318602/567617926991970306/748970396224585738).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:GetTimeoutSeconds
+     */
+    GetTimeoutSeconds(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns [TOOL](https://wiki.facepunch.com/gmod/Structures/TOOL) table of players current tool, or of the one specified.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetTool
+     */
+    GetTool(self: Player, mode?: string): table;
+}
+
+interface Player {
+    /**
+     * Returns a player's unduck speed (in seconds)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetUnDuckSpeed
+     */
+    GetUnDuckSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the entity the player would use if they would press their `+use` keybind.
+     * 	**NOTE**: Because entity physics objects usually do not exist on the client, the client's use entity will resolve to whatever the crosshair is placed on within a little less than 72 units of the player's eye position. This differs from the entity returned by the server, which has fully physical use checking. See [util.TraceHull](https://wiki.facepunch.com/gmod/util.TraceHull).
+     *
+     * Issue tracker: [5027](https://github.com/Facepunch/garrysmod-issues/issues/5027)
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetUseEntity
+     */
+    GetUseEntity(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the player's user group. By default, player user groups are loaded from `garrysmod/settings/users.txt`.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetUserGroup
+     */
+    GetUserGroup(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns the vehicle the player is driving.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetVehicle
+     */
+    GetVehicle(self: Player): Vehicle;
+}
+
+interface Player {
+    /**
+     * Returns the entity the player is using to see from (such as the player itself, the camera, or another entity).
+     *
+     * 	**NOTE**: This function will return a [NULL Entity] until [Player:SetViewEntity](https://wiki.facepunch.com/gmod/Player:SetViewEntity) has been used.
+     *
+     * It will also not return the currently spectated entity. See [Player:GetObserverTarget](https://wiki.facepunch.com/gmod/Player:GetObserverTarget).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewEntity
+     */
+    GetViewEntity(self: Player): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the player's view model entity by the index.
+     * Each player has 3 view models by default, but only the first one is used.
+     *
+     * To use the other viewmodels in your SWEP, see [Entity:SetWeaponModel](https://wiki.facepunch.com/gmod/Entity:SetWeaponModel).
+     *
+     * **NOTE**: In the Client [realm](https://wiki.facepunch.com/gmod/States), other players' viewmodels are not available unless they are being spectated.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewModel
+     */
+    GetViewModel(self: Player, index?: number): Entity;
+}
+
+interface Player {
+    /**
+     * Returns the view offset of the player, which equals the difference between the player's actual position and their view when standing.
+     *
+     * See also [Player:GetViewOffsetDucked](https://wiki.facepunch.com/gmod/Player:GetViewOffsetDucked).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewOffset
+     */
+    GetViewOffset(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Returns the ducked view offset of the player, which equals the difference between the player's actual position and their view when ducked.
+     *
+     * See also [Player:GetViewOffset](https://wiki.facepunch.com/gmod/Player:GetViewOffset).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewOffsetDucked
+     */
+    GetViewOffsetDucked(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * Returns players screen punch effect angle.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewPunchAngles
+     */
+    GetViewPunchAngles(self: Player): Angle;
+}
+
+interface Player {
+    /**
+     * Returns client's view punch velocity. See [Player:ViewPunch](https://wiki.facepunch.com/gmod/Player:ViewPunch) and [Player:SetViewPunchVelocity](https://wiki.facepunch.com/gmod/Player:SetViewPunchVelocity)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetViewPunchVelocity
+     */
+    GetViewPunchVelocity(self: Player): Angle;
+}
+
+interface Player {
+    /**
+     * Returns the current voice volume scale for given player on client.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:GetVoiceVolumeScale
+     */
+    GetVoiceVolumeScale(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the player's normal walking speed. Not sprinting, not slow walking. (+walk)
+     *
+     * See also [Player:SetWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetWalkSpeed), [Player:GetMaxSpeed](https://wiki.facepunch.com/gmod/Player:GetMaxSpeed) and [Player:GetRunSpeed](https://wiki.facepunch.com/gmod/Player:GetRunSpeed).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetWalkSpeed
+     */
+    GetWalkSpeed(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the weapon for the specified class
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetWeapon
+     */
+    GetWeapon(self: Player, className: string): Weapon;
+}
+
+interface Player {
+    /**
+     * Returns a player's weapon color.
+     *
+     * The part of the model that is colored is determined by the model itself, and is different for each model.
+     *
+     * See [Player:GetPlayerColor](https://wiki.facepunch.com/gmod/Player:GetPlayerColor) for the accompanying function for the player character model color.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetWeaponColor
+     */
+    GetWeaponColor(self: Player): Vector;
+}
+
+interface Player {
+    /**
+     * 		Returns a table of the player's weapons.
+     * 		**NOTE**: This function returns a sequential table. Prefer to loop it with [Global.ipairs](https://wiki.facepunch.com/gmod/Global.ipairs) instead of the [Global.pairs](https://wiki.facepunch.com/gmod/Global.pairs) function.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:GetWeapons
+     */
+    GetWeapons(self: Player): table;
+}
+
+interface Player {
+    /**
+     * Gives the player a weapon.
+     *
+     * This function will call [GM:PlayerCanPickupWeapon](https://wiki.facepunch.com/gmod/GM:PlayerCanPickupWeapon). If that hook returns false, this function will do nothing.
+     *
+     * **NOTE**: While this function is meant for weapons/pickupables only, it is **not** restricted to weapons. Any entity can be spawned using this function, including NPCs and SENTs.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Give
+     */
+    Give(self: Player, weaponClassName: string, bNoAmmo?: boolean): Weapon;
+}
+
+interface Player {
+    /**
+     * Gives ammo to a player
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:GiveAmmo
+     */
+    GiveAmmo(self: Player, amount: number, type: string | number, hidePopup?: boolean): number;
+}
+
+interface Player {
+    /**
+     * Disables god mode on the player. Removes the [FL_GODMODE](https://wiki.facepunch.com/gmod/Enums/FL#FL_GODMODE) flag from the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:GodDisable
+     */
+    GodDisable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Enables god mode on the player. Adds the [FL_GODMODE](https://wiki.facepunch.com/gmod/Enums/FL#FL_GODMODE) flag to the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:GodEnable
+     */
+    GodEnable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns whether the player has god mode or not, contolled by [Player:GodEnable](https://wiki.facepunch.com/gmod/Player:GodEnable) and [Player:GodDisable](https://wiki.facepunch.com/gmod/Player:GodDisable).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:HasGodMode
+     */
+    HasGodMode(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns if the player has the specified weapon
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:HasWeapon
+     */
+    HasWeapon(self: Player, className: string): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the player's IP address and connection port in ip:port form
+     * **NOTE**: Returns `Error!` for bots.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:IPAddress
+     */
+    IPAddress(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns if the player is in a vehicle
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:InVehicle
+     */
+    InVehicle(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is an admin or not. It will also return `true` if the player is [Player:IsSuperAdmin](https://wiki.facepunch.com/gmod/Player:IsSuperAdmin) by default.
+     *
+     * Internally this is determined by [Player:IsUserGroup](https://wiki.facepunch.com/gmod/Player:IsUserGroup).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsAdmin
+     */
+    IsAdmin(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns if the player is an bot or not
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsBot
+     */
+    IsBot(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns true from the point when the player is sending client info but not fully in the game until they disconnect.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:IsConnected
+     */
+    IsConnected(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Used to find out if a player is currently 'driving' an entity (by which we mean 'right click > drive' ).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsDrivingEntity
+     */
+    IsDrivingEntity(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the players movement is currently frozen, controlled by [Player:Freeze](https://wiki.facepunch.com/gmod/Player:Freeze).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsFrozen
+     */
+    IsFrozen(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player identity was confirmed by the Steam network.
+     *
+     * See also [GM:NetworkIDValidated](https://wiki.facepunch.com/gmod/GM:NetworkIDValidated).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:IsFullyAuthenticated
+     */
+    IsFullyAuthenticated(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns if a player is the host of the current session.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsListenServerHost
+     */
+    IsListenServerHost(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether or not the player is voice muted locally.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:IsMuted
+     */
+    IsMuted(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns true if the player is playing a taunt.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsPlayingTaunt
+     */
+    IsPlayingTaunt(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whenever the player is heard by the local player clientside, or if the player is speaking serverside.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsSpeaking
+     */
+    IsSpeaking(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is currently sprinting or not, specifically if they are holding their sprint key and are allowed to sprint.
+     *
+     * This will not check if the player is currently sprinting into a wall. (i.e. holding their sprint key but not moving)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsSprinting
+     */
+    IsSprinting(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whenever the player is equipped with the suit item.
+     *
+     * This will only work for the local player when used clientside.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsSuitEquipped
+     */
+    IsSuitEquipped(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is a super admin.
+     *
+     * Internally this is determined by [Player:IsUserGroup](https://wiki.facepunch.com/gmod/Player:IsUserGroup). See also [Player:IsAdmin](https://wiki.facepunch.com/gmod/Player:IsAdmin).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsSuperAdmin
+     */
+    IsSuperAdmin(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns `true` if the player is timing out (i.e. is losing connection), `false` otherwise.
+     *
+     * A player is considered timing out when more than 4 seconds has elapsed since a network packet was received from given player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:IsTimingOut
+     */
+    IsTimingOut(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is typing in their chat.
+     *
+     * This may not work properly if the server uses a custom chatbox.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsTyping
+     */
+    IsTyping(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is in specified group or not. See [Player:GetUserGroup](https://wiki.facepunch.com/gmod/Player:GetUserGroup) for a way to get player's user group.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsUserGroup
+     */
+    IsUserGroup(self: Player, groupName: string): boolean;
+}
+
+interface Player {
+    /**
+     * Returns if the player can be heard by the local player.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:IsVoiceAudible
+     */
+    IsVoiceAudible(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns if the player currently walking. (`+walk` keybind)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsWalking
+     */
+    IsWalking(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the player is using the world clicking feature, see [Panel:SetWorldClicker](https://wiki.facepunch.com/gmod/Panel:SetWorldClicker)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsWorldClicking
+     */
+    IsWorldClicking(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether the world clicking is disabled for given player or not. See [Player:DisableWorldClicking](https://wiki.facepunch.com/gmod/Player:DisableWorldClicking).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:IsWorldClickingDisabled
+     */
+    IsWorldClickingDisabled(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Returns whether a key is down. This is not networked to other players, meaning only the local client can see the keys they are pressing.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:KeyDown
+     */
+    KeyDown(self: Player, key: number): boolean;
+}
+
+interface Player {
+    /**
+     * Gets whether a key was down one tick ago.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:KeyDownLast
+     */
+    KeyDownLast(self: Player, key: number): boolean;
+}
+
+interface Player {
+    /**
+     * Gets whether a key was just pressed this tick.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:KeyPressed
+     */
+    KeyPressed(self: Player, key: number): boolean;
+}
+
+interface Player {
+    /**
+     * Gets whether a key was just released this tick.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:KeyReleased
+     */
+    KeyReleased(self: Player, key: number): boolean;
+}
+
+interface Player {
+    /**
+     * Kicks the player from the server.
+     * **NOTE**: This can not be run before the player has fully joined in. Use [game.KickID](https://wiki.facepunch.com/gmod/game.KickID) for that.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Kick
+     */
+    Kick(self: Player, reason?: string): void;
+}
+
+interface Player {
+    /**
+     * Kills a player and calls [GM:PlayerDeath](https://wiki.facepunch.com/gmod/GM:PlayerDeath).
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Kill
+     */
+    Kill(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Kills a player without notifying the rest of the server.
+     *
+     * This will call [GM:PlayerSilentDeath](https://wiki.facepunch.com/gmod/GM:PlayerSilentDeath) instead of [GM:PlayerDeath](https://wiki.facepunch.com/gmod/GM:PlayerDeath).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:KillSilent
+     */
+    KillSilent(self: Player): void;
+}
+
+interface Player {
+    /**
+     * This allows the server to mitigate the lag of the player by moving back all the entities that can be lag compensated to the time the player attacked with his weapon.
+     *
+     * This technique is most commonly used on things that hit other entities instantaneously, such as traces.
+     *
+     * **NOTE**: [Entity:FireBullets](https://wiki.facepunch.com/gmod/Entity:FireBullets) calls this function internally.
+     *
+     *
+     * Lag compensation only works for players and entities that have been enabled with [Entity:SetLagCompensated](https://wiki.facepunch.com/gmod/Entity:SetLagCompensated)
+     *
+     * Despite being defined shared, it can only be used server-side in a [Predicted Hook](https://wiki.facepunch.com/gmod/~search?q=%3Cpredicted%3EYes).
+     *
+     * **WARNING**: This function NEEDS to be disabled after you're done with it or it will break the movement of the entities affected!
+     *
+     *
+     * Lag compensation does not support pose parameters.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:LagCompensation
+     */
+    LagCompensation(self: Player, lagCompensation: boolean): void;
+}
+
+interface Player {
+    /**
+     * Returns the hitgroup where the player was last hit.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:LastHitGroup
+     */
+    LastHitGroup(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Shows "limit hit" notification in sandbox.
+     * **NOTE**: This function is only available in Sandbox and its derivatives.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:LimitHit
+     */
+    LimitHit(self: Player, type: string): void;
+}
+
+interface Player {
+    /**
+     * Returns the direction a player is looking as a entity/local-oriented angle.
+     *
+     * Unlike [Entity:EyeAngles](https://wiki.facepunch.com/gmod/Entity:EyeAngles), this function does not include angles of the Player's [Entity:GetParent](https://wiki.facepunch.com/gmod/Entity:GetParent).
+     *
+     * Does not work correctly clientside for non local players when in a vehicle. (validate: when parented in general?)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:LocalEyeAngles
+     */
+    LocalEyeAngles(self: Player): Angle;
+}
+
+interface Player {
+    /**
+     * Stops a player from using any inputs, such as moving, turning, or attacking. Key binds are still called. Similar to [Player:Freeze](https://wiki.facepunch.com/gmod/Player:Freeze) but the player takes no damage.
+     *
+     * Adds the [FL_FROZEN](https://wiki.facepunch.com/gmod/Enums/FL) and [FL_GODMODE](https://wiki.facepunch.com/gmod/Enums/FL) flags to the player.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Lock
+     */
+    Lock(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns the position of a Kinect bone.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:MotionSensorPos
+     */
+    MotionSensorPos(self: Player, bone: number): Vector;
+}
+
+interface Player {
+    /**
+     * Returns the player's nick name. Identical to [Player:Nick](https://wiki.facepunch.com/gmod/Player:Nick) and [Player:GetName](https://wiki.facepunch.com/gmod/Player:GetName).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Name
+     * @deprecated Use Player:Nick.
+     */
+    Name(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns the player's nick name also known as display name, as it appears in Steam.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Nick
+     */
+    Nick(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns the 64-bit SteamID aka CommunityID of the Steam Account that owns the Garry's Mod license this player is using. This is useful for detecting players using Steam Family Sharing.
+     *
+     * If player is not using Steam Family Sharing, this will return the player's actual SteamID64().
+     *
+     * **NOTE**: This data will only be available after the player has fully authenticated with Steam. See [Player:IsFullyAuthenticated](https://wiki.facepunch.com/gmod/Player:IsFullyAuthenticated).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:OwnerSteamID64
+     */
+    OwnerSteamID64(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns the percentage of packets lost by the client. It is not networked so it only returns 0 when run clientside.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:PacketLoss
+     */
+    PacketLoss(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Unfreezes the props player is looking at. This is essentially the same as pressing reload with the physics gun, including double press for unfreeze all.
+     *
+     * For freezing props, use [PhysObj:EnableMotion](https://wiki.facepunch.com/gmod/PhysObj:EnableMotion).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:PhysgunUnfreeze
+     */
+    PhysgunUnfreeze(self: Player): number;
+}
+
+interface Player {
+    /**
+     * This makes the player hold (same as pressing E on a small prop) given entity.
+     *
+     * Not to be confused with picking up items like ammo or health kits.
+     *
+     * This picks up the passed entity regardless of its mass or distance from the player.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:PickupObject
+     */
+    PickupObject(self: Player, entity: Entity): void;
+}
+
+interface Player {
+    /**
+     * Forces the player to pickup an existing weapon entity. The player will not pick up the weapon if they already own a weapon of given type, or if the player could not normally have this weapon in their inventory.
+     *
+     * This function **will** bypass [GM:PlayerCanPickupWeapon](https://wiki.facepunch.com/gmod/GM:PlayerCanPickupWeapon).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:PickupWeapon
+     */
+    PickupWeapon(self: Player, wep: Weapon, ammoOnly?: boolean): boolean;
+}
+
+interface Player {
+    /**
+     * Returns the player's ping to server.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Ping
+     */
+    Ping(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Plays the correct step sound according to what the player is staying on.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:PlayStepSound
+     */
+    PlayStepSound(self: Player, volume?: number): void;
+}
+
+interface Player {
+    /**
+     * Displays a message either in their chat, console, or center of the screen. See also [Global.PrintMessage](https://wiki.facepunch.com/gmod/Global.PrintMessage).
+     *
+     * **NOTE**: When called serverside, this uses the archaic user message system (the [umsg](https://wiki.facepunch.com/gmod/umsg)) and hence is limited to ≈250 characters.
+     *
+     * `HUD_PRINTCENTER` will not work when this is called clientside.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:PrintMessage
+     */
+    PrintMessage(self: Player, type: number, message: string): void;
+}
+
+interface Player {
+    /**
+     * Removes all ammo from a certain player
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:RemoveAllAmmo
+     */
+    RemoveAllAmmo(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Removes all weapons and ammo from the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:RemoveAllItems
+     */
+    RemoveAllItems(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Removes the amount of the specified ammo from the player.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:RemoveAmmo
+     */
+    RemoveAmmo(self: Player, ammoCount: number, ammoName: string | number): void;
+}
+
+interface Player {
+    /**
+     * Removes a **P**ersistent **Data** key-value pair from the SQL database. (`sv.db` when called on server, `cl.db` when called on client)
+     *
+     * Internally uses the [sql](https://wiki.facepunch.com/gmod/sql) library. See [util.RemovePData](https://wiki.facepunch.com/gmod/util.RemovePData) for cases when the player is not currently on the server.
+     *
+     * **NOTE**: This function internally uses [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64), it previously utilized [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) which can cause collisions (two or more players sharing the same PData entry). [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData) now replaces all instances of [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) with [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) when running [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData)
+     *
+     * **NOTE**: PData is not networked from servers to clients!
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:RemovePData
+     */
+    RemovePData(self: Player, key: string): boolean;
+}
+
+interface Player {
+    /**
+     * Strips the player's suit item.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:RemoveSuit
+     */
+    RemoveSuit(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Resets both normal and duck hulls to their default values.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ResetHull
+     */
+    ResetHull(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Forces the player to say whatever the first argument is. Works on bots too.
+     *
+     * **NOTE**: This function ignores the default chat message cooldown
+     *
+     * **WARNING**: The argument can only contain 126 characters. [Source SDK 2013](https://github.com/ValveSoftware/source-sdk-2013/blob/0d8dceea4310fde5706b3ce1c70609d72a38efdf/sp/src/game/server/client.cpp#L84-L86)
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Say
+     */
+    Say(self: Player, text: string, teamOnly?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Fades the screen
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ScreenFade
+     */
+    ScreenFade(self: Player, flags: number, color?: Color, fadeTime?: number, fadeHold?: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the active weapon of the player by its class name.
+     *
+     * **WARNING**: This will switch the weapon out of prediction, causing delay on the client and [WEAPON:Deploy](https://wiki.facepunch.com/gmod/WEAPON:Deploy) and [WEAPON:Holster](https://wiki.facepunch.com/gmod/WEAPON:Holster) to be called out of prediction. Try using [CUserCmd:SelectWeapon](https://wiki.facepunch.com/gmod/CUserCmd:SelectWeapon) or [input.SelectWeapon](https://wiki.facepunch.com/gmod/input.SelectWeapon), instead.
+     *
+     *
+     * **NOTE**: This will trigger the weapon switch event and associated animations. To switch weapons silently, use [Player:SetActiveWeapon](https://wiki.facepunch.com/gmod/Player:SetActiveWeapon).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SelectWeapon
+     */
+    SelectWeapon(self: Player, className: string): void;
+}
+
+interface Player {
+    /**
+     * Sends a hint to a player.
+     *
+     * **NOTE**: This function is only available in Sandbox and its derivatives. Since this adds `#Hint_` to the beginning of each message, you should only use it with default hint messages, or those cached with [language.Add](https://wiki.facepunch.com/gmod/language.Add). For hints with custom text, look at [notification.AddLegacy](https://wiki.facepunch.com/gmod/notification.AddLegacy).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SendHint
+     */
+    SendHint(self: Player, name: string, delay: number): void;
+}
+
+interface Player {
+    /**
+     * Executes a simple Lua string on the player.
+     * **NOTE**: If you need to use this function more than once consider using [net](https://wiki.facepunch.com/gmod/net) library. Send net message and make the entire code you want to execute in [net.Receive](https://wiki.facepunch.com/gmod/net.Receive) on client.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SendLua
+     */
+    SendLua(self: Player, script: string): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's active weapon. You should use [CUserCmd:SelectWeapon](https://wiki.facepunch.com/gmod/CUserCmd:SelectWeapon) or [Player:SelectWeapon](https://wiki.facepunch.com/gmod/Player:SelectWeapon), instead in most cases.
+     *
+     * This function will not trigger the weapon switch events or associated equip animations. It will bypass
+     *  [GM:PlayerSwitchWeapon](https://wiki.facepunch.com/gmod/GM:PlayerSwitchWeapon) and the currently active weapon's [WEAPON:Holster](https://wiki.facepunch.com/gmod/WEAPON:Holster) return value.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetActiveWeapon
+     */
+    SetActiveWeapon(self: Player, weapon: Weapon): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's activity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetActivity
+     */
+    SetActivity(self: Player, act: number): void;
+}
+
+interface Player {
+    /**
+     * Set if the players' model is allowed to rotate around the pitch and roll axis.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetAllowFullRotation
+     */
+    SetAllowFullRotation(self: Player, Allowed: boolean): void;
+}
+
+interface Player {
+    /**
+     * Allows player to use their weapons in a vehicle. You need to call this before entering a vehicle.
+     *
+     * Shooting in a vehicle fires two bullets.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetAllowWeaponsInVehicle
+     */
+    SetAllowWeaponsInVehicle(self: Player, allow: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets the amount of the specified ammo for the player.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetAmmo
+     */
+    SetAmmo(self: Player, ammoCount: number, ammoType: any): void;
+}
+
+interface Player {
+    /**
+     * Sets the player armor value.
+     *
+     * See [GM:HandlePlayerArmorReduction](https://wiki.facepunch.com/gmod/GM:HandlePlayerArmorReduction) for a hook that allows manipulating what armor does.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetArmor
+     */
+    SetArmor(self: Player, amount: number): void;
+}
+
+interface Player {
+    /**
+     * Pushes the player away from other players whenever the player inside another players' bounding box.
+     *
+     * This avoidance is performed clientside by altering movement sent to server.
+     *
+     * This applies to players within a single team. ([Player:Team](https://wiki.facepunch.com/gmod/Player:Team))
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetAvoidPlayers
+     */
+    SetAvoidPlayers(self: Player, avoidPlayers: boolean): void;
+}
+
+interface Player {
+    /**
+     * Set if the player should be allowed to walk using the (default) alt key. (`+walk` keybind)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetCanWalk
+     */
+    SetCanWalk(self: Player, canWalk: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets whether the player can use the HL2 suit zoom (`+zoom` bind) or not.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetCanZoom
+     */
+    SetCanZoom(self: Player, canZoom: boolean): void;
+}
+
+interface Player {
+    /**
+     * **INTERNAL**: Use [player_manager.SetPlayerClass](https://wiki.facepunch.com/gmod/player_manager.SetPlayerClass) instead.
+     *
+     *
+     * Sets the player's class id.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetClassID
+     */
+    SetClassID(self: Player, classID: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the crouched walk speed multiplier.
+     *
+     * Has no effect for values above 1.
+     *
+     * See also [Player:SetWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetWalkSpeed) and [Player:GetCrouchedWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetCrouchedWalkSpeed).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetCrouchedWalkSpeed
+     */
+    SetCrouchedWalkSpeed(self: Player, speed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the **actual** view offset which equals the difference between the players actual position and their view when standing.
+     *
+     * Do not confuse with [Player:SetViewOffset](https://wiki.facepunch.com/gmod/Player:SetViewOffset) and [Player:SetViewOffsetDucked](https://wiki.facepunch.com/gmod/Player:SetViewOffsetDucked)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetCurrentViewOffset
+     */
+    SetCurrentViewOffset(self: Player, viewOffset: Vector): void;
+}
+
+interface Player {
+    /**
+     * Activates a given DSP (Digital Signal Processor) effect on all sounds that
+     * the player hears. Equivalent to setting the `dsp_player` convar on the player.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetDSP
+     */
+    SetDSP(self: Player, dspEffectId: number, fastReset?: boolean): void;
+}
+
+
+interface Player {
+    /**
+     * Sets a player's death count
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetDeaths
+     */
+    SetDeaths(self: Player, deathCount: number): void;
+}
+
+interface Player {
+    /**
+     * **INTERNAL**: This is used internally - although you're able to use it you probably shouldn't.
+     *
+     * Sets the driving entity and driving mode.
+     *
+     * Use [drive.PlayerStartDriving](https://wiki.facepunch.com/gmod/drive.PlayerStartDriving) instead, see [Entity Driving](https://wiki.facepunch.com/gmod/Entity_Driving).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetDrivingEntity
+     */
+    SetDrivingEntity(self: Player, drivingEntity?: Entity, drivingMode?: number): void;
+}
+
+interface Player {
+    /**
+     * Sets how quickly a player ducks.
+     *
+     * This will not work for values >= 1.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetDuckSpeed
+     */
+    SetDuckSpeed(self: Player, duckSpeed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the local angle of the player's view (may rotate body too if angular difference is large)
+     *
+     * **NOTE**: This function works differently when the player is in a vehicle. In that case passing `Angle(0, 90, 0)` will have the player look forward (out the windshield) and `Angle(0, 0, 0)` will have them look to the right.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetEyeAngles
+     */
+    SetEyeAngles(self: Player, angle: Angle): void;
+}
+
+interface Player {
+    /**
+     * Set a player's FOV (Field Of View) over a certain amount of time.
+     *
+     * This is meant to be called on the server or shared (for prediction), it will have no effect if called clientside only. You may want to use [GM:CalcView](https://wiki.facepunch.com/gmod/GM:CalcView) for that instead.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetFOV
+     */
+    SetFOV(self: Player, fov: number, time?: number, requester?: Entity): void;
+}
+
+interface Player {
+    /**
+     * 		Sets the color of a player's flashlight.
+     * 		Can be used on other players.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:SetFlashlightColor
+     */
+    SetFlashlightColor(self: Player, color?: Color): void;
+}
+
+interface Player {
+    /**
+     * Sets a player's frags (kills)
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetFrags
+     */
+    SetFrags(self: Player, fragCount: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the hands entity of a player.
+     *
+     * The hands entity is an entity introduced in Garry's Mod 13 and it's used to show the player's hands attached to the viewmodel.
+     * This is similar to the approach used in L4D and CS:GO, for more information on how to implement this system in your gamemode visit [Using Viewmodel Hands](https://wiki.facepunch.com/gmod/Using_Viewmodel_Hands).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetHands
+     */
+    SetHands(self: Player, hands: Entity): void;
+}
+
+interface Player {
+    /**
+     * Sets the widget that is currently hovered by the player's mouse.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetHoveredWidget
+     */
+    SetHoveredWidget(self: Player, widget?: Entity): void;
+}
+
+interface Player {
+    /**
+     * 		Sets the size of the [Player's](https://wiki.facepunch.com/gmod/Player) [Axis-Aligned Bounding Box (AABB)](https://en.wikipedia.org/wiki/Minimum_bounding_box) used for physics and movement [Hull Traces](https://wiki.facepunch.com/gmod/util.TraceHull).
+     *
+     * 		See also: [Player:GetHull](https://wiki.facepunch.com/gmod/Player:GetHull), [Player:SetHullDuck](https://wiki.facepunch.com/gmod/Player:SetHullDuck), [Player:GetHullDuck](https://wiki.facepunch.com/gmod/Player:GetHullDuck)
+     *
+     * 		**NOTE**: This value is **not** replicated automatically to clients and must be manually called in both the Server and Client [Realms](https://wiki.facepunch.com/gmod/States).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetHull
+     */
+    SetHull(self: Player, mins: Vector, maxs: Vector): void;
+}
+
+interface Player {
+    /**
+     * 		Sets the size of the [Player's](https://wiki.facepunch.com/gmod/Player) [Axis-Aligned Bounding Box (AABB)](https://en.wikipedia.org/wiki/Minimum_bounding_box) used for physics and movement [Hull Traces](https://wiki.facepunch.com/gmod/util.TraceHull) while they are crouching (or "Ducking").
+     *
+     * 		See also: [Player:GetHullDuck](https://wiki.facepunch.com/gmod/Player:GetHullDuck), [Player:GetHull](https://wiki.facepunch.com/gmod/Player:GetHull), [Player:SetHull](https://wiki.facepunch.com/gmod/Player:SetHull)
+     *
+     * 		**NOTE**: This value is **not** replicated automatically to clients and must be manually called in both the Server and Client [Realms](https://wiki.facepunch.com/gmod/States).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetHullDuck
+     */
+    SetHullDuck(self: Player, mins: Vector, maxs: Vector): void;
+}
+
+interface Player {
+    /**
+     * Sets the jump power, eg. the velocity that will be applied to the player when they jump.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetJumpPower
+     */
+    SetJumpPower(self: Player, jumpPower: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's ladder climbing speed.
+     *
+     * See [Player:SetWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetWalkSpeed) for normal walking speed, [Player:SetRunSpeed](https://wiki.facepunch.com/gmod/Player:SetRunSpeed) for sprinting speed and [Player:SetSlowWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetSlowWalkSpeed) for slow walking speed.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetLadderClimbSpeed
+     */
+    SetLadderClimbSpeed(self: Player, speed: number): void;
+}
+
+interface Player {
+    /**
+     * Slows down the player movement simulation by the timescale, this is used internally in the HL2 weapon stripping sequence.
+     *
+     * It achieves such behavior by multiplying the [Global.FrameTime](https://wiki.facepunch.com/gmod/Global.FrameTime) by the specified timescale at the start of the movement simulation and then restoring it afterwards.
+     *
+     * **NOTE**: This is reset to 1 on spawn.
+     *
+     * There is no weapon counterpart to this, you'll have to hardcode the multiplier in the weapon or call [Weapon:SetNextPrimaryFire](https://wiki.facepunch.com/gmod/Weapon:SetNextPrimaryFire) / [Weapon:SetNextSecondaryFire](https://wiki.facepunch.com/gmod/Weapon:SetNextSecondaryFire) manually.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetLaggedMovementValue
+     */
+    SetLaggedMovementValue(self: Player, timescale: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the hitgroup where the player was last hit.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetLastHitGroup
+     */
+    SetLastHitGroup(self: Player, hitgroup: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the maximum amount of armor the player should have. This affects default built-in armor pickups, but not [Player:SetArmor](https://wiki.facepunch.com/gmod/Player:SetArmor).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetMaxArmor
+     */
+    SetMaxArmor(self: Player, maxarmor: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the maximum speed which the player can move at.
+     *
+     * **NOTE**: This is called automatically by the engine. If you wish to limit player speed without setting their run/sprint speeds, see [CMoveData:SetMaxClientSpeed](https://wiki.facepunch.com/gmod/CMoveData:SetMaxClientSpeed).
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetMaxSpeed
+     */
+    SetMaxSpeed(self: Player, walkSpeed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets if the player should be voicechat muted locally.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:SetMuted
+     */
+    SetMuted(self: Player, mute: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets whenever the player should not collide with their teammates, based on their [Player:Team](https://wiki.facepunch.com/gmod/Player:Team).
+     *
+     * **NOTE**: This will only work for teams with ID 1 to 4 due to internal Engine limitations.
+     *
+     * **NOTE**: This causes traces with [COLLISION_GROUP_PLAYER](https://wiki.facepunch.com/gmod/Enums/COLLISION_GROUP) to pass through players.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetNoCollideWithTeammates
+     */
+    SetNoCollideWithTeammates(self: Player, shouldNotCollide: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets the players visibility towards NPCs.
+     *
+     * Internally this toggles the [FL_NOTARGET](https://wiki.facepunch.com/gmod/Enums/FL) flag, which you can manually test for using [Entity:IsFlagSet](https://wiki.facepunch.com/gmod/Entity:IsFlagSet)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetNoTarget
+     */
+    SetNoTarget(self: Player, visibility: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets the players observer mode. You must start the spectating first with [Player:Spectate](https://wiki.facepunch.com/gmod/Player:Spectate).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetObserverMode
+     */
+    SetObserverMode(self: Player, mode: number): void;
+}
+
+interface Player {
+    /**
+     * Writes a **P**ersistent **Data** key-value pair to the SQL database. (`sv.db` when called on server, `cl.db` when called on client)
+     *
+     * Internally uses the [sql](https://wiki.facepunch.com/gmod/sql) library. See [util.SetPData](https://wiki.facepunch.com/gmod/util.SetPData) for cases when the player is not currently on the server.
+     *
+     * **NOTE**: This function internally uses [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64), it previously utilized [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) which could have caused collisions (two or more players sharing the same PData entry). [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData) now replaces all instances of [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) with [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) when running [Player:SetPData](https://wiki.facepunch.com/gmod/Player:SetPData)
+     *
+     *
+     * **NOTE**: PData is not networked from servers to clients!
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetPData
+     */
+    SetPData(self: Player, key: string, value: any): boolean;
+}
+
+interface Player {
+    /**
+     * Sets the player model's color. The part of the model that is colored is determined by the model itself, and is different for each model.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetPlayerColor
+     */
+    SetPlayerColor(self: Player, Color: Vector): void;
+}
+
+interface Player {
+    /**
+     * Sets the widget that is currently in use by the player's mouse.
+     *
+     * Having a pressed widget stops the player from firing their weapon to allow input to be passed onto the widget.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetPressedWidget
+     */
+    SetPressedWidget(self: Player, pressedWidget?: Entity): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's sprint speed.
+     *
+     * See also [Player:GetRunSpeed](https://wiki.facepunch.com/gmod/Player:GetRunSpeed), [Player:SetWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetWalkSpeed) and [Player:SetMaxSpeed](https://wiki.facepunch.com/gmod/Player:SetMaxSpeed).
+     * **NOTE**: player_default class run speed is: `400`
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetRunSpeed
+     */
+    SetRunSpeed(self: Player, runSpeed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's slow walking speed, which is activated via +WALK keybind.
+     *
+     * See [Player:SetWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetWalkSpeed) for normal walking speed, [Player:SetRunSpeed](https://wiki.facepunch.com/gmod/Player:SetRunSpeed) for sprinting speed and [Player:SetLadderClimbSpeed](https://wiki.facepunch.com/gmod/Player:SetLadderClimbSpeed) for ladder climb speed.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetSlowWalkSpeed
+     */
+    SetSlowWalkSpeed(self: Player, speed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the maximum height a player can step onto without jumping.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetStepSize
+     */
+    SetStepSize(self: Player, stepHeight: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's HEV suit power.
+     *
+     * This will only work for the local player when used clientside.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetSuitPower
+     */
+    SetSuitPower(self: Player, power: number): void;
+}
+
+interface Player {
+    /**
+     * Sets whenever to suppress the pickup notification for the player.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetSuppressPickupNotices
+     */
+    SetSuppressPickupNotices(self: Player, doSuppress: boolean): void;
+}
+
+interface Player {
+    /**
+     * Sets the player to the chosen team. The value is networked to clients at reduced bit count (16 bits) as as a signed value, so the real range is [-32768, 32767].
+     *
+     * Can be retrieved via [Player:Team](https://wiki.facepunch.com/gmod/Player:Team)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetTeam
+     */
+    SetTeam(self: Player, team: number): void;
+}
+
+interface Player {
+    /**
+     * Sets how quickly a player un-ducks
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetUnDuckSpeed
+     */
+    SetUnDuckSpeed(self: Player, UnDuckSpeed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the usergroup of the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetUserGroup
+     */
+    SetUserGroup(self: Player, groupName: string): void;
+}
+
+interface Player {
+    /**
+     * Attaches the players view to the position and angles of the specified entity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetViewEntity
+     */
+    SetViewEntity(self: Player, viewEntity: Entity): void;
+}
+
+interface Player {
+    /**
+     * Sets the **desired** view offset which equals the difference between the players actual position and their view when standing.
+     *
+     * If you want to set **actual** view offset, use [Player:SetCurrentViewOffset](https://wiki.facepunch.com/gmod/Player:SetCurrentViewOffset)
+     *
+     * See also [Player:SetViewOffsetDucked](https://wiki.facepunch.com/gmod/Player:SetViewOffsetDucked) for **desired** view offset when crouching.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetViewOffset
+     */
+    SetViewOffset(self: Player, viewOffset: Vector): void;
+}
+
+interface Player {
+    /**
+     * Sets the **desired** view offset which equals the difference between the players actual position and their view when crouching.
+     *
+     * If you want to set **actual** view offset, use [Player:SetCurrentViewOffset](https://wiki.facepunch.com/gmod/Player:SetCurrentViewOffset)
+     *
+     * See also [Player:SetViewOffset](https://wiki.facepunch.com/gmod/Player:SetViewOffset) for **desired** view offset when standing.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetViewOffsetDucked
+     */
+    SetViewOffsetDucked(self: Player, viewOffset: Vector): void;
+}
+
+interface Player {
+    /**
+     * Sets client's view punch angle, but not the velocity. See [Player:ViewPunch](https://wiki.facepunch.com/gmod/Player:ViewPunch)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetViewPunchAngles
+     */
+    SetViewPunchAngles(self: Player, punchAngle: Angle): void;
+}
+
+interface Player {
+    /**
+     * Sets client's view punch velocity. See [Player:ViewPunch](https://wiki.facepunch.com/gmod/Player:ViewPunch) and [Player:SetViewPunchAngles](https://wiki.facepunch.com/gmod/Player:SetViewPunchAngles)
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetViewPunchVelocity
+     */
+    SetViewPunchVelocity(self: Player, punchVel: Angle): void;
+}
+
+interface Player {
+    /**
+     * Sets the voice volume scale for given player on client. This value will persist from server to server, but will be reset when the game is shut down.
+     *
+     * **NOTE**: This doesn't work on bots, their scale will always be `1`. Does not work with multiruns.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:SetVoiceVolumeScale
+     */
+    SetVoiceVolumeScale(self: Player, arg0: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the player's normal walking speed. Not sprinting, not slow walking +walk.
+     *
+     * See also [Player:SetSlowWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetSlowWalkSpeed), [Player:GetWalkSpeed](https://wiki.facepunch.com/gmod/Player:GetWalkSpeed), [Player:SetCrouchedWalkSpeed](https://wiki.facepunch.com/gmod/Player:SetCrouchedWalkSpeed), [Player:SetMaxSpeed](https://wiki.facepunch.com/gmod/Player:SetMaxSpeed) and [Player:SetRunSpeed](https://wiki.facepunch.com/gmod/Player:SetRunSpeed).
+     *
+     * Using a speed of `0` can lead to prediction errors, and can cause players to move at sv_maxvelocity
+     *
+     * **NOTE**: `player_default` class walk speed is: `200`.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetWalkSpeed
+     */
+    SetWalkSpeed(self: Player, walkSpeed: number): void;
+}
+
+interface Player {
+    /**
+     * Sets the player weapon's color. The part of the model that is colored is determined by the model itself, and is different for each model.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SetWeaponColor
+     */
+    SetWeaponColor(self: Player, Color: Vector): void;
+}
+
+interface Player {
+    /**
+     * Sets up the player's hands for the viewmodel. Calls [GM:PlayerSetHandsModel](https://wiki.facepunch.com/gmod/GM:PlayerSetHandsModel) to determine the model. If no entity is provided, uses the player's own hands model. If spectating another entity, pass that entity to use its hands model instead.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SetupHands
+     */
+    SetupHands(self: Player, ent?: Entity): void;
+}
+
+interface Player {
+    /**
+     * Returns whether the **local player's** player model will be drawn at the time the function is called.
+     *
+     * Despite this being a method on a player object, this will always represent the state of the [local player](https://wiki.facepunch.com/gmod/Global.LocalPlayer), not of the player entity this method is used on.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:ShouldDrawLocalPlayer
+     */
+    ShouldDrawLocalPlayer(self: Player): boolean;
+}
+
+interface Player {
+    /**
+     * Sets whether the player's current weapon should drop on death.
+     *
+     * **NOTE**: This is reset on spawn to the [player class](https://wiki.facepunch.com/gmod/Player_Classes)'s **DropWeaponOnDie** field by [player_manager.OnPlayerSpawn](https://wiki.facepunch.com/gmod/player_manager.OnPlayerSpawn).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:ShouldDropWeapon
+     */
+    ShouldDropWeapon(self: Player, drop: boolean): void;
+}
+
+interface Player {
+    /**
+     * Opens the player steam profile page in the steam overlay browser.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:ShowProfile
+     */
+    ShowProfile(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Signals the entity that it was dropped by the gravity gun.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SimulateGravGunDrop
+     */
+    SimulateGravGunDrop(self: Player, ent: Entity): void;
+}
+
+interface Player {
+    /**
+     * Signals the entity that it was picked up by the gravity gun. This call is only required if you want to simulate the situation of picking up objects.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SimulateGravGunPickup
+     */
+    SimulateGravGunPickup(self: Player, ent: Entity, lightning?: boolean): void;
+}
+
+interface Player {
+    /**
+     * Starts spectate mode for given player. This will also affect the players movetype in some cases.
+     *
+     * [Player:UnSpectate](https://wiki.facepunch.com/gmod/Player:UnSpectate) should be used to remove the player from spectate mode, or call this with `OBS_MODE_NONE`.
+     *
+     * The player must be respawned, otherwise they will be able to walk through doors and become invincible. This will be fixed in a future update.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:Spectate
+     */
+    Spectate(self: Player, mode: OBS_MODE): void;
+}
+
+interface Player {
+    /**
+     * Makes the player spectate the entity.
+     *
+     * To get the applied spectated entity, use [Player:GetObserverTarget](https://wiki.facepunch.com/gmod/Player:GetObserverTarget).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SpectateEntity
+     */
+    SpectateEntity(self: Player, entity: Entity): void;
+}
+
+interface Player {
+    /**
+     * Makes a player spray their decal.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SprayDecal
+     */
+    SprayDecal(self: Player, sprayOrigin: Vector, sprayEndPos: Vector): void;
+}
+
+interface Player {
+    /**
+     * Disables the sprint on the player.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SprintDisable
+     */
+    SprintDisable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Enables the sprint on the player.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SprintEnable
+     */
+    SprintEnable(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Doesn't appear to do anything.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:StartSprinting
+     * @deprecated This appears to be a direct binding to internal functionality that is overridden by the engine every frame so calling these functions may not have any or expected effect.
+     */
+    StartSprinting(self: Player): void;
+}
+
+interface Player {
+    /**
+     * When used in a [GM:SetupMove](https://wiki.facepunch.com/gmod/GM:SetupMove) hook, this function will force the player to walk, as well as preventing the player from sprinting.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:StartWalking
+     * @deprecated This appears to be a direct binding to internal functionality that is overridden by the engine every frame so calling these functions may not have any or expected effect.
+     */
+    StartWalking(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns the player's SteamID.
+     *
+     * See [Player:AccountID](https://wiki.facepunch.com/gmod/Player:AccountID) for a shorter version of the SteamID and [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) for the full SteamID.
+     *
+     * It is recommended to use [Player:SteamID64](https://wiki.facepunch.com/gmod/Player:SteamID64) over the other SteamID formats whenever possible.
+     *
+     * **NOTE**: In a `-multirun` environment, this will return `STEAM_ID_LAN` for all "copies" of a player because they are not authenticated with Steam.
+     *
+     * For Bots this will return `BOT`.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SteamID
+     */
+    SteamID(self: Player): string;
+}
+
+interface Player {
+    /**
+     * Returns the player's full **64-bit SteamID**, also known as **CommunityID**. Information on how data is packed into this value can be found [here](https://developer.valvesoftware.com/wiki/SteamID).
+     *
+     * See [Player:AccountID](https://wiki.facepunch.com/gmod/Player:AccountID) for a function that returns only the Account ID part of the SteamID and [Player:SteamID](https://wiki.facepunch.com/gmod/Player:SteamID) for the text version of the SteamID.
+     *
+     * **NOTE**: In a `-multirun` environment, this will return `"0"` for all "copies" of a player because they are not authenticated with Steam.
+     *
+     * For bots, this will return `90071996842377216` (equivalent to `STEAM_0:0:0`) for the first bot to join.
+     *
+     * For each additional bot, the number increases by 1. So the next bot will be `90071996842377217` (`STEAM_0:1:0`) then `90071996842377218` (`STEAM_0:0:1`) and so on.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:SteamID64
+     */
+    SteamID64(self: Player): string;
+}
+
+interface Player {
+    /**
+     * When used in a [GM:SetupMove](https://wiki.facepunch.com/gmod/GM:SetupMove) hook, this function will prevent the player from sprinting.
+     *
+     * When +walk is engaged, the player will still be able to sprint to half speed (normal run speed) as opposed to full sprint speed without this function.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:StopSprinting
+     * @deprecated This appears to be a direct binding to internal functionality that is overridden by the engine every frame so calling these functions may not have any or expected effect.
+     */
+    StopSprinting(self: Player): void;
+}
+
+interface Player {
+    /**
+     * When used in a [GM:SetupMove](https://wiki.facepunch.com/gmod/GM:SetupMove) hook, this function behaves unexpectedly by preventing the player from sprinting similar to [Player:StopSprinting](https://wiki.facepunch.com/gmod/Player:StopSprinting).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:StopWalking
+     * @deprecated This appears to be a direct binding to internal functionality that is overridden by the engine every frame so calling these functions may not have any or expected effect.
+     */
+    StopWalking(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Turns off the zoom mode of the player. (+zoom console command)
+     *
+     * Basically equivalent of entering "-zoom" into player's console.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:StopZooming
+     */
+    StopZooming(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Removes all ammo from the player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:StripAmmo
+     * @deprecated Alias of Player:RemoveAllAmmo
+     */
+    StripAmmo(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Removes the specified weapon class from a certain player
+     * 	**NOTE**: this function will call the [Entity:OnRemove](https://wiki.facepunch.com/gmod/Entity:OnRemove) but if you try use [Entity:GetOwner](https://wiki.facepunch.com/gmod/Entity:GetOwner) it will return nil
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:StripWeapon
+     */
+    StripWeapon(self: Player, weapon: string): void;
+}
+
+interface Player {
+    /**
+     * Removes all weapons from a certain player
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:StripWeapons
+     */
+    StripWeapons(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Prevents a hint from showing up.
+     *
+     *
+     * **NOTE**: This function is only available in Sandbox and its derivatives
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SuppressHint
+     */
+    SuppressHint(self: Player, name: string): void;
+}
+
+interface Player {
+    /**
+     * Attempts to switch the player weapon to the one specified in the "cl_defaultweapon" convar, if the player does not own the specified weapon nothing will happen.
+     *
+     * If you want to switch to a specific weapon, use: [Player:SetActiveWeapon](https://wiki.facepunch.com/gmod/Player:SetActiveWeapon)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:SwitchToDefaultWeapon
+     */
+    SwitchToDefaultWeapon(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns the player's team ID, set by [Player:SetTeam](https://wiki.facepunch.com/gmod/Player:SetTeam)
+     *
+     * Returns 0 clientside when the game is not fully loaded.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:Team
+     */
+    Team(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns the time in seconds since the player connected.
+     *
+     * Bots will always return value 0.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:TimeConnected
+     */
+    TimeConnected(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Performs a trace hull and applies damage to the entities hit, returns the first entity hit.
+     *
+     * **WARNING**: Hitting the victim entity with this function in [ENTITY:OnTakeDamage](https://wiki.facepunch.com/gmod/ENTITY:OnTakeDamage) can cause infinite loops.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:TraceHullAttack
+     */
+    TraceHullAttack(self: Player, startPos: Vector, endPos: Vector, mins: Vector, maxs: Vector, damage: number, damageFlags: number, damageForce: number, damageAllNPCs: boolean): Entity;
+}
+
+interface Player {
+    /**
+     * Translates [Enums/ACT](https://wiki.facepunch.com/gmod/Enums/ACT) according to the holdtype of players currently held weapon.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:TranslateWeaponActivity
+     */
+    TranslateWeaponActivity(self: Player, act: number): number;
+}
+
+interface Player {
+    /**
+     * Unlocks the player movement if locked previously.
+     *
+     * Will disable godmode for the player if locked previously.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:UnLock
+     */
+    UnLock(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Removes the player from the spectate mode entirely.
+     *
+     * The player must be respawned, otherwise they will be able to walk through doors and become invincible. This will be fixed in a future update.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/Player:UnSpectate
+     */
+    UnSpectate(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Unfreezes all objects the player has frozen with their Physics Gun. Same as double pressing R while holding Physics Gun.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:UnfreezePhysicsObjects
+     */
+    UnfreezePhysicsObjects(self: Player): void;
+}
+
+interface Player {
+    /**
+     * Returns a 32 bit integer that remains constant for a player across joins/leaves and across different servers. This can be used when a string is inappropriate - e.g. in a database primary key.
+     *
+     *
+     *
+     * **NOTE**: In Singleplayer, this function will always return 1.
+     *
+     * In a `-multirun` environment, the value returned is different on the serverside and clientside.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:UniqueID
+     * @deprecated **This function has collisions,** where more than one player can have the same UniqueID. It is **highly** recommended to use Player:SteamID64, Player:SteamID or Player:AccountID instead, which are guaranteed to be unique to each player.
+     */
+    UniqueID(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Returns a table that will stay allocated for the specific player serverside between connects until the server shuts down or change map. On client it has no such special behavior.
+     *
+     * **NOTE**: This table is not synchronized (networked) between client and server.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:UniqueIDTable
+     */
+    UniqueIDTable(self: Player, key: any): table;
+}
+
+interface Player {
+    /**
+     * Returns the player's user ID. This number will always be unique, but will reset if the player reconnects. (Always increments for each connecting player)
+     *
+     * You can use [Global.Player](https://wiki.facepunch.com/gmod/Global.Player) global function to get a player by their user ID.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:UserID
+     */
+    UserID(self: Player): number;
+}
+
+interface Player {
+    /**
+     * Simulates a push on the client's screen. This **adds** view punch velocity, and does not reset the current view punch angle, for which you can use [Player:SetViewPunchAngles](https://wiki.facepunch.com/gmod/Player:SetViewPunchAngles).
+     *
+     * **NOTE**: Despite being defined shared, it only functions when called server-side.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ViewPunch
+     */
+    ViewPunch(self: Player, punchAngle: Angle): void;
+}
+
+interface Player {
+    /**
+     * Resets the player's view punch (and the view punch velocity, read more at [Player:ViewPunch](https://wiki.facepunch.com/gmod/Player:ViewPunch)) effect back to normal.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/Player:ViewPunchReset
+     */
+    ViewPunchReset(self: Player, tolerance?: number): void;
+}
+
+interface Player {
+    /**
+     * Returns the players voice volume, how loud the player's voice communication currently is, as a number in range of [0,1].
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/Player:VoiceVolume
+     */
+    VoiceVolume(self: Player): number;
+}
+
+interface PlayerLib {
+    /**
+     * Similar to the serverside command "bot", this function creates a new Player bot with the given name. This bot will not obey to the usual `bot_*` commands, and it's the same bot base used in TF2 and CS:S.
+     *
+     * The best way to control the behaviour of a Player bot right now is to use the [GM:StartCommand](https://wiki.facepunch.com/gmod/GM:StartCommand) hook and modify its input serverside.
+     *
+     * **NOTE**: Despite this Player being fake, it has to be removed from the server by using [Player:Kick](https://wiki.facepunch.com/gmod/Player:Kick) and **NOT** [Entity:Remove](https://wiki.facepunch.com/gmod/Entity:Remove).
+     * Also keep in mind that these bots still use player slots, so you won't be able to spawn them in singleplayer!
+     *
+     *
+     * **NOTE**: Any Bot created using this method will be considered UnAuthed by Garry's Mod
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/player.CreateNextBot
+     */
+    CreateNextBot(botName: string): Player;
+}
+
+interface PlayerLib {
+    /**
+     * Gets all the current players in the server (not including connecting clients).
+     *
+     * This function returns bots as well as human players. See [player.GetBots](https://wiki.facepunch.com/gmod/player.GetBots) and  [player.GetHumans](https://wiki.facepunch.com/gmod/player.GetHumans).
+     *
+     * **NOTE**: This function returns a sequential table, meaning it should be looped with [Global.ipairs](https://wiki.facepunch.com/gmod/Global.ipairs) instead of [Global.pairs](https://wiki.facepunch.com/gmod/Global.pairs) for efficiency reasons.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetAll
+     */
+    GetAll(): Player[];
+}
+
+interface PlayerLib {
+    /**
+     * Returns a table of all bots on the server.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetBots
+     */
+    GetBots(): Player[];
+}
+
+interface PlayerLib {
+    /**
+     * Tried to get the player with the specified [Player:AccountID](https://wiki.facepunch.com/gmod/Player:AccountID).
+     * 	**WARNING**: Internally this function iterates over all players in the server, meaning it can be quite expensive in a performance-critical context.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetByAccountID
+     */
+    GetByAccountID(accountID: number): Player | boolean;
+}
+
+interface PlayerLib {
+    /**
+     * Gets the player with the specified connection ID.
+     *
+     * Connection ID can be retrieved via [gameevent.Listen](https://wiki.facepunch.com/gmod/gameevent.Listen) events.
+     *
+     * For a function that returns a player based on their [Entity:EntIndex](https://wiki.facepunch.com/gmod/Entity:EntIndex), see [Global.Entity](https://wiki.facepunch.com/gmod/Global.Entity).
+     *
+     *
+     * For a function that returns a player based on their [Player:UserID](https://wiki.facepunch.com/gmod/Player:UserID), see [Global.Player](https://wiki.facepunch.com/gmod/Global.Player).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetByID
+     */
+    GetByID(connectionID: number): Player | NULL;
+}
+
+interface PlayerLib {
+    /**
+     * Gets the player with the specified SteamID.
+     * 	**WARNING**: Internally this function iterates over all players in the server, meaning it can be quite expensive in a performance-critical context.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetBySteamID
+     */
+    GetBySteamID(steamID: string): Player | boolean;
+}
+
+interface PlayerLib {
+    /**
+     * Gets the player with the specified SteamID64.
+     * 	**WARNING**: Internally this function iterates over all players in the server, meaning it can be quite expensive in a performance-critical context.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetBySteamID64
+     */
+    GetBySteamID64(steamID64: string): Player | boolean;
+}
+
+interface PlayerLib {
+    /**
+     * Gets the player with the specified uniqueID (not recommended way to identify players).
+     *
+     * **WARNING**: It is highly recommended to use [player.GetByAccountID](https://wiki.facepunch.com/gmod/player.GetByAccountID), [player.GetBySteamID](https://wiki.facepunch.com/gmod/player.GetBySteamID) or [player.GetBySteamID64](https://wiki.facepunch.com/gmod/player.GetBySteamID64) instead as this function can have collisions ( be same for different people ) while SteamID is guaranteed to unique to each player.
+     *
+     * 	**WARNING**: Internally this function iterates over all players in the server, meaning it can be quite expensive in a performance-critical context.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetByUniqueID
+     * @deprecated Use player.GetBySteamID64, player.GetBySteamID or player.GetByAccountID to get a player by a unique identifier instead.
+     */
+    GetByUniqueID(uniqueID: string): Player | boolean;
+}
+
+interface PlayerLib {
+    /**
+     * Returns the active player count.
+     *
+     * **NOTE**: Similar to **#**[player.GetAll](https://wiki.facepunch.com/gmod/player.GetAll)() but with better performance since the player table doesn't have to be generated. If [player.GetAll](https://wiki.facepunch.com/gmod/player.GetAll) is already being called for iteration, then using the **#** operator on the table will be faster than calling this function since it is JITted.
+     *
+     * **NOTE**: Players who are currently connecting to the server will not be counted. See function: [player.GetCountConnecting](https://wiki.facepunch.com/gmod/player.GetCountConnecting)
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetCount
+     */
+    GetCount(): number;
+}
+
+interface PlayerLib {
+    /**
+     * Returns the amount of players connecting to the server, but not yet spawned in.
+     *
+     * `player.GetCountConnecting() + player.GetCount()` would result in the total player count on this server.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/player.GetCountConnecting
+     */
+    GetCountConnecting(): number;
+}
+
+interface PlayerLib {
+    /**
+     * Returns a table containing all human players (non-bot/AI).
+     *
+     * Unlike [player.GetAll](https://wiki.facepunch.com/gmod/player.GetAll), this does not include bots.
+     * **NOTE**: This function returns a sequential table, meaning it should be looped with [Global.ipairs](https://wiki.facepunch.com/gmod/Global.ipairs) instead of [Global.pairs](https://wiki.facepunch.com/gmod/Global.pairs) for efficiency reasons.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.GetHumans
+     */
+    GetHumans(): Player[];
+}
+
+interface PlayerLib {
+    /**
+     * Returns a stateless iterator for all players on the server, intended for use
+     * in generic for-loops. Uses cached Lua values, so it is more efficient than
+     * player.GetAll.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/player.Iterator
+     */
+    Iterator(): (((tbl: any, prev?: number) => (number, Player)), Player[], number);
+}
+
+