@tlua/gmod 1.0.3 → 1.0.4

package/types/hook_events.d.tlua

@@ -0,0 +1,2412 @@
+// AUTO-GENERATED tlua declarations.
+
+interface HookLib {
+    /**
+     * Called when a map I/O event occurs.
+     *
+     * See also [Entity:Fire](https://wiki.facepunch.com/gmod/Entity:Fire) and [Entity:Input](https://wiki.facepunch.com/gmod/Entity:Input) for functions to fire Inputs on entities.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:AcceptInput
+     */
+    Add(eventName: "AcceptInput", identifier: any, func: (ent: Entity, input: string, activator: Entity, caller: Entity, value: any) => boolean): void;
+    /**
+     * Adds a death notice entry.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:AddDeathNotice
+     */
+    Add(eventName: "AddDeathNotice", identifier: any, func: (attacker: string, attackerTeam: number, inflictor: string, victim: string, victimTeam: number) => any): void;
+    /**
+     * Allows you to adjust the mouse sensitivity.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:AdjustMouseSensitivity
+     */
+    Add(eventName: "AdjustMouseSensitivity", identifier: any, func: (defaultSensitivity: number, localFOV: number, defaultFOV: number) => number): void;
+    /**
+     * Called when a player tries to pick up something using the "use" key, return to override.
+     *
+     * This hook will not be called if `sv_playerpickupallowed` is set to 0.
+     *
+     * See [GM:GravGunPickupAllowed](https://wiki.facepunch.com/gmod/GM:GravGunPickupAllowed) for the Gravity Gun pickup variant.
+     * See [GM:PhysgunPickup](https://wiki.facepunch.com/gmod/GM:PhysgunPickup) for the Physics Gun pickup variant.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:AllowPlayerPickup
+     */
+    Add(eventName: "AllowPlayerPickup", identifier: any, func: (ply: Player, ent: Entity) => boolean): void;
+    /**
+     * This hook is used to calculate animations for a player.
+     *
+     * **WARNING**: This hook must return the same values at the same time on both, client **and** server. On client for players to see the animations, on server for hit detection to work properly.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:CalcMainActivity
+     */
+    Add(eventName: "CalcMainActivity", identifier: any, func: (ply: Player, vel: Vector) => (number, number)): void;
+    /**
+     * Called from [GM:CalcView](https://wiki.facepunch.com/gmod/GM:CalcView) when player is in driving a vehicle.
+     *
+     * This hook may not be called in gamemodes that override [GM:CalcView](https://wiki.facepunch.com/gmod/GM:CalcView).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:CalcVehicleView
+     */
+    Add(eventName: "CalcVehicleView", identifier: any, func: (veh: Vehicle, ply: Player, view: CamData) => table): void;
+    /**
+     * Allows override of the default view.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:CalcView
+     */
+    Add(eventName: "CalcView", identifier: any, func: (ply: Player, origin: Vector, angles: Angle, fov: number, znear: number, zfar: number) => CamData): void;
+    /**
+     * Allows overriding the position and angle of the viewmodel.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:CalcViewModelView
+     */
+    Add(eventName: "CalcViewModelView", identifier: any, func: (wep: Weapon, vm: Entity, oldPos: Vector, oldAng: Angle, pos: Vector, ang: Angle) => (Vector, Angle)): void;
+    /**
+     * Called whenever a players tries to create an undo.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanCreateUndo
+     */
+    Add(eventName: "CanCreateUndo", identifier: any, func: (ply: Player, undo: Undo) => boolean): void;
+    /**
+     * Called when a variable is about to be edited on an Entity (called by `Edit Properties...` menu), to determine if the edit should be permitted.
+     *
+     * See [Editable entities](https://wiki.facepunch.com/gmod/Editable_Entities) for more details about the system.
+     *
+     * By default, Sandbox will also call [ENTITY:CanEditVariables](https://wiki.facepunch.com/gmod/ENTITY:CanEditVariables) if no hook returns a value.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanEditVariable
+     */
+    Add(eventName: "CanEditVariable", identifier: any, func: (ent: Entity, ply: Player, key: string, value: string, editor: table) => boolean): void;
+    /**
+     * Determines if the player can exit the vehicle on their own. [Player:ExitVehicle](https://wiki.facepunch.com/gmod/Player:ExitVehicle) will bypass this hook.
+     *
+     * See [GM:CanPlayerEnterVehicle](https://wiki.facepunch.com/gmod/GM:CanPlayerEnterVehicle) for the opposite hook.
+     * See also [GM:PlayerLeaveVehicle](https://wiki.facepunch.com/gmod/GM:PlayerLeaveVehicle) for a hook that will be called whenever a player exits any vehicle for any reason.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanExitVehicle
+     */
+    Add(eventName: "CanExitVehicle", identifier: any, func: (veh: Vehicle, ply: Player) => boolean): void;
+    /**
+     * Determines whether or not a given player player can enter the given vehicle. [Player:EnterVehicle](https://wiki.facepunch.com/gmod/Player:EnterVehicle) will still call this hook.
+     *
+     * Called just before [GM:PlayerEnteredVehicle](https://wiki.facepunch.com/gmod/GM:PlayerEnteredVehicle). See also [GM:CanExitVehicle](https://wiki.facepunch.com/gmod/GM:CanExitVehicle).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanPlayerEnterVehicle
+     */
+    Add(eventName: "CanPlayerEnterVehicle", identifier: any, func: (player: Player, vehicle: Vehicle, role: number) => boolean): void;
+    /**
+     * Determines if the player can kill themselves using the `kill` or `explode` console commands.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanPlayerSuicide
+     */
+    Add(eventName: "CanPlayerSuicide", identifier: any, func: (player: Player) => boolean): void;
+    /**
+     * Determines if the player can unfreeze the entity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanPlayerUnfreeze
+     */
+    Add(eventName: "CanPlayerUnfreeze", identifier: any, func: (player: Player, entity: Entity, phys: PhysObj) => boolean): void;
+    /**
+     * Controls if a [property](https://wiki.facepunch.com/gmod/properties) can be used or not.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:CanProperty
+     */
+    Add(eventName: "CanProperty", identifier: any, func: (ply: Player, property: string, ent: Entity) => boolean): void;
+    /**
+     * Called whenever a players tries to undo.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CanUndo
+     */
+    Add(eventName: "CanUndo", identifier: any, func: (ply: Player, undo: Undo) => boolean): void;
+    /**
+     * Called each frame to record demos to video using [IVideoWriter](https://wiki.facepunch.com/gmod/IVideoWriter).
+     *
+     * **NOTE**: This hook is called every frame regardless of whether or not a demo is being recorded
+     *
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:CaptureVideo
+     */
+    Add(eventName: "CaptureVideo", identifier: any, func: () => void): void;
+    /**
+     * Called when a message is printed to the chat box. Note, that this isn't working with player messages even though there are arguments for it.
+     *
+     * For player messages see [GM:PlayerSay](https://wiki.facepunch.com/gmod/GM:PlayerSay) and [GM:OnPlayerChat](https://wiki.facepunch.com/gmod/GM:OnPlayerChat)
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ChatText
+     */
+    Add(eventName: "ChatText", identifier: any, func: (index: number, name: string, text: string, type: string) => boolean): void;
+    /**
+     * Called whenever the content of the user's chat input box is changed.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ChatTextChanged
+     */
+    Add(eventName: "ChatTextChanged", identifier: any, func: (text: string) => void): void;
+    /**
+     * Called when a **non local player** connects to allow the Lua system to check the password.
+     *
+     * The default behaviour in the base gamemodes emulates what would normally happen. If `sv_password` is set and its value matches the password passed in by the client (via `password` concommand) - then they are allowed to join. If `sv_password` isn't set it lets them in too.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CheckPassword
+     */
+    Add(eventName: "CheckPassword", identifier: any, func: (steamID64: string, ipAddress: string, svPassword: string, clPassword: string, name: string) => (boolean, string)): void;
+    /**
+     * Called when a player's sign on state changes.
+     * You cannot get a valid player object from the userID at any point during this hook.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ClientSignOnStateChanged
+     */
+    Add(eventName: "ClientSignOnStateChanged", identifier: any, func: (userID: number, oldState: number, newState: number) => void): void;
+    /**
+     * Called when derma menus are closed with [Global.CloseDermaMenus](https://wiki.facepunch.com/gmod/Global.CloseDermaMenus).
+     * @realm client and menu
+     * @source https://wiki.facepunch.com/gmod/GM:CloseDermaMenus
+     */
+    Add(eventName: "CloseDermaMenus", identifier: any, func: () => void): void;
+    /**
+     * Called whenever an entity becomes a clientside ragdoll.
+     *
+     * See [GM:CreateEntityRagdoll](https://wiki.facepunch.com/gmod/GM:CreateEntityRagdoll) for serverside ragdolls.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:CreateClientsideRagdoll
+     */
+    Add(eventName: "CreateClientsideRagdoll", identifier: any, func: (entity: Entity, ragdoll: Entity) => void): void;
+    /**
+     * Called when a serverside ragdoll of an entity has been created.
+     *
+     * See [GM:CreateClientsideRagdoll](https://wiki.facepunch.com/gmod/GM:CreateClientsideRagdoll) for clientside ragdolls.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:CreateEntityRagdoll
+     */
+    Add(eventName: "CreateEntityRagdoll", identifier: any, func: (owner: Entity, ragdoll: Entity) => void): void;
+    /**
+     * Allows you to change the players movements before they're sent to the server.
+     *
+     * See [Game Movement](https://wiki.facepunch.com/gmod/Game_Movement) for an explanation on the move system.
+     *
+     * **NOTE**: Due to this hook being clientside only, it could be overridden by the user allowing them to completely skip your logic, it is recommended to use [GM:StartCommand](https://wiki.facepunch.com/gmod/GM:StartCommand) in a shared file instead.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:CreateMove
+     */
+    Add(eventName: "CreateMove", identifier: any, func: (cmd: CUserCmd) => boolean): void;
+    /**
+     * Teams are created within this hook using [team.SetUp](https://wiki.facepunch.com/gmod/team.SetUp).
+     *
+     * This hook is called before [GM:PreGamemodeLoaded](https://wiki.facepunch.com/gmod/GM:PreGamemodeLoaded).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:CreateTeams
+     */
+    Add(eventName: "CreateTeams", identifier: any, func: () => void): void;
+    /**
+     * Called upon an animation event, this is the ideal place to call player animation functions such as [Player:AddVCDSequenceToGestureSlot](https://wiki.facepunch.com/gmod/Player:AddVCDSequenceToGestureSlot), [Player:AnimRestartGesture](https://wiki.facepunch.com/gmod/Player:AnimRestartGesture) and so on.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:DoAnimationEvent
+     */
+    Add(eventName: "DoAnimationEvent", identifier: any, func: (ply: Player, event: number, data?: number) => number): void;
+    /**
+     * Handles the player's death.
+     *
+     * This hook is **not** called if the player is killed by [Player:KillSilent](https://wiki.facepunch.com/gmod/Player:KillSilent). See [GM:PlayerSilentDeath](https://wiki.facepunch.com/gmod/GM:PlayerSilentDeath) for that.
+     *
+     * * [GM:PlayerDeath](https://wiki.facepunch.com/gmod/GM:PlayerDeath) is called after this hook
+     * * [GM:PostPlayerDeath](https://wiki.facepunch.com/gmod/GM:PostPlayerDeath) is called after that
+     *
+     * **NOTE**: [Player:Alive](https://wiki.facepunch.com/gmod/Player:Alive) will return false in this hook.
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:DoPlayerDeath
+     */
+    Add(eventName: "DoPlayerDeath", identifier: any, func: (ply: Player, attacker: Entity, dmg: CTakeDamageInfo) => void): void;
+    /**
+     * This hook is called every frame to draw all of the current death notices.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:DrawDeathNotice
+     */
+    Add(eventName: "DrawDeathNotice", identifier: any, func: (x: number, y: number) => void): void;
+    /**
+     * Called every frame before drawing the in-game monitors ( Breencast, in-game TVs, etc ), but doesn't seem to be doing anything, trying to render 2D or 3D elements fail.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:DrawMonitors
+     */
+    Add(eventName: "DrawMonitors", identifier: any, func: () => void): void;
+    /**
+     * Called after all other 2D draw hooks are called. Draws over all VGUI Panels and HUDs.
+     *
+     * Unlike [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint), this hook is called with the game paused and while the Camera SWEP is equipped.
+     *
+     * Does not get called when `r_drawvgui` is disabled.
+     *
+     *
+     *
+     * @realm client and menu
+     * @source https://wiki.facepunch.com/gmod/GM:DrawOverlay
+     */
+    Add(eventName: "DrawOverlay", identifier: any, func: () => void): void;
+    /**
+     * Allows you to override physgun effects rendering.
+     *
+     * **NOTE**: This is still called when `physgun_drawbeams` is set to `0`, because this hook is also capable of overriding physgun sprite effects, while the convar does not.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:DrawPhysgunBeam
+     */
+    Add(eventName: "DrawPhysgunBeam", identifier: any, func: (ply: Player, physgun: Weapon, enabled: boolean, target: Entity, physBone: number, hitPos: Vector) => boolean): void;
+    /**
+     * Called right before an entity stops driving. Overriding this hook will cause it to not call [drive.End](https://wiki.facepunch.com/gmod/drive.End) and the player will not stop driving.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EndEntityDriving
+     */
+    Add(eventName: "EndEntityDriving", identifier: any, func: (ent: Entity, ply: Player) => void): void;
+    /**
+     * Called whenever a sound has been played. This will not be called clientside if the server played the sound without the client also calling [Entity:EmitSound](https://wiki.facepunch.com/gmod/Entity:EmitSound).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EntityEmitSound
+     */
+    Add(eventName: "EntityEmitSound", identifier: any, func: (data: EmitSoundInfo) => boolean): void;
+    /**
+     * Called every time a bullet is about to be fired from an entity, which allows to completely modify the bullet structure before the bullet is actually fired.
+     *
+     * See [GM:PostEntityFireBullets](https://wiki.facepunch.com/gmod/GM:PostEntityFireBullets) if you wish to hook the final bullet values, such as the aim direction post spread calculations.
+     *
+     * **WARNING**: This hook is called directly from [Entity:FireBullets](https://wiki.facepunch.com/gmod/Entity:FireBullets). Due to this, you cannot call [Entity:FireBullets](https://wiki.facepunch.com/gmod/Entity:FireBullets) inside this hook or an infinite loop will occur crashing the game.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EntityFireBullets
+     */
+    Add(eventName: "EntityFireBullets", identifier: any, func: (entity: Entity, data: Bullet) => boolean): void;
+    /**
+     * Called when a key-value pair is set on an entity on map spawn. Is **not** called by [Entity:SetKeyValue](https://wiki.facepunch.com/gmod/Entity:SetKeyValue).
+     *
+     * See [ENTITY:KeyValue](https://wiki.facepunch.com/gmod/ENTITY:KeyValue) for a [scripted entities](https://wiki.facepunch.com/gmod/scripted_entities) hook, and its scripted weapon alternative: [WEAPON:KeyValue](https://wiki.facepunch.com/gmod/WEAPON:KeyValue).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EntityKeyValue
+     */
+    Add(eventName: "EntityKeyValue", identifier: any, func: (ent: Entity, key: string, value: string) => string): void;
+    /**
+     * Called when an NW2Var is changed.
+     * If a NW2Var is set on an entity that is based on a Lua Entity could result in the NW2Var being mixed up with other ones and being updated multiple times.
+     * **NOTE**: This hook is fired before the client value is actually changed. Calling the GetNW2 function for the specified variable name within this hook will return the old value, not the current/updated one.
+     *
+     * 	This hook gets called for all NW2Vars on all Entities in a full update. The old value will be nil in this case.
+     * 	If this hook seems to be called for no apparent reason, check if it's caused by a full update.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EntityNetworkedVarChanged
+     */
+    Add(eventName: "EntityNetworkedVarChanged", identifier: any, func: (ent: Entity, name: string, oldval: any, newval: any) => void): void;
+    /**
+     * 		Called right before removal of an entity.
+     * 		**WARNING**: This hook is called clientside during full updates due to how networking works in the Source Engine.
+     *
+     * This can happen when the client briefly loses connection to the server, and can be simulated via `cl_fullupdate` for testing purposes.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:EntityRemoved
+     */
+    Add(eventName: "EntityRemoved", identifier: any, func: (ent: Entity, fullUpdate: boolean) => void): void;
+    /**
+     * Called when an entity is about to take damage. You can modify all parts of the damage info in this hook or completely block the damage event.
+     *
+     * See [GM:PostEntityTakeDamage](https://wiki.facepunch.com/gmod/GM:PostEntityTakeDamage) if you wish to hook the final damage event.
+     *
+     * **WARNING**: Applying damage from this hook to the entity taking damage will lead to infinite loop/crash.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:EntityTakeDamage
+     */
+    Add(eventName: "EntityTakeDamage", identifier: any, func: (target: Entity, dmg: CTakeDamageInfo) => boolean): void;
+    /**
+     * This hook polls the entity the player use action should be applied to.
+     *
+     * **NOTE**: The default behavior of this hook is in [CBasePlayer::FindUseEntity](https://github.com/ValveSoftware/source-sdk-2013/blob/0d8dceea4310fde5706b3ce1c70609d72a38efdf/mp/src/game/shared/baseplayer_shared.cpp#L1068-L1270). Despite CBasePlayer::FindUseEntity being defined shared, it is only called serverside in practice, so this hook will be only called serverside, as well. It is possible for modules to call it clientside, so the Lua code should still be treated as shared.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:FindUseEntity
+     */
+    Add(eventName: "FindUseEntity", identifier: any, func: (ply: Player, defaultEnt: Entity) => Entity): void;
+    /**
+     * Runs when user cancels/finishes typing.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:FinishChat
+     */
+    Add(eventName: "FinishChat", identifier: any, func: () => void): void;
+    /**
+     * Called after [GM:Move](https://wiki.facepunch.com/gmod/GM:Move), applies all the changes from the [CMoveData](https://wiki.facepunch.com/gmod/CMoveData) to the player.
+     *
+     * See [Game Movement](https://wiki.facepunch.com/gmod/Game_Movement) for an explanation on the move system.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:FinishMove
+     */
+    Add(eventName: "FinishMove", identifier: any, func: (ply: Player, mv: CMoveData) => boolean): void;
+    /**
+     * Called to allow override of the default Derma skin for all panels.
+     *
+     * **NOTE**: This hook is only called on Lua start up, changing its value (or adding new hooks) after it has been already called will not have any effect.
+     *
+     * **NOTE**: You can [Panel:SetSkin](https://wiki.facepunch.com/gmod/Panel:SetSkin) "Default" (or other skins) on the frame/base panel and they will still take priority
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ForceDermaSkin
+     */
+    Add(eventName: "ForceDermaSkin", identifier: any, func: () => string): void;
+    /**
+     * Called when game content has been changed, for example an addon or a mountable game was (un)mounted.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/GM:GameContentChanged
+     */
+    Add(eventName: "GameContentChanged", identifier: any, func: () => void): void;
+    /**
+     * An internal function used to get an untranslated string to show in the kill feed as the entity's name. See [GM:SendDeathNotice](https://wiki.facepunch.com/gmod/GM:SendDeathNotice)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GetDeathNoticeEntityName
+     */
+    Add(eventName: "GetDeathNoticeEntityName", identifier: any, func: (name: string | Entity) => string): void;
+    /**
+     * Called when a player takes damage from falling, allows to override the damage.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GetFallDamage
+     */
+    Add(eventName: "GetFallDamage", identifier: any, func: (ply: Player, speed: number) => number): void;
+    /**
+     * Called when the game(server) needs to update the text shown in the server browser as the gamemode. Runs at a ~2s interval, runs even when the server is hibernating.
+     *
+     * **NOTE**: This hook (and the `sv_gamename_override` command) may not work on some popular gamemodes like DarkRP or Trouble Terrorist Town. This is not a bug, it's just how it works. See [here](https://github.com/Facepunch/garrysmod-issues/issues/4637#issuecomment-677884989) for more information.
+     *
+     * Also, it **only** works on dedicated servers and is called at regular intervals (about one second) **even** if the server has no players and the hibernation function is enabled.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:GetGameDescription
+     */
+    Add(eventName: "GetGameDescription", identifier: any, func: () => string): void;
+    /**
+     * Allows you to modify the Source Engine's motion blur shaders.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GetMotionBlurValues
+     */
+    Add(eventName: "GetMotionBlurValues", identifier: any, func: (horizontal: number, vertical: number, forward: number, rotational: number) => (number, number, number, number)): void;
+    /**
+     * Called to determine preferred carry angles for the entity. It works for both, +use pickup and gravity gun pickup.
+     *
+     * **WARNING**: Due to nature of the gravity gun coding in multiplayer, this hook **MAY** seem to not work ( but rest assured it does ), due to clientside prediction not knowing the carry angles. The +use pickup doesn't present this issue as it doesn't predict the player carrying the object clientside ( as you may notice by the prop lagging behind in multiplayer )
+     *
+     *
+     * **NOTE**: This hook can **not** override preferred carry angles of props such as the sawblade and the harpoon.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GetPreferredCarryAngles
+     */
+    Add(eventName: "GetPreferredCarryAngles", identifier: any, func: (ent: Entity, ply: Player) => Angle): void;
+    /**
+     * Returns the color for the given entity's team. This is used in chat and deathnotice text.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GetTeamColor
+     */
+    Add(eventName: "GetTeamColor", identifier: any, func: (ent: Entity) => Color): void;
+    /**
+     * Returns the team color for the given team index.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GetTeamNumColor
+     */
+    Add(eventName: "GetTeamNumColor", identifier: any, func: (team: number) => Color): void;
+    /**
+     * Override this hook to disable/change ear-grabbing in your gamemode. By default, it is not called anywhere on the server.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:GrabEarAnimation
+     */
+    Add(eventName: "GrabEarAnimation", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when an entity is released by a gravity gun.
+     *
+     * See [GM:PhysgunDrop](https://wiki.facepunch.com/gmod/GM:PhysgunDrop) for the Physics Gun drop variant.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GravGunOnDropped
+     */
+    Add(eventName: "GravGunOnDropped", identifier: any, func: (ply: Player, ent: Entity) => void): void;
+    /**
+     * Called when an entity is picked up by a gravity gun.
+     *
+     * See [GM:OnPlayerPhysicsPickup](https://wiki.facepunch.com/gmod/GM:OnPlayerPhysicsPickup) for the player `+use` pickup variant.
+     * See [GM:OnPhysgunPickup](https://wiki.facepunch.com/gmod/GM:OnPhysgunPickup) for the Physics Gun pickup variant.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GravGunOnPickedUp
+     */
+    Add(eventName: "GravGunOnPickedUp", identifier: any, func: (ply: Player, ent: Entity) => void): void;
+    /**
+     * Called every tick to poll whether a player is allowed to pick up an entity with the gravity gun or not.
+     *
+     * See [GM:AllowPlayerPickup](https://wiki.facepunch.com/gmod/GM:AllowPlayerPickup) for the +USE pickup variant.
+     * See [GM:PhysgunPickup](https://wiki.facepunch.com/gmod/GM:PhysgunPickup) for the Physics Gun pickup variant.
+     *
+     * Calls [ENTITY:GravGunPickupAllowed](https://wiki.facepunch.com/gmod/ENTITY:GravGunPickupAllowed) on the entity being hovered every frame in Sandbox-derived gamemodes.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:GravGunPickupAllowed
+     */
+    Add(eventName: "GravGunPickupAllowed", identifier: any, func: (ply: Player, ent: Entity) => boolean): void;
+    /**
+     * Called when an entity is about to be punted with the gravity gun (primary fire).
+     *
+     * By default this function makes [ENTITY:GravGunPunt](https://wiki.facepunch.com/gmod/ENTITY:GravGunPunt) work in Sandbox derived gamemodes.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:GravGunPunt
+     */
+    Add(eventName: "GravGunPunt", identifier: any, func: (ply: Player, ent: Entity) => boolean): void;
+    /**
+     * Called when the mouse has been double clicked on any panel derived from CGModBase, such as the panel used by [gui.EnableScreenClicker](https://wiki.facepunch.com/gmod/gui.EnableScreenClicker) and the panel used by [Panel:ParentToHUD](https://wiki.facepunch.com/gmod/Panel:ParentToHUD).
+     *
+     * By default this hook calls [GM:GUIMousePressed](https://wiki.facepunch.com/gmod/GM:GUIMousePressed).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GUIMouseDoublePressed
+     */
+    Add(eventName: "GUIMouseDoublePressed", identifier: any, func: (mouseCode: number, aimVector: Vector) => void): void;
+    /**
+     * Called whenever a players presses a mouse key on the context menu in Sandbox or on any panel derived from CGModBase, such as the panel used by [gui.EnableScreenClicker](https://wiki.facepunch.com/gmod/gui.EnableScreenClicker) and the panel used by [Panel:ParentToHUD](https://wiki.facepunch.com/gmod/Panel:ParentToHUD).
+     *
+     * See [GM:VGUIMousePressed](https://wiki.facepunch.com/gmod/GM:VGUIMousePressed) for a hook that is called on all VGUI elements.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GUIMousePressed
+     */
+    Add(eventName: "GUIMousePressed", identifier: any, func: (mouseCode: number, aimVector: Vector) => void): void;
+    /**
+     * Called whenever a players releases a mouse key on the context menu in Sandbox or on any panel derived from CGModBase, such as the panel used by [gui.EnableScreenClicker](https://wiki.facepunch.com/gmod/gui.EnableScreenClicker) and the panel used by [Panel:ParentToHUD](https://wiki.facepunch.com/gmod/Panel:ParentToHUD).
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:GUIMouseReleased
+     */
+    Add(eventName: "GUIMouseReleased", identifier: any, func: (mouseCode: number, aimVector: Vector) => void): void;
+    /**
+     * Called to handle player armor reduction, when player receives damage.
+     *
+     * Clarify hook order with other damage hooks.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerArmorReduction
+     */
+    Add(eventName: "HandlePlayerArmorReduction", identifier: any, func: (ply: Player, dmginfo: CTakeDamageInfo) => void): void;
+    /**
+     * Allows to override player driving animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerDriving
+     */
+    Add(eventName: "HandlePlayerDriving", identifier: any, func: (ply: Player) => boolean): void;
+    /**
+     * Allows to override player crouch animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerDucking
+     */
+    Add(eventName: "HandlePlayerDucking", identifier: any, func: (ply: Player, velocity: Vector) => boolean): void;
+    /**
+     * Called every frame by the player model animation system. Allows to override player jumping animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerJumping
+     */
+    Add(eventName: "HandlePlayerJumping", identifier: any, func: (ply: Player, velocity: Vector) => boolean): void;
+    /**
+     * Called every frame by the player model animation system. Allows to override player landing animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerLanding
+     */
+    Add(eventName: "HandlePlayerLanding", identifier: any, func: (ply: Player, velocity: Vector, onGround: boolean) => boolean): void;
+    /**
+     * Allows to override player noclip animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerNoClipping
+     */
+    Add(eventName: "HandlePlayerNoClipping", identifier: any, func: (ply: Player, velocity: Vector) => boolean): void;
+    /**
+     * Allows to override player swimming animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerSwimming
+     */
+    Add(eventName: "HandlePlayerSwimming", identifier: any, func: (ply: Player, velocity: Vector) => boolean): void;
+    /**
+     * Allows to override player flying ( in mid-air, not noclipping ) animations.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:HandlePlayerVaulting
+     */
+    Add(eventName: "HandlePlayerVaulting", identifier: any, func: (ply: Player, velocity: Vector) => boolean): void;
+    /**
+     * Hides the team selection panel.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HideTeam
+     */
+    Add(eventName: "HideTeam", identifier: any, func: () => void): void;
+    /**
+     * Called when the client has picked up ammo. Override to disable default HUD notification.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDAmmoPickedUp
+     */
+    Add(eventName: "HUDAmmoPickedUp", identifier: any, func: (itemName: string, amount: number) => void): void;
+    /**
+     * Renders the HUD pick-up history. Override to hide default or draw your own HUD.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDDrawPickupHistory
+     */
+    Add(eventName: "HUDDrawPickupHistory", identifier: any, func: () => void): void;
+    /**
+     * Called every frame to render the scoreboard.
+     *
+     *
+     * It is recommended to use Derma and VGUI for this job instead of this hook. Called right after [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDDrawScoreBoard
+     */
+    Add(eventName: "HUDDrawScoreBoard", identifier: any, func: () => void): void;
+    /**
+     * Called from [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint) to draw player info when you hover over a player with your crosshair or mouse.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDDrawTargetID
+     */
+    Add(eventName: "HUDDrawTargetID", identifier: any, func: () => boolean): void;
+    /**
+     * Called when an item has been picked up. Override to disable the default HUD notification.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDItemPickedUp
+     */
+    Add(eventName: "HUDItemPickedUp", identifier: any, func: (itemName: string) => void): void;
+    /**
+     * 		Called whenever the HUD should be drawn.
+     *
+     * 		This is the ideal place to draw custom HUD elements.
+     *
+     * 		To prevent the default game HUD from drawing, use [GM:HUDShouldDraw](https://wiki.facepunch.com/gmod/GM:HUDShouldDraw).
+     *
+     * 		This hook does **not** get called when the Camera SWEP is held, or when the esc menu is open.
+     * 		If you need to draw in those situations, use [GM:DrawOverlay](https://wiki.facepunch.com/gmod/GM:DrawOverlay) instead.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDPaint
+     */
+    Add(eventName: "HUDPaint", identifier: any, func: () => void): void;
+    /**
+     * Called before [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint) when the HUD background is being drawn.
+     *
+     * Just like [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint), this hook will not be called when the main menu is visible. [GM:PostDrawHUD](https://wiki.facepunch.com/gmod/GM:PostDrawHUD) does not have this behavior.
+     *
+     * Things rendered in this hook will **always** appear behind things rendered in [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDPaintBackground
+     */
+    Add(eventName: "HUDPaintBackground", identifier: any, func: () => void): void;
+    /**
+     * Called when the Gamemode is about to draw a given element on the client's HUD (heads-up display).
+     *
+     * **WARNING**: This hook is called HUNDREDS of times per second (more than 5 times per frame on average). You shouldn't be performing any computationally intensive operations. For Weapons you SHOULD use [WEAPON:HUDShouldDraw](https://wiki.facepunch.com/gmod/WEAPON:HUDShouldDraw) instead.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDShouldDraw
+     */
+    Add(eventName: "HUDShouldDraw", identifier: any, func: (name: string) => boolean): void;
+    /**
+     * Called when a weapon has been picked up. Override to disable the default HUD notification.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:HUDWeaponPickedUp
+     */
+    Add(eventName: "HUDWeaponPickedUp", identifier: any, func: (weapon: Weapon) => void): void;
+    /**
+     * Called after the gamemode loads and starts.
+     *
+     * No entities would be present at the time this hook is called, please see [GM:InitPostEntity](https://wiki.facepunch.com/gmod/GM:InitPostEntity) for a one time fire hook after all map entities have been initialized.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:Initialize
+     */
+    Add(eventName: "Initialize", identifier: any, func: () => void): void;
+    /**
+     * Called after all the entities are initialized. Starting from this hook [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer) will return valid object.
+     *
+     * **NOTE**: At this point the client only knows about the entities that are within the spawnpoints' [PVS (Potential Visibility Set)](https://developer.valvesoftware.com/wiki/PVS "PVS - Valve Developer Community"). For instance, if the server sends an entity that is not within this PVS, the client will receive it as NULL entity.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:InitPostEntity
+     */
+    Add(eventName: "InitPostEntity", identifier: any, func: () => void): void;
+    /**
+     * Allows you to modify the supplied User Command with mouse input. This could be used to make moving the mouse do funky things to view angles.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:InputMouseApply
+     */
+    Add(eventName: "InputMouseApply", identifier: any, func: (cmd: CUserCmd, x: number, y: number, ang: Angle) => boolean): void;
+    /**
+     * Check if a player can spawn at a certain spawnpoint.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:IsSpawnpointSuitable
+     */
+    Add(eventName: "IsSpawnpointSuitable", identifier: any, func: (ply: Player, spawnpoint: Entity, makeSuitable: boolean) => boolean): void;
+    /**
+     * Called whenever a player pressed a key included within the IN keys.
+     *
+     * For a more general purpose function that handles all kinds of input, see [GM:PlayerButtonDown](https://wiki.facepunch.com/gmod/GM:PlayerButtonDown).
+     * See [GM:KeyRelease](https://wiki.facepunch.com/gmod/GM:KeyRelease) for the key release event.
+     *
+     * Despite being a predicted hook, it will still be called in singleplayer for your convenience.
+     *
+     * **WARNING**: Due to this being a predicted hook, [Global.ParticleEffect](https://wiki.facepunch.com/gmod/Global.ParticleEffect)s created only serverside from this hook will not be networked to the client, so make sure to do that on both realms.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:KeyPress
+     */
+    Add(eventName: "KeyPress", identifier: any, func: (ply: Player, key: number) => void): void;
+    /**
+     * Runs when a IN key was released by a player.
+     *
+     * For a more general purpose function that handles all kinds of input, see [GM:PlayerButtonUp](https://wiki.facepunch.com/gmod/GM:PlayerButtonUp).
+     * See [GM:KeyPress](https://wiki.facepunch.com/gmod/GM:KeyPress) for the key press event.
+     *
+     * Despite being a predicted hook, it will still be called in singleplayer for your convenience.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:KeyRelease
+     */
+    Add(eventName: "KeyRelease", identifier: any, func: (ply: Player, key: number) => void): void;
+    /**
+     * **INTERNAL**: This is used internally - although you're able to use it you probably shouldn't.
+     * Called from `gm_load` when the game should load a map.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:LoadGModSave
+     */
+    Add(eventName: "LoadGModSave", identifier: any, func: (data: string, map: string, timestamp: number) => void): void;
+    /**
+     * Called while an addon from the Steam workshop is downloading. Used by default to update details on the fancy workshop download panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:LoadGModSaveFailed
+     */
+    Add(eventName: "LoadGModSaveFailed", identifier: any, func: (reason: string, workshopid: string) => void): void;
+    /**
+     * Called when `menu.lua` has finished loading.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:MenuStart
+     */
+    Add(eventName: "MenuStart", identifier: any, func: () => void): void;
+    /**
+     * Override this gamemode function to disable mouth movement when talking on voice chat. By default, it is not called anywhere on the server.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:MouthMoveAnimation
+     */
+    Add(eventName: "MouthMoveAnimation", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * The Move hook is called for you to manipulate the player's MoveData.
+     *
+     * You shouldn't adjust the player's position in any way in the move hook. This is because due to prediction errors, the netcode might run the move hook multiple times as packets arrive late. Therefore you should only adjust the movedata construct in this hook.
+     *
+     * Generally you shouldn't have to use this hook - if you want to make a custom move type you should look at the drive system.
+     *
+     * This hook is called after [GM:PlayerTick](https://wiki.facepunch.com/gmod/GM:PlayerTick).
+     *
+     * See [Game Movement](https://wiki.facepunch.com/gmod/Game_Movement) for an explanation on the move system.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:Move
+     */
+    Add(eventName: "Move", identifier: any, func: (ply: Player, mv: CMoveData) => boolean): void;
+    /**
+     * Returning true in this hook will cause it to render depth buffers defined with [render.GetResolvedFullFrameDepth](https://wiki.facepunch.com/gmod/render.GetResolvedFullFrameDepth).
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:NeedsDepthPass
+     */
+    Add(eventName: "NeedsDepthPass", identifier: any, func: () => boolean): void;
+    /**
+     * Called when an entity has been created over the network.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:NetworkEntityCreated
+     */
+    Add(eventName: "NetworkEntityCreated", identifier: any, func: (ent: Entity) => void): void;
+    /**
+     * Called when a player's SteamID has been validated by Steam.
+     *
+     * See also [GM:PlayerAuthed](https://wiki.facepunch.com/gmod/GM:PlayerAuthed) and [Player:IsFullyAuthenticated](https://wiki.facepunch.com/gmod/Player:IsFullyAuthenticated).
+     *
+     * **NOTE**: This hook doesn't work intentionally in singleplayer [because the SteamID is not validated](https://github.com/Facepunch/garrysmod-issues/issues/4906#issuecomment-819337130) in that case. This also applies to `sv_lan 1` servers for every duplicate `-multirun` client.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:NetworkIDValidated
+     */
+    Add(eventName: "NetworkIDValidated", identifier: any, func: (name: string, steamID: string, ownerID: string) => void): void;
+    /**
+     * Called whenever this entity changes its transmission state for this [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer), such as exiting or re entering the [PVS (Potential Visibility Set)](https://developer.valvesoftware.com/wiki/PVS "PVS - Valve Developer Community").
+     *
+     * **NOTE**: This is the best place to handle the reset of [Entity:SetPredictable](https://wiki.facepunch.com/gmod/Entity:SetPredictable), as this would be usually called when the player lags and requests a full packet update.
+     *
+     * 	When the entity stops transmitting, [Entity:IsDormant](https://wiki.facepunch.com/gmod/Entity:IsDormant) will only return true **after** this hook.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:NotifyShouldTransmit
+     */
+    Add(eventName: "NotifyShouldTransmit", identifier: any, func: (entity: Entity, shouldtransmit: boolean) => void): void;
+    /**
+     * Called when a player has achieved an achievement. You can get the name and other information from an achievement ID with the [achievements](https://wiki.facepunch.com/gmod/achievements) library.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnAchievementAchieved
+     */
+    Add(eventName: "OnAchievementAchieved", identifier: any, func: (ply: Player, achievement: number) => void): void;
+    /**
+     * 	Called when the local player presses TAB while having their chatbox opened.
+     *
+     * 		**WARNING**: This function now uses [player.Iterator](https://wiki.facepunch.com/gmod/player.Iterator). This means it can't run all the time, as an error in the [GM:OnEntityCreated](https://wiki.facepunch.com/gmod/GM:OnEntityCreated) or [GM:EntityRemoved](https://wiki.facepunch.com/gmod/GM:EntityRemoved) hooks is likely to interrupt it. Make sure that no addon causes an error in these hooks.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnChatTab
+     */
+    Add(eventName: "OnChatTab", identifier: any, func: (text: string) => string): void;
+    /**
+     * Called when the player cleans up something.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnCleanup
+     */
+    Add(eventName: "OnCleanup", identifier: any, func: (name: string) => boolean): void;
+    /**
+     *         Called on the server when a Lua error occurs on a client and is sent to the server.
+     *
+     *         This hook allows server-side code to detect and log client-side errors.
+     *
+     * See [GM:OnLuaError](https://wiki.facepunch.com/gmod/GM:OnLuaError) for a hook that captures Lua errors directly within its [realm](https://wiki.facepunch.com/gmod/States).
+     *
+     * **WARNING**: Note that the stack argument can contain a table with 0 values.
+     *
+     * **NOTE**: Warning: the hook "protects" against lua error spam. If it has 5 errors in less than 1 second, the hook will not receive any of these 4 errors.
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnClientLuaError
+     */
+    Add(eventName: "OnClientLuaError", identifier: any, func: (error: string, ply: Player, stack: table, name: string) => void): void;
+    /**
+     * Called when a caption/subtitle has been emitted to the closed caption box.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnCloseCaptionEmit
+     */
+    Add(eventName: "OnCloseCaptionEmit", identifier: any, func: (soundScript: string, duration: number, fromPlayer: boolean, fullText: string) => boolean): void;
+    /**
+     * Called when the context menu keybind (+menu_context) is released, which by default is C.
+     *
+     * This hook will not run if [input.IsKeyTrapping](https://wiki.facepunch.com/gmod/input.IsKeyTrapping) returns true.
+     *
+     * See also [GM:OnContextMenuOpen](https://wiki.facepunch.com/gmod/GM:OnContextMenuOpen).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnContextMenuClose
+     */
+    Add(eventName: "OnContextMenuClose", identifier: any, func: () => void): void;
+    /**
+     * Called when the context menu keybind (`+menu_context`) is pressed, which by default is C.
+     *
+     * See also [GM:OnContextMenuClose](https://wiki.facepunch.com/gmod/GM:OnContextMenuClose).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnContextMenuOpen
+     */
+    Add(eventName: "OnContextMenuOpen", identifier: any, func: () => void): void;
+    /**
+     * Called when the crazy physics detection detects an entity with crazy physics, i.e. position being far outside of the map, velocities being near or at infinity, etc. The primary reason for this system is to prevent program crashes in physics engine.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnCrazyPhysics
+     */
+    Add(eventName: "OnCrazyPhysics", identifier: any, func: (ent: Entity, physobj: PhysObj) => void): void;
+    /**
+     * Called when a player has been hurt by an explosion. Override to disable default sound effect.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnDamagedByExplosion
+     */
+    Add(eventName: "OnDamagedByExplosion", identifier: any, func: (ply: Player, dmginfo: CTakeDamageInfo) => void): void;
+    /**
+     * Called as soon as the entity is created. Very little of the entity's properties will be initialized at this stage. (keyvalues, classname, flags, anything), especially on the serverside.
+     *
+     * **WARNING**: Removing the created entity during this event can lead to unexpected problems. Use [Global.SafeRemoveEntityDelayed](https://wiki.facepunch.com/gmod/Global.SafeRemoveEntityDelayed)( entity, 0 ) to safely remove the entity.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnEntityCreated
+     */
+    Add(eventName: "OnEntityCreated", identifier: any, func: (entity: Entity) => void): void;
+    /**
+     * Called when the [Entity:WaterLevel](https://wiki.facepunch.com/gmod/Entity:WaterLevel) of an entity is changed.
+     *
+     *     0 - The entity isn't in water.
+     *
+     *     1 - Slightly submerged (at least to the feet).
+     *
+     *     2 - The majority of the entity is submerged (at least to the waist).
+     *
+     *     3 - Completely submerged.
+     *
+     * 	**WARNING**: This hook can be considered a physics callback, so changing collision rules ([Entity:SetSolidFlags](https://wiki.facepunch.com/gmod/Entity:SetSolidFlags)) in it may lead to a crash!
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnEntityWaterLevelChanged
+     */
+    Add(eventName: "OnEntityWaterLevelChanged", identifier: any, func: (entity: Entity, old: number, _new: number) => void): void;
+    /**
+     * Called when the gamemode is loaded. [gmod.GetGamemode](https://wiki.facepunch.com/gmod/gmod.GetGamemode) will be functional at this point.
+     *
+     * [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer)() returns NULL at the time this is run.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnGamemodeLoaded
+     */
+    Add(eventName: "OnGamemodeLoaded", identifier: any, func: () => void): void;
+    /**
+     * Called when a Lua error occurs.
+     * If you want to retrieve client errors on the server side, you can use this hook: [GM:OnClientLuaError](https://wiki.facepunch.com/gmod/GM:OnClientLuaError)
+     * **NOTE**: On the [server realm](https://wiki.facepunch.com/gmod/States), this hook will only account for server-side errors, not client-side ones.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/GM:OnLuaError
+     */
+    Add(eventName: "OnLuaError", identifier: any, func: (error: string, realm: string, stack: table, name: string, id: string) => void): void;
+    /**
+     * 		Called when a Addon Conflict occurs, only works in the Menu realm.
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:OnNotifyAddonConflict
+     */
+    Add(eventName: "OnNotifyAddonConflict", identifier: any, func: (addon1: string, addon2: string, fileName: string) => void): void;
+    /**
+     * Called whenever an NPC drops an item upon its death, such as health kits, armor batteries, etc.
+     *
+     * It will NOT be called for dropped weapons, with exception of Half-Life: Source NPCs, since they don't use actual weapon entities and create a weapon entity on death.
+     * [GM:PlayerDroppedWeapon](https://wiki.facepunch.com/gmod/GM:PlayerDroppedWeapon) works for NPC weapon drops already. (Yes, it's not a typo)
+     *
+     * It will also not be called for live grenades spawned by Zombine.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnNPCDropItem
+     */
+    Add(eventName: "OnNPCDropItem", identifier: any, func: (npc: NPC, item: Entity) => void): void;
+    /**
+     * Called whenever an NPC is killed.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnNPCKilled
+     */
+    Add(eventName: "OnNPCKilled", identifier: any, func: (npc: NPC, attacker: Entity, inflictor: Entity) => void): void;
+    /**
+     * 	Called when the main menu has been blocked by [GM:OnPauseMenuShow](https://wiki.facepunch.com/gmod/GM:OnPauseMenuShow) four times in a small interval. This is used internally to explain to the user that they can hold SHIFT to force open the main menu.
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:OnPauseMenuBlockedTooManyTimes
+     */
+    Add(eventName: "OnPauseMenuBlockedTooManyTimes", identifier: any, func: () => void): void;
+    /**
+     * 	Called when the pause menu is attempting to be opened. Allows you to prevent the main menu from being opened that time.
+     *
+     * 	The user can hold SHIFT to not call this hook. If the main menu is blocked multiple times in short succession, a warning will be displayed to the end user on how to bypass the hook.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnPauseMenuShow
+     */
+    Add(eventName: "OnPauseMenuShow", identifier: any, func: () => boolean): void;
+    /**
+     * 		Called when a permission gets Granted or Revoked.
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:OnPermissionsChanged
+     */
+    Add(eventName: "OnPermissionsChanged", identifier: any, func: () => void): void;
+    /**
+     * Called when a player freezes an entity with the physgun.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPhysgunFreeze
+     */
+    Add(eventName: "OnPhysgunFreeze", identifier: any, func: (weapon: Entity, physobj: PhysObj, ent: Entity, ply: Player) => boolean): void;
+    /**
+     * Called to when a player has successfully picked up an entity with their Physics Gun.
+     *
+     * Not to be confused with [GM:PhysgunPickup](https://wiki.facepunch.com/gmod/GM:PhysgunPickup) which is called to ask if the player should be able to pick up an entity.
+     *
+     *
+     * See [GM:GravGunOnPickedUp](https://wiki.facepunch.com/gmod/GM:GravGunOnPickedUp) for the Gravity Gun pickup variant.
+     * See [GM:OnPlayerPhysicsPickup](https://wiki.facepunch.com/gmod/GM:OnPlayerPhysicsPickup) for the player `+use` pickup variant.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPhysgunPickup
+     */
+    Add(eventName: "OnPhysgunPickup", identifier: any, func: (ply: Player, ent: Entity) => void): void;
+    /**
+     * Called when a player reloads with the physgun. Override this to disable default unfreezing behavior.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPhysgunReload
+     */
+    Add(eventName: "OnPhysgunReload", identifier: any, func: (physgun: Weapon, ply: Player) => boolean): void;
+    /**
+     * Called when a player has changed team using [GM:PlayerJoinTeam](https://wiki.facepunch.com/gmod/GM:PlayerJoinTeam).
+     *
+     * **WARNING**: This hook will not work with [hook.Add](https://wiki.facepunch.com/gmod/hook.Add) and it is only called manually from [GM:PlayerJoinTeam](https://wiki.facepunch.com/gmod/GM:PlayerJoinTeam) by the base gamemode
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerChangedTeam
+     * @deprecated Use GM:PlayerChangedTeam instead, which works for every Player:SetTeam call.
+     */
+    Add(eventName: "OnPlayerChangedTeam", identifier: any, func: (ply: Player, oldTeam: number, newTeam: number) => void): void;
+    /**
+     * Called whenever a player sends a chat message. For the serverside equivalent, see [GM:PlayerSay](https://wiki.facepunch.com/gmod/GM:PlayerSay).
+     * **NOTE**: The input (or suppression) of this hook is based on the output from [GM:PlayerSay](https://wiki.facepunch.com/gmod/GM:PlayerSay). Chat events suppressed serverside do not call this hook.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerChat
+     */
+    Add(eventName: "OnPlayerChat", identifier: any, func: (ply: Player, text: string, teamChat: boolean, isDead: boolean) => boolean): void;
+    /**
+     * Called when a player makes contact with the ground after a jump or a fall.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerHitGround
+     */
+    Add(eventName: "OnPlayerHitGround", identifier: any, func: (player: Entity, inWater: boolean, onFloater: boolean, speed: number) => boolean): void;
+    /**
+     * Called when a player jumps.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerJump
+     */
+    Add(eventName: "OnPlayerJump", identifier: any, func: (player: Entity, speed: number) => void): void;
+    /**
+     * Called when a player +use drops an entity.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerPhysicsDrop
+     */
+    Add(eventName: "OnPlayerPhysicsDrop", identifier: any, func: (ply: Player, ent: Entity, thrown: boolean) => void): void;
+    /**
+     * Called when a player +use pickups up an entity. This will be called after the entity passes though [GM:AllowPlayerPickup](https://wiki.facepunch.com/gmod/GM:AllowPlayerPickup).
+     *
+     * See [GM:GravGunOnPickedUp](https://wiki.facepunch.com/gmod/GM:GravGunOnPickedUp) for the Gravity Gun pickup variant.
+     * See [GM:OnPhysgunPickup](https://wiki.facepunch.com/gmod/GM:OnPhysgunPickup) for the Physics Gun pickup variant.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:OnPlayerPhysicsPickup
+     */
+    Add(eventName: "OnPlayerPhysicsPickup", identifier: any, func: (ply: Player, ent: Entity) => void): void;
+    /**
+     * Called when gamemode has been reloaded by auto refresh.
+     *
+     * **NOTE**: It seems that this event can be triggered more than once for a single refresh event.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnReloaded
+     */
+    Add(eventName: "OnReloaded", identifier: any, func: () => void): void;
+    /**
+     * Called when the player's screen resolution of the game changes. This also called when changing MSAA settings.
+     *
+     * [Global.ScrW](https://wiki.facepunch.com/gmod/Global.ScrW) and [Global.ScrH](https://wiki.facepunch.com/gmod/Global.ScrH) will return the new values when this hook is called.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnScreenSizeChanged
+     */
+    Add(eventName: "OnScreenSizeChanged", identifier: any, func: (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void): void;
+    /**
+     * Called when a player releases the `+menu` bind on their keyboard, which is bound to Q by default.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnSpawnMenuClose
+     */
+    Add(eventName: "OnSpawnMenuClose", identifier: any, func: () => void): void;
+    /**
+     * Called when a player presses the `+menu` bind on their keyboard, which is bound to Q by default.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnSpawnMenuOpen
+     */
+    Add(eventName: "OnSpawnMenuOpen", identifier: any, func: () => void): void;
+    /**
+     * Called when a [DTextEntry](https://wiki.facepunch.com/gmod/DTextEntry) gets focus.
+     *
+     * This hook is run from [DTextEntry:OnGetFocus](https://wiki.facepunch.com/gmod/DTextEntry:OnGetFocus) and [PANEL:OnMousePressed](https://wiki.facepunch.com/gmod/PANEL:OnMousePressed) of [DTextEntry](https://wiki.facepunch.com/gmod/DTextEntry).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnTextEntryGetFocus
+     */
+    Add(eventName: "OnTextEntryGetFocus", identifier: any, func: (panel: Panel) => void): void;
+    /**
+     * Called when a [DTextEntry](https://wiki.facepunch.com/gmod/DTextEntry) loses focus.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnTextEntryLoseFocus
+     */
+    Add(eventName: "OnTextEntryLoseFocus", identifier: any, func: (panel: Panel) => void): void;
+    /**
+     * Called when the player undoes something.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:OnUndo
+     */
+    Add(eventName: "OnUndo", identifier: any, func: (name: string, customText: string) => boolean): void;
+    /**
+     * Called when the player changes their weapon to another one - and their viewmodel model changes.
+     *
+     * This is not always called clientside.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:OnViewModelChanged
+     */
+    Add(eventName: "OnViewModelChanged", identifier: any, func: (viewmodel: Entity, oldModel: string, newModel: string) => void): void;
+    /**
+     * Called when a player drops an entity with the Physgun.
+     *
+     * See [GM:GravGunOnDropped](https://wiki.facepunch.com/gmod/GM:GravGunOnDropped) for the Gravity Gun drop variant.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PhysgunDrop
+     */
+    Add(eventName: "PhysgunDrop", identifier: any, func: (player: Player, entity: Entity) => void): void;
+    /**
+     * Called to determine if a player should be able to pick up an entity with the Physics Gun.
+     *
+     * See [GM:OnPhysgunPickup](https://wiki.facepunch.com/gmod/GM:OnPhysgunPickup) for a hook which is called when a player has successfully picked up an entity.
+     *
+     * See [GM:GravGunPickupAllowed](https://wiki.facepunch.com/gmod/GM:GravGunPickupAllowed) for the Gravity Gun pickup variant.
+     * See [GM:AllowPlayerPickup](https://wiki.facepunch.com/gmod/GM:AllowPlayerPickup) for the `+USE` pickup variant.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PhysgunPickup
+     */
+    Add(eventName: "PhysgunPickup", identifier: any, func: (player: Player, entity: Entity) => boolean): void;
+    /**
+     * Called after player's reserve ammo count changes.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerAmmoChanged
+     */
+    Add(eventName: "PlayerAmmoChanged", identifier: any, func: (ply: Player, ammoID: number, oldCount: number, newCount: number) => void): void;
+    /**
+     * Called after the player gets their [Player:UniqueID](https://wiki.facepunch.com/gmod/Player:UniqueID) set for the first time. This hook will also be called in singleplayer.
+     *
+     * See [GM:NetworkIDValidated](https://wiki.facepunch.com/gmod/GM:NetworkIDValidated) for a hook that is called with the player's SteamID is validated by Steam.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerAuthed
+     */
+    Add(eventName: "PlayerAuthed", identifier: any, func: (ply: Player, steamid: string, uniqueid: string) => void): void;
+    /**
+     * Runs when a bind has been pressed. Allows to block commands.
+     *
+     * **NOTE**: By using the "alias" console command, this hook can be effectively circumvented. To prevent this use [input.TranslateAlias](https://wiki.facepunch.com/gmod/input.TranslateAlias).
+     *
+     * To stop the user from using `+attack`, `+left` and any other movement commands of the sort, please look into using [GM:StartCommand](https://wiki.facepunch.com/gmod/GM:StartCommand) instead.
+     *
+     *
+     * The third argument will always be true.
+     *
+     * This does not run for function keys binds (F1-F12).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerBindPress
+     */
+    Add(eventName: "PlayerBindPress", identifier: any, func: (ply: Player, bind: string, pressed: boolean, code: number) => boolean): void;
+    /**
+     * Called when a player presses a button.
+     *
+     * This will not be called if player has a panel opened with keyboard input enabled, use [PANEL:OnKeyCodePressed](https://wiki.facepunch.com/gmod/PANEL:OnKeyCodePressed) instead.
+     *
+     * See [GM:KeyPress](https://wiki.facepunch.com/gmod/GM:KeyPress) for an alternative that uses [Enums/IN](https://wiki.facepunch.com/gmod/Enums/IN).
+     * See [GM:PlayerButtonUp](https://wiki.facepunch.com/gmod/GM:PlayerButtonUp) for the "key release" event.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerButtonDown
+     */
+    Add(eventName: "PlayerButtonDown", identifier: any, func: (ply: Player, button: BUTTON_CODE) => void): void;
+    /**
+     * Called when a player releases a button.
+     *
+     * This will not be called if player has a panel opened with keyboard input enabled, use [PANEL:OnKeyCodeReleased](https://wiki.facepunch.com/gmod/PANEL:OnKeyCodeReleased) instead.
+     *
+     * See [GM:KeyRelease](https://wiki.facepunch.com/gmod/GM:KeyRelease) for an alternative that uses [Enums/IN](https://wiki.facepunch.com/gmod/Enums/IN).
+     * See [GM:PlayerButtonDown](https://wiki.facepunch.com/gmod/GM:PlayerButtonDown) for the "key press" event.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerButtonUp
+     */
+    Add(eventName: "PlayerButtonUp", identifier: any, func: (ply: Player, button: BUTTON_CODE) => void): void;
+    /**
+     * Decides whether a player can hear another player using voice chat.
+     *
+     * **WARNING**: This hook is called **players count * speaking players count** times every 0.3 seconds if at least 1 player is talking or every 5 seconds if no one is talking.
+     * 	You should ensure that your code is efficient, or this will definitely influence performance.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCanHearPlayersVoice
+     */
+    Add(eventName: "PlayerCanHearPlayersVoice", identifier: any, func: (listener: Player, talker: Player) => (boolean, boolean)): void;
+    /**
+     * 		Returns whether or not a player is allowed to join a team
+     * 		**WARNING**: This hook will not work with [hook.Add](https://wiki.facepunch.com/gmod/hook.Add) and it is only called manually from [GM:PlayerJoinTeam](https://wiki.facepunch.com/gmod/GM:PlayerJoinTeam) by the base gamemode
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCanJoinTeam
+     */
+    Add(eventName: "PlayerCanJoinTeam", identifier: any, func: (ply: Player, team: number) => boolean): void;
+    /**
+     * Returns whether or not a player is allowed to pick an item up. (ammo, health, armor)
+     *
+     * This will typically only work for base game entities, unless mod authors that implement similar entities also manually call this hook.
+     *
+     * See [GM:PlayerCanPickupWeapon](https://wiki.facepunch.com/gmod/GM:PlayerCanPickupWeapon) for a hook that controls weapon pickups.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCanPickupItem
+     */
+    Add(eventName: "PlayerCanPickupItem", identifier: any, func: (ply: Player, item: Entity) => boolean): void;
+    /**
+     * 	Returns whether or not a player is allowed to pick up a weapon.
+     *
+     *  	If this returns `false`, [Player:Give](https://wiki.facepunch.com/gmod/Player:Give) won't work.
+     *
+     * See [GM:PlayerCanPickupItem](https://wiki.facepunch.com/gmod/GM:PlayerCanPickupItem) for a hook that affects things like health kits, armor batteries and ammo entities.
+     *
+     * See [GM:WeaponEquip](https://wiki.facepunch.com/gmod/GM:WeaponEquip) for a hook that is called when a player successfully picks up a weapon after passing this hook.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCanPickupWeapon
+     */
+    Add(eventName: "PlayerCanPickupWeapon", identifier: any, func: (ply: Player, weapon: Weapon) => boolean): void;
+    /**
+     * Returns whether or not the player can see the other player's chat.
+     * **NOTE**: The **speaker** parameter does not have to be a valid [Player](https://wiki.facepunch.com/gmod/Player) object which happens when console messages are displayed for example.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCanSeePlayersChat
+     */
+    Add(eventName: "PlayerCanSeePlayersChat", identifier: any, func: (text: string, teamOnly: boolean, listener: Player, speaker: Player) => boolean): void;
+    /**
+     * Called when a player has changed team using [Player:SetTeam](https://wiki.facepunch.com/gmod/Player:SetTeam).
+     * 	**WARNING**: Avoid calling [Player:SetTeam](https://wiki.facepunch.com/gmod/Player:SetTeam) in this hook as it may cause an infinite loop!
+     *
+     * 	**WARNING**: [Player:Team](https://wiki.facepunch.com/gmod/Player:Team) inside this hook will return `oldTeam`.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerChangedTeam
+     */
+    Add(eventName: "PlayerChangedTeam", identifier: any, func: (ply: Player, oldTeam: number, newTeam: number) => void): void;
+    /**
+     * Called whenever a player is about to spawn something to see if they hit a limit for whatever they are spawning.
+     * 	**NOTE**: This hook will not be called in singleplayer, as singleplayer does not have limits.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerCheckLimit
+     */
+    Add(eventName: "PlayerCheckLimit", identifier: any, func: (ply: Player, limitName: string, current: number, defaultMax: number) => boolean): void;
+    /**
+     * **INTERNAL**: This is used internally - although you're able to use it you probably shouldn't.
+     *
+     *
+     * Called whenever a player's class is changed on the server-side with [player_manager.SetPlayerClass](https://wiki.facepunch.com/gmod/player_manager.SetPlayerClass).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerClassChanged
+     */
+    Add(eventName: "PlayerClassChanged", identifier: any, func: (ply: Player, newID: number) => void): void;
+    /**
+     * Executes when a player connects to the server. Called before the player has been assigned a [UserID](https://wiki.facepunch.com/gmod/Player:UserID) and entity. See the [player_connect](https://wiki.facepunch.com/gmod/gameevent/player_connect) gameevent for a version of this hook called after the player entity has been created.
+     *
+     * **NOTE**: This is only called clientside for listen server hosts.
+     *
+     * **NOTE**: This is not called clientside for the local player.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerConnect
+     */
+    Add(eventName: "PlayerConnect", identifier: any, func: (name: string, ip: string) => void): void;
+    /**
+     * Called when a player is killed by [Player:Kill](https://wiki.facepunch.com/gmod/Player:Kill) or any other normal means.
+     *
+     * This hook is **not** called if the player is killed by [Player:KillSilent](https://wiki.facepunch.com/gmod/Player:KillSilent). See [GM:PlayerSilentDeath](https://wiki.facepunch.com/gmod/GM:PlayerSilentDeath) for that.
+     *
+     * * [GM:DoPlayerDeath](https://wiki.facepunch.com/gmod/GM:DoPlayerDeath) is called **before** this hook.
+     * * [GM:PostPlayerDeath](https://wiki.facepunch.com/gmod/GM:PostPlayerDeath) is called **after** this hook.
+     *
+     * See [Player:LastHitGroup](https://wiki.facepunch.com/gmod/Player:LastHitGroup) if you need to get the last hit hitgroup of the player.
+     *
+     * **NOTE**: [Player:Alive](https://wiki.facepunch.com/gmod/Player:Alive) will return false in this hook.
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDeath
+     */
+    Add(eventName: "PlayerDeath", identifier: any, func: (victim: Player, inflictor: Entity, attacker: Entity) => void): void;
+    /**
+     * Returns whether or not the default death sound should be muted.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDeathSound
+     */
+    Add(eventName: "PlayerDeathSound", identifier: any, func: (ply: Player) => boolean): void;
+    /**
+     * Called every think while the player is dead. The return value will determine if the player respawns.
+     *
+     * Overwriting this function will prevent players from respawning by pressing space or clicking.
+     *
+     * This hook is not called for players with the [FL_FROZEN](https://wiki.facepunch.com/gmod/Enums/FL) flag applied.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDeathThink
+     */
+    Add(eventName: "PlayerDeathThink", identifier: any, func: (ply: Player) => boolean): void;
+    /**
+     * Called when a player leaves the server. See the [player_disconnect gameevent](https://wiki.facepunch.com/gmod/gameevent/player_disconnect) for a shared version of this hook.
+     *
+     * This is not called in single-player or listen servers for the host.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDisconnected
+     */
+    Add(eventName: "PlayerDisconnected", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called to update the player's animation during a drive.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDriveAnimate
+     */
+    Add(eventName: "PlayerDriveAnimate", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a weapon is dropped by a player via [Player:DropWeapon](https://wiki.facepunch.com/gmod/Player:DropWeapon). Despite its name, this hook is also called for NPC weapon drops.
+     *
+     * Also called when a weapon is removed from a player via [Player:StripWeapon](https://wiki.facepunch.com/gmod/Player:StripWeapon).
+     *
+     * See also [GM:WeaponEquip](https://wiki.facepunch.com/gmod/GM:WeaponEquip) for a hook when a player picks up a weapon.
+     *
+     * The weapon's [Entity:GetOwner](https://wiki.facepunch.com/gmod/Entity:GetOwner) will be NULL at the time this hook is called.
+     *
+     * [WEAPON:OnDrop](https://wiki.facepunch.com/gmod/WEAPON:OnDrop) will be called before this hook is.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerDroppedWeapon
+     */
+    Add(eventName: "PlayerDroppedWeapon", identifier: any, func: (owner: Player | NPC, wep: Weapon) => void): void;
+    /**
+     * Called when player stops using voice chat.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerEndVoice
+     */
+    Add(eventName: "PlayerEndVoice", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a player enters a vehicle.
+     *
+     * Called just after [GM:CanPlayerEnterVehicle](https://wiki.facepunch.com/gmod/GM:CanPlayerEnterVehicle).
+     *
+     * See also [GM:PlayerLeaveVehicle](https://wiki.facepunch.com/gmod/GM:PlayerLeaveVehicle).
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerEnteredVehicle
+     */
+    Add(eventName: "PlayerEnteredVehicle", identifier: any, func: (ply: Player, veh: Vehicle, role: number) => void): void;
+    /**
+     * Called before firing clientside animation events on a player model.
+     *
+     * See [GM:PlayerHandleAnimEvent](https://wiki.facepunch.com/gmod/GM:PlayerHandleAnimEvent) for the serverside version.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerFireAnimationEvent
+     */
+    Add(eventName: "PlayerFireAnimationEvent", identifier: any, func: (ply: Player, pos: Vector, ang: Angle, event: number, name: string) => boolean): void;
+    /**
+     * Called whenever a player steps. Return true to mute the normal sound.
+     *
+     * See [GM:PlayerStepSoundTime](https://wiki.facepunch.com/gmod/GM:PlayerStepSoundTime) for a related hook about footstep frequency.
+     * 		**NOTE**: This hook is called on all clients.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerFootstep
+     */
+    Add(eventName: "PlayerFootstep", identifier: any, func: (ply: Player, pos: Vector, foot: number, sound: string, volume: number, filter: CRecipientFilter) => boolean): void;
+    /**
+     * Called when a player freezes an object.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerFrozeObject
+     */
+    Add(eventName: "PlayerFrozeObject", identifier: any, func: (ply: Player, ent: Entity, physobj: PhysObj) => void): void;
+    /**
+     * Called before firing serverside animation events on the player models.
+     *
+     * See [GM:PlayerFireAnimationEvent](https://wiki.facepunch.com/gmod/GM:PlayerFireAnimationEvent) for the clientside version.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerHandleAnimEvent
+     */
+    Add(eventName: "PlayerHandleAnimEvent", identifier: any, func: (ply: Player, event: number, eventTime: number, cycle: number, type: number, options: string) => void): void;
+    /**
+     * Called when a player gets hurt.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerHurt
+     */
+    Add(eventName: "PlayerHurt", identifier: any, func: (victim: Player, attacker: Entity, healthRemaining: number, damageTaken: number) => void): void;
+    /**
+     * Called when the player spawns for the first time.
+     *
+     * See [GM:PlayerSpawn](https://wiki.facepunch.com/gmod/GM:PlayerSpawn) for a hook called every player spawn.
+     *
+     * **NOTE**: This hook is called before the player has fully loaded, when the player is still in seeing the `Starting Lua` screen. For example, trying to use the [Entity:GetModel](https://wiki.facepunch.com/gmod/Entity:GetModel) function will return the default model (`models/player.mdl`).
+     *
+     *
+     * **WARNING**: Sending [net](https://wiki.facepunch.com/gmod/net) messages to the spawned player in this hook may cause them to be received before the player finishes loading, for example [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer) might return NULL since [GM:InitPostEntity](https://wiki.facepunch.com/gmod/GM:InitPostEntity) may have not been called yet clientside though the net message **won't** be lost and the client still should receive it (more information here: https://github.com/Facepunch/garrysmod-requests/issues/718).
+     *
+     * Workaround without networking:
+     * ```
+     * local load_queue = {}
+     *
+     * hook.Add( "PlayerInitialSpawn", "myAddonName/Load", function( ply )
+     * 	load_queue[ ply ] = true
+     * end )
+     *
+     * hook.Add( "StartCommand", "myAddonName/Load", function( ply, cmd )
+     * 	if load_queue[ ply ] and not cmd:IsForced() then
+     * 		load_queue[ ply ] = nil
+     *
+     * 		-- Send what you need here if it requires the client to be fully loaded!
+     * 	end
+     * end )
+     * ```
+     *
+     *
+     * With networking:
+     * ```
+     * -- CLIENT
+     * hook.Add( "InitPostEntity", "Ready", function()
+     * 	net.Start( "cool_addon_client_ready" )
+     * 	net.SendToServer()
+     * end )
+     * ```
+     * ```
+     * -- SERVER
+     * util.AddNetworkString( "cool_addon_client_ready" )
+     *
+     * net.Receive( "cool_addon_client_ready", function( len, ply )
+     * 	-- Send what you need here!
+     * end )
+     * ```
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerInitialSpawn
+     */
+    Add(eventName: "PlayerInitialSpawn", identifier: any, func: (player: Player, transition: boolean) => void): void;
+    /**
+     * Makes the player join a specified team. This is a convenience function that calls [Player:SetTeam](https://wiki.facepunch.com/gmod/Player:SetTeam) and runs the [GM:OnPlayerChangedTeam](https://wiki.facepunch.com/gmod/GM:OnPlayerChangedTeam) hook.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerJoinTeam
+     */
+    Add(eventName: "PlayerJoinTeam", identifier: any, func: (ply: Player, team: number) => void): void;
+    /**
+     * Called when a player leaves a vehicle for any reason, including [Player:ExitVehicle](https://wiki.facepunch.com/gmod/Player:ExitVehicle).
+     *
+     * See [GM:PlayerEnteredVehicle](https://wiki.facepunch.com/gmod/GM:PlayerEnteredVehicle) for the opposite hook.
+     *
+     * **NOTE**: For vehicles with exit animations, this will be called **at the end** of the animation, **not at the start**!
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerLeaveVehicle
+     */
+    Add(eventName: "PlayerLeaveVehicle", identifier: any, func: (ply: Player, veh: Vehicle) => void): void;
+    /**
+     * Called to give players the default set of weapons.
+     *
+     *
+     * **NOTE**: This function may not work in your custom gamemode if you have overridden your [GM:PlayerSpawn](https://wiki.facepunch.com/gmod/GM:PlayerSpawn) and you do not use self.BaseClass.PlayerSpawn or [hook.Call](https://wiki.facepunch.com/gmod/hook.Call).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerLoadout
+     */
+    Add(eventName: "PlayerLoadout", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a player tries to switch noclip mode.
+     *
+     * [MOVETYPE_NOCLIP](https://wiki.facepunch.com/gmod/Enums/MOVETYPE#MOVETYPE_NOCLIP) can be used to determine if a player is currently in noclip mode.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerNoClip
+     */
+    Add(eventName: "PlayerNoClip", identifier: any, func: (ply: Player, desiredState: boolean) => boolean): void;
+    /**
+     * Called after the player's think, just after [GM:FinishMove](https://wiki.facepunch.com/gmod/GM:FinishMove).
+     *
+     *
+     * 		**NOTE**: On the client side, it is only called for the local player.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerPostThink
+     */
+    Add(eventName: "PlayerPostThink", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Request a player to join the team. This function will check if the team is available to join or not.
+     *
+     * This hook is called when the player runs "changeteam" in the console.
+     *
+     * To prevent the player from changing teams, see [GM:PlayerCanJoinTeam](https://wiki.facepunch.com/gmod/GM:PlayerCanJoinTeam)
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerRequestTeam
+     */
+    Add(eventName: "PlayerRequestTeam", identifier: any, func: (ply: Player, team: number) => void): void;
+    /**
+     * 		Called when a player dispatched a chat message. For the clientside equivalent, see [GM:OnPlayerChat](https://wiki.facepunch.com/gmod/GM:OnPlayerChat).
+     *
+     * 		**NOTE**: It may be more reliable to use [gameevent/player_say](https://wiki.facepunch.com/gmod/gameevent/player_say) to read messages serverside because addons commonly return values in this hook to change chat messages.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSay
+     */
+    Add(eventName: "PlayerSay", identifier: any, func: (sender: Player, text: string, teamChat: boolean) => string): void;
+    /**
+     * 		Called to determine a spawn point for a player to spawn at.
+     * 		**NOTE**: The spawn point entity will also impact the player's eye angle. For example, if the entity is upside down, the player's view will be as well.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSelectSpawn
+     */
+    Add(eventName: "PlayerSelectSpawn", identifier: any, func: (ply: Player, transition: boolean) => Entity): void;
+    /**
+     * Find a team spawn point entity for this player.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSelectTeamSpawn
+     */
+    Add(eventName: "PlayerSelectTeamSpawn", identifier: any, func: (team: number, ply: Player) => Entity): void;
+    /**
+     * Called whenever view model hands needs setting a model. By default this calls [PLAYER:GetHandsModel](https://wiki.facepunch.com/gmod/PLAYER:GetHandsModel) and if that fails, sets the hands model according to his player model.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSetHandsModel
+     */
+    Add(eventName: "PlayerSetHandsModel", identifier: any, func: (ply: Player, ent: Entity) => void): void;
+    /**
+     * Called whenever a player spawns and must choose a model. A good place to assign a model to a player.
+     * **NOTE**: This function may not work in your custom gamemode if you have overridden your [GM:PlayerSpawn](https://wiki.facepunch.com/gmod/GM:PlayerSpawn) and you do not use [self.BaseClass.PlayerSpawn](https://wiki.facepunch.com/gmod/Global.DEFINE_BASECLASS) in it, or [hook.Call](https://wiki.facepunch.com/gmod/hook.Call) this hook from [GM:PlayerSpawn](https://wiki.facepunch.com/gmod/GM:PlayerSpawn).
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSetModel
+     */
+    Add(eventName: "PlayerSetModel", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Returns true if the player should take damage from the given attacker.
+     *
+     * **WARNING**: Applying damage from this hook to the player taking damage will lead to infinite loop/crash.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerShouldTakeDamage
+     */
+    Add(eventName: "PlayerShouldTakeDamage", identifier: any, func: (ply: Player, attacker: Entity) => boolean): void;
+    /**
+     * Allows to suppress player taunts.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerShouldTaunt
+     */
+    Add(eventName: "PlayerShouldTaunt", identifier: any, func: (ply: Player, act: number) => boolean): void;
+    /**
+     * Called when the player is killed by [Player:KillSilent](https://wiki.facepunch.com/gmod/Player:KillSilent).
+     *
+     * The player is already considered dead when this hook is called.
+     *
+     * * See [GM:PlayerDeath](https://wiki.facepunch.com/gmod/GM:PlayerDeath) for a hook which handles all other death causes.
+     * * [GM:PostPlayerDeath](https://wiki.facepunch.com/gmod/GM:PostPlayerDeath) is called **after** this hook.
+     *
+     * **NOTE**: [Player:Alive](https://wiki.facepunch.com/gmod/Player:Alive) will return true in this hook.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSilentDeath
+     */
+    Add(eventName: "PlayerSilentDeath", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called whenever a player spawns, including respawns.
+     *
+     * See [GM:PlayerInitialSpawn](https://wiki.facepunch.com/gmod/GM:PlayerInitialSpawn) for a hook called only the first time a player spawns.
+     *
+     * See the [player_spawn gameevent](https://wiki.facepunch.com/gmod/gameevent/player_spawn) for a shared version of this hook.
+     *
+     * **WARNING**: By default, in "base" derived gamemodes, this hook will also call [GM:PlayerLoadout](https://wiki.facepunch.com/gmod/GM:PlayerLoadout) and [GM:PlayerSetModel](https://wiki.facepunch.com/gmod/GM:PlayerSetModel), which may override your [Entity:SetModel](https://wiki.facepunch.com/gmod/Entity:SetModel) and [Player:Give](https://wiki.facepunch.com/gmod/Player:Give) calls. Consider using the other hooks or a 0-second timer.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSpawn
+     */
+    Add(eventName: "PlayerSpawn", identifier: any, func: (player: Player, transition: boolean) => void): void;
+    /**
+     * Called to spawn the player as a spectator.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSpawnAsSpectator
+     */
+    Add(eventName: "PlayerSpawnAsSpectator", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Determines if the player can spray using the `impulse 201` console command.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSpray
+     */
+    Add(eventName: "PlayerSpray", identifier: any, func: (sprayer: Player) => boolean): void;
+    /**
+     * Called when player starts taunting.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerStartTaunt
+     */
+    Add(eventName: "PlayerStartTaunt", identifier: any, func: (ply: Player, act: number, length: number) => void): void;
+    /**
+     * Called when a player starts using voice chat.
+     * **NOTE**: Set mp_show_voice_icons to 0, if you want disable icons above player.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerStartVoice
+     */
+    Add(eventName: "PlayerStartVoice", identifier: any, func: (ply: Player, plyIndex?: number) => boolean): void;
+    /**
+     * Allows you to override the time between footsteps.
+     *
+     * See [GM:PlayerFootstep](https://wiki.facepunch.com/gmod/GM:PlayerFootstep) for a related hook about footstep sounds themselves.
+     * 		**NOTE**: This hook is called on all clients.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerStepSoundTime
+     */
+    Add(eventName: "PlayerStepSoundTime", identifier: any, func: (ply: Player, type: number, walking: boolean) => number): void;
+    /**
+     * Called whenever a player attempts to either turn on or off their flashlight, returning false will deny the change.
+     * **NOTE**: Also gets called when using [Player:Flashlight](https://wiki.facepunch.com/gmod/Player:Flashlight).
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSwitchFlashlight
+     */
+    Add(eventName: "PlayerSwitchFlashlight", identifier: any, func: (ply: Player, enabled: boolean) => boolean): void;
+    /**
+     * Called when a player attempts to switch their weapon.
+     *
+     * Primary usage of this hook is to prevent/allow weapon switching, **not** to detect weapon switching. It will not be called for [Player:SetActiveWeapon](https://wiki.facepunch.com/gmod/Player:SetActiveWeapon).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerSwitchWeapon
+     */
+    Add(eventName: "PlayerSwitchWeapon", identifier: any, func: (player: Player, oldWeapon: Weapon, newWeapon: Weapon) => boolean): void;
+    /**
+     * The Move hook is called for you to manipulate the player's [CMoveData](https://wiki.facepunch.com/gmod/CMoveData). This hook is called moments before [GM:Move](https://wiki.facepunch.com/gmod/GM:Move) and [GM:PlayerNoClip](https://wiki.facepunch.com/gmod/GM:PlayerNoClip).
+     *
+     * **WARNING**: This hook will not run when inside a vehicle. [GM:VehicleMove](https://wiki.facepunch.com/gmod/GM:VehicleMove) will be called instead.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerTick
+     */
+    Add(eventName: "PlayerTick", identifier: any, func: (player: Player, mv: CMoveData) => void): void;
+    /**
+     * Called when a player has been hit by a trace and damaged (such as from a bullet). Returning true overrides the damage handling and prevents [GM:ScalePlayerDamage](https://wiki.facepunch.com/gmod/GM:ScalePlayerDamage) from being called.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerTraceAttack
+     */
+    Add(eventName: "PlayerTraceAttack", identifier: any, func: (ply: Player, dmginfo: CTakeDamageInfo, dir: Vector, trace: TraceResult) => boolean): void;
+    /**
+     * Called when a player unfreezes an object.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerUnfrozeObject
+     */
+    Add(eventName: "PlayerUnfrozeObject", identifier: any, func: (ply: Player, ent: Entity, physobj: PhysObj) => void): void;
+    /**
+     * Triggered when the player presses use on an object. Continuously runs until USE is released but will not activate other Entities until the USE key is released; dependent on activation type of the Entity.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PlayerUse
+     */
+    Add(eventName: "PlayerUse", identifier: any, func: (ply: Player, ent: Entity) => boolean): void;
+    /**
+     * Called when it's time to populate the context menu menu bar at the top.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PopulateMenuBar
+     */
+    Add(eventName: "PopulateMenuBar", identifier: any, func: (menubar: Panel) => void): void;
+    /**
+     * Called right after the map has cleaned up (usually because [game.CleanUpMap](https://wiki.facepunch.com/gmod/game.CleanUpMap) was called)
+     *
+     * See also [GM:PreCleanupMap](https://wiki.facepunch.com/gmod/GM:PreCleanupMap).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PostCleanupMap
+     */
+    Add(eventName: "PostCleanupMap", identifier: any, func: () => void): void;
+    /**
+     * Called right after the 2D skybox has been drawn - allowing you to draw over it.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDraw2DSkyBox
+     */
+    Add(eventName: "PostDraw2DSkyBox", identifier: any, func: () => void): void;
+    /**
+     * Called after rendering effects. This is where halos are drawn. Called just before [GM:PreDrawHUD](https://wiki.facepunch.com/gmod/GM:PreDrawHUD) (The two hooks are basically identical).
+     *
+     * See [GM:PreDrawEffects](https://wiki.facepunch.com/gmod/GM:PreDrawEffects) for the associated hook.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawEffects
+     */
+    Add(eventName: "PostDrawEffects", identifier: any, func: () => void): void;
+    /**
+     * Called after [GM:PreDrawHUD](https://wiki.facepunch.com/gmod/GM:PreDrawHUD),  [GM:HUDPaintBackground](https://wiki.facepunch.com/gmod/GM:HUDPaintBackground) and [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint) but before  [GM:DrawOverlay](https://wiki.facepunch.com/gmod/GM:DrawOverlay).
+     *
+     * Unlike [GM:HUDPaint](https://wiki.facepunch.com/gmod/GM:HUDPaint)([Background](https://wiki.facepunch.com/gmod/GM:HUDPaintBackground)) hooks, this will still be called when the main menu is visible. And so will be [GM:PreDrawHUD](https://wiki.facepunch.com/gmod/GM:PreDrawHUD)
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawHUD
+     */
+    Add(eventName: "PostDrawHUD", identifier: any, func: () => void): void;
+    /**
+     * Called after drawing opaque entities.
+     *
+     * See also [GM:PostDrawTranslucentRenderables](https://wiki.facepunch.com/gmod/GM:PostDrawTranslucentRenderables) and [GM:PreDrawOpaqueRenderables](https://wiki.facepunch.com/gmod/GM:PreDrawOpaqueRenderables).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawOpaqueRenderables
+     */
+    Add(eventName: "PostDrawOpaqueRenderables", identifier: any, func: (bDrawingDepth: boolean, bDrawingSkybox: boolean, isDraw3DSkybox: boolean) => void): void;
+    /**
+     * Called after the player hands are drawn.
+     *
+     * See [GM:PostDrawViewModel](https://wiki.facepunch.com/gmod/GM:PostDrawViewModel) for the view model alternative.
+     * See [GM:PreDrawPlayerHands](https://wiki.facepunch.com/gmod/GM:PreDrawPlayerHands) for a hook that is called just before view model hands are drawn.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawPlayerHands
+     */
+    Add(eventName: "PostDrawPlayerHands", identifier: any, func: (hands: Entity, vm: Entity, ply: Player, weapon: Weapon, flags: number) => void): void;
+    /**
+     * Called after drawing the 3D skybox. This will not be called if skybox rendering was prevented via the [GM:PreDrawSkyBox](https://wiki.facepunch.com/gmod/GM:PreDrawSkyBox) hook.
+     *
+     * See also [GM:PostDraw2DSkyBox](https://wiki.facepunch.com/gmod/GM:PostDraw2DSkyBox).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawSkyBox
+     */
+    Add(eventName: "PostDrawSkyBox", identifier: any, func: () => void): void;
+    /**
+     * Called after all translucent entities are drawn.
+     *
+     * See also [GM:PostDrawOpaqueRenderables](https://wiki.facepunch.com/gmod/GM:PostDrawOpaqueRenderables) and  [GM:PreDrawTranslucentRenderables](https://wiki.facepunch.com/gmod/GM:PreDrawTranslucentRenderables).
+     *
+     *
+     *
+     * This is still called when r_drawentities or r_drawopaquerenderables is disabled.
+     * This is not called when r_drawtranslucentworld is disabled.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawTranslucentRenderables
+     */
+    Add(eventName: "PostDrawTranslucentRenderables", identifier: any, func: (bDrawingDepth: boolean, bDrawingSkybox: boolean, isDraw3DSkybox: boolean) => void): void;
+    /**
+     * Called after view model is drawn.
+     *
+     * The render FOV in this hook is different from the main view, as view models are usually rendered with a different FOV. Every render operation will only be accurate with the view model entity.
+     *
+     * See [GM:PreDrawViewModel](https://wiki.facepunch.com/gmod/GM:PreDrawViewModel) for a hook that is called just before a view model is drawn.
+     *
+     * For view model hands alternative, see [GM:PostDrawPlayerHands](https://wiki.facepunch.com/gmod/GM:PostDrawPlayerHands).
+     *
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostDrawViewModel
+     */
+    Add(eventName: "PostDrawViewModel", identifier: any, func: (viewmodel: Entity, player: Player, weapon: Weapon, flags: number) => void): void;
+    /**
+     * Called every time a bullet pellet (i.e. this hook is called multiple times for a shotgun shot) is fired from an entity. Notably this hook will have the final damage and aim direction for the bullet pellet.
+     *
+     * See [GM:EntityFireBullets](https://wiki.facepunch.com/gmod/GM:EntityFireBullets) if you wish to modify the bullets before they are fired.
+     *
+     * **WARNING**: This hook is called directly from [Entity:FireBullets](https://wiki.facepunch.com/gmod/Entity:FireBullets). Due to this, you cannot call [Entity:FireBullets](https://wiki.facepunch.com/gmod/Entity:FireBullets) inside this hook or an infinite loop will occur crashing the game.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PostEntityFireBullets
+     */
+    Add(eventName: "PostEntityFireBullets", identifier: any, func: (entity: Entity, data: FiredBullet) => boolean): void;
+    /**
+     * Called when an entity receives a damage event, after passing damage filters, etc.
+     *
+     * See [GM:EntityTakeDamage](https://wiki.facepunch.com/gmod/GM:EntityTakeDamage) if you wish to prevent damage events, or otherwise alter them.
+     *
+     * **WARNING**: Applying damage from this hook to the entity taking damage will lead to infinite loop/crash.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PostEntityTakeDamage
+     */
+    Add(eventName: "PostEntityTakeDamage", identifier: any, func: (ent: Entity, dmginfo: CTakeDamageInfo, wasDamageTaken: boolean) => void): void;
+    /**
+     * Called after the gamemode has loaded.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PostGamemodeLoaded
+     */
+    Add(eventName: "PostGamemodeLoaded", identifier: any, func: () => void): void;
+    /**
+     * Called right after [GM:DoPlayerDeath](https://wiki.facepunch.com/gmod/GM:DoPlayerDeath), [GM:PlayerDeath](https://wiki.facepunch.com/gmod/GM:PlayerDeath) and [GM:PlayerSilentDeath](https://wiki.facepunch.com/gmod/GM:PlayerSilentDeath).
+     *
+     * This hook will be called for all deaths, including [Player:KillSilent](https://wiki.facepunch.com/gmod/Player:KillSilent)
+     *
+     * **NOTE**: [Player:Alive](https://wiki.facepunch.com/gmod/Player:Alive) will return false in this hook.
+     *
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PostPlayerDeath
+     */
+    Add(eventName: "PostPlayerDeath", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called after a given player in your [PVS (Potential Visibility Set)](https://developer.valvesoftware.com/wiki/PVS "PVS - Valve Developer Community") was drawn.
+     *
+     * This hook will not be called if player was prevented from being drawn via [GM:PrePlayerDraw](https://wiki.facepunch.com/gmod/GM:PrePlayerDraw).
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostPlayerDraw
+     */
+    Add(eventName: "PostPlayerDraw", identifier: any, func: (ply: Player, flags: number) => void): void;
+    /**
+     * Allows you to suppress post processing effect drawing.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostProcessPermitted
+     */
+    Add(eventName: "PostProcessPermitted", identifier: any, func: (effect_name: string) => boolean): void;
+    /**
+     * Called after the frame has been rendered.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostRender
+     */
+    Add(eventName: "PostRender", identifier: any, func: () => void): void;
+    /**
+     * Called after the VGUI has been drawn.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PostRenderVGUI
+     */
+    Add(eventName: "PostRenderVGUI", identifier: any, func: () => void): void;
+    /**
+     * Called just after performing an undo.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PostUndo
+     */
+    Add(eventName: "PostUndo", identifier: any, func: (undo: Undo, count: number) => void): void;
+    /**
+     * Called right before the map cleans up (usually because [game.CleanUpMap](https://wiki.facepunch.com/gmod/game.CleanUpMap) was called)
+     *
+     * See also [GM:PostCleanupMap](https://wiki.facepunch.com/gmod/GM:PostCleanupMap).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PreCleanupMap
+     */
+    Add(eventName: "PreCleanupMap", identifier: any, func: () => void): void;
+    /**
+     * Called just after [GM:PreDrawViewModel](https://wiki.facepunch.com/gmod/GM:PreDrawViewModel) and can technically be considered as a "PostDrawAllViewModels".
+     *
+     * See [GM:PostDrawEffects](https://wiki.facepunch.com/gmod/GM:PostDrawEffects) for the associated hook.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawEffects
+     */
+    Add(eventName: "PreDrawEffects", identifier: any, func: () => void): void;
+    /**
+     * Called before rendering the halos. This is the place to call [halo.Add](https://wiki.facepunch.com/gmod/halo.Add). This hook is actually running inside of [GM:PostDrawEffects](https://wiki.facepunch.com/gmod/GM:PostDrawEffects).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawHalos
+     */
+    Add(eventName: "PreDrawHalos", identifier: any, func: () => void): void;
+    /**
+     * Called just after [GM:PostDrawEffects](https://wiki.facepunch.com/gmod/GM:PostDrawEffects) (duplicate of it). Drawing anything in it seems to work incorrectly.
+     *
+     * See [GM:PostDrawHUD](https://wiki.facepunch.com/gmod/GM:PostDrawHUD) for the associated hook.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawHUD
+     */
+    Add(eventName: "PreDrawHUD", identifier: any, func: () => void): void;
+    /**
+     * Called before all opaque entities are drawn.
+     *
+     * See also [GM:PreDrawTranslucentRenderables](https://wiki.facepunch.com/gmod/GM:PreDrawTranslucentRenderables) and  [GM:PostDrawOpaqueRenderables](https://wiki.facepunch.com/gmod/GM:PostDrawOpaqueRenderables).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawOpaqueRenderables
+     */
+    Add(eventName: "PreDrawOpaqueRenderables", identifier: any, func: (isDrawingDepth: boolean, isDrawSkybox: boolean, isDraw3DSkybox: boolean) => boolean): void;
+    /**
+     * Called before the player hands are drawn.
+     *
+     * See [GM:PreDrawViewModel](https://wiki.facepunch.com/gmod/GM:PreDrawViewModel) for the view model alternative.
+     * See [GM:PostDrawPlayerHands](https://wiki.facepunch.com/gmod/GM:PostDrawPlayerHands) for a hook that is called just before view model hands are drawn.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawPlayerHands
+     */
+    Add(eventName: "PreDrawPlayerHands", identifier: any, func: (hands: Entity, vm: Entity, ply: Player, weapon: Weapon, flags: number) => boolean): void;
+    /**
+     * Called before the 3D sky box is drawn. This will not be called for maps with no 3D skybox, or when the 3d skybox is disabled. (`r_3dsky 0`)
+     *
+     * See also [GM:PostDrawSkyBox](https://wiki.facepunch.com/gmod/GM:PostDrawSkyBox)
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawSkyBox
+     */
+    Add(eventName: "PreDrawSkyBox", identifier: any, func: () => boolean): void;
+    /**
+     * Called before all the translucent entities are drawn.
+     *
+     * See also [GM:PreDrawOpaqueRenderables](https://wiki.facepunch.com/gmod/GM:PreDrawOpaqueRenderables) and  [GM:PostDrawTranslucentRenderables](https://wiki.facepunch.com/gmod/GM:PostDrawTranslucentRenderables).
+     *
+     *
+     *
+     * This is still called when r_drawentities or r_drawopaquerenderables is disabled.
+     * This is not called when r_drawtranslucentworld is disabled.
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawTranslucentRenderables
+     */
+    Add(eventName: "PreDrawTranslucentRenderables", identifier: any, func: (isDrawingDepth: boolean, isDrawSkybox: boolean, isDraw3DSkybox: boolean) => boolean): void;
+    /**
+     * Called before the view model has been drawn.
+     *
+     * By default this hook also calls [WEAPON:PreDrawViewModel](https://wiki.facepunch.com/gmod/WEAPON:PreDrawViewModel), so you can use that if developing a scripted weapon.
+     *
+     * See [GM:PostDrawViewModel](https://wiki.facepunch.com/gmod/GM:PostDrawViewModel) for a hook that runs immediately after rendering a view model.
+     * See [GM:PreDrawViewModels](https://wiki.facepunch.com/gmod/GM:PreDrawViewModels) for a hook that runs before **all** view models are drawn within a frame.
+     *
+     * For view model hands, see [GM:PreDrawPlayerHands](https://wiki.facepunch.com/gmod/GM:PreDrawPlayerHands).
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawViewModel
+     */
+    Add(eventName: "PreDrawViewModel", identifier: any, func: (vm: Entity, ply: Player, weapon: Weapon, flags: number) => boolean): void;
+    /**
+     * Called just before all view models (there are 3 per player, see [Player:GetViewModel](https://wiki.facepunch.com/gmod/Player:GetViewModel)) and entities with `RENDERGROUP_VIEWMODEL` are drawn.
+     *
+     * See [GM:PreDrawViewModel](https://wiki.facepunch.com/gmod/GM:PreDrawViewModel) and [GM:PostDrawViewModel](https://wiki.facepunch.com/gmod/GM:PostDrawViewModel) for hooks that run for specific view models.
+     *
+     * You can use [GM:PreDrawEffects](https://wiki.facepunch.com/gmod/GM:PreDrawEffects) as a "`PostDrawViewModels`" hook as it is called just after the all the view model(s) are drawn.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreDrawViewModels
+     */
+    Add(eventName: "PreDrawViewModels", identifier: any, func: () => void): void;
+    /**
+     * Called before the gamemode is loaded.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PreGamemodeLoaded
+     */
+    Add(eventName: "PreGamemodeLoaded", identifier: any, func: () => void): void;
+    /**
+     * Called before the player is drawn.
+     *
+     * See also [GM:PostPlayerDraw](https://wiki.facepunch.com/gmod/GM:PostPlayerDraw).
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PrePlayerDraw
+     */
+    Add(eventName: "PrePlayerDraw", identifier: any, func: (player: Player, flags: number) => boolean): void;
+    /**
+     * Called by [scripted_ents.Register](https://wiki.facepunch.com/gmod/scripted_ents.Register).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PreRegisterSENT
+     */
+    Add(eventName: "PreRegisterSENT", identifier: any, func: (ent: table, _class: string) => boolean): void;
+    /**
+     * Called when a Scripted Weapon (SWEP) is about to be registered, allowing addons to alter the weapon's SWEP table with custom data for later usage. Called internally from [weapons.Register](https://wiki.facepunch.com/gmod/weapons.Register).
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PreRegisterSWEP
+     */
+    Add(eventName: "PreRegisterSWEP", identifier: any, func: (swep: table, _class: string) => boolean): void;
+    /**
+     * Called before the renderer is about to start rendering the next frame.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreRender
+     */
+    Add(eventName: "PreRender", identifier: any, func: () => boolean): void;
+    /**
+     * Called just before performing an undo.
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:PreUndo
+     */
+    Add(eventName: "PreUndo", identifier: any, func: (undo: Undo) => boolean): void;
+    /**
+     * This will prevent IN_ATTACK from sending to server when player tries to shoot from C menu.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:PreventScreenClicks
+     */
+    Add(eventName: "PreventScreenClicks", identifier: any, func: () => boolean): void;
+    /**
+     * Called when a prop has been destroyed.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:PropBreak
+     */
+    Add(eventName: "PropBreak", identifier: any, func: (attacker: Player, prop: Entity) => void): void;
+    /**
+     * Render the scene. Used by the `Stereoscopy` post-processing effect.
+     *
+     * **NOTE**: Materials rendered in this hook require `$ignorez` parameter to draw properly.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:RenderScene
+     */
+    Add(eventName: "RenderScene", identifier: any, func: (origin: Vector, angles: Angle, fov: number) => boolean): void;
+    /**
+     * Used to render post processing effects.
+     *
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:RenderScreenspaceEffects
+     */
+    Add(eventName: "RenderScreenspaceEffects", identifier: any, func: () => void): void;
+    /**
+     * Called when the game is reloaded from a Source Engine save system ( not the Sandbox saves or dupes ).
+     *
+     * See [GM:Saved](https://wiki.facepunch.com/gmod/GM:Saved) for a hook that is called when such a save file is created.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:Restored
+     */
+    Add(eventName: "Restored", identifier: any, func: () => void): void;
+    /**
+     * Called when the game is saved using the Source Engine save system (not the Sandbox saves or dupes).
+     *
+     * See [GM:Restored](https://wiki.facepunch.com/gmod/GM:Restored) for a hook that is called when such a save file is loaded.
+     *
+     * See also the [saverestore](https://wiki.facepunch.com/gmod/saverestore) for relevant functions.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:Saved
+     */
+    Add(eventName: "Saved", identifier: any, func: () => void): void;
+    /**
+     * Called when an NPC takes damage.
+     *
+     * **NOTE**: This hook is called only when a specific hit group of the NPC is hit. In cases where the hitgroup doesn't matter, you should use [GM:EntityTakeDamage](https://wiki.facepunch.com/gmod/GM:EntityTakeDamage) instead!
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:ScaleNPCDamage
+     */
+    Add(eventName: "ScaleNPCDamage", identifier: any, func: (npc: NPC, hitgroup: number, dmginfo: CTakeDamageInfo) => void): void;
+    /**
+     * This hook allows you to change how much damage a player receives when one takes damage to a specific body part.
+     *
+     * **NOTE**: This is called only for bullet damage a player receives, you should use [GM:EntityTakeDamage](https://wiki.facepunch.com/gmod/GM:EntityTakeDamage) instead if you need to detect **ALL** damage.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ScalePlayerDamage
+     */
+    Add(eventName: "ScalePlayerDamage", identifier: any, func: (ply: Player, hitgroup: number, dmginfo: CTakeDamageInfo) => boolean): void;
+    /**
+     * Called when player released the scoreboard button (TAB by default).
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ScoreboardHide
+     */
+    Add(eventName: "ScoreboardHide", identifier: any, func: () => void): void;
+    /**
+     * Called when player presses the scoreboard button (TAB by default).
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ScoreboardShow
+     */
+    Add(eventName: "ScoreboardShow", identifier: any, func: () => boolean): void;
+    /**
+     * An internal function used to send a death notice event to all clients.
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:SendDeathNotice
+     */
+    Add(eventName: "SendDeathNotice", identifier: any, func: (attacker: Entity | string | nil, inflictor: string, victim: Entity | string, flags: number) => void): void;
+    /**
+     * Sets player run and sprint speeds.
+     * Using a speed of `0` can lead to prediction errors, and can cause players to move at `sv_maxvelocity`
+     * **WARNING**: This is not a hook. Treat this as a utility function to set the player's speed.
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:SetPlayerSpeed
+     */
+    Add(eventName: "SetPlayerSpeed", identifier: any, func: (ply: Player, walkSpeed: number, runSpeed: number) => void): void;
+    /**
+     * SetupMove is called before the engine process movements. This allows us to override the players movement.
+     *
+     * See [Game Movement](https://wiki.facepunch.com/gmod/Game_Movement) for an explanation on the move system.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:SetupMove
+     */
+    Add(eventName: "SetupMove", identifier: any, func: (ply: Player, mv: CMoveData, cmd: CUserCmd) => void): void;
+    /**
+     * Allows you to add extra positions to the player's [PVS (Potential Visibility Set)](https://developer.valvesoftware.com/wiki/PVS "PVS - Valve Developer Community"). This is the place to call [Global.AddOriginToPVS](https://wiki.facepunch.com/gmod/Global.AddOriginToPVS).
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:SetupPlayerVisibility
+     */
+    Add(eventName: "SetupPlayerVisibility", identifier: any, func: (ply: Player, viewEntity: Entity) => void): void;
+    /**
+     * 		Allows you to use render.Fog* functions to manipulate skybox fog.
+     * 		This will not be called for maps with no 3D skybox, or when the 3d skybox is disabled. (`r_3dsky 0`)
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:SetupSkyboxFog
+     */
+    Add(eventName: "SetupSkyboxFog", identifier: any, func: (scale: number) => boolean): void;
+    /**
+     * Allows you to use render.Fog* functions to manipulate world fog.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:SetupWorldFog
+     */
+    Add(eventName: "SetupWorldFog", identifier: any, func: () => boolean): void;
+    /**
+     * Called to decide whether a pair of entities should collide with each other. This is only called if [Entity:SetCustomCollisionCheck](https://wiki.facepunch.com/gmod/Entity:SetCustomCollisionCheck) was used on one or both entities.
+     *
+     * Where applicable, consider using [constraint.NoCollide](https://wiki.facepunch.com/gmod/constraint.NoCollide) or a [logic_collision_pair](https://developer.valvesoftware.com/wiki/Logic_collision_pair) entity instead - they are considerably easier to use and may be more appropriate in some situations.
+     *
+     * **WARNING**: This hook **must** return the same value consistently for the same pair of entities.
+     * 	If an entity changed in such a way that its collision rules change, you **must** call [Entity:CollisionRulesChanged](https://wiki.facepunch.com/gmod/Entity:CollisionRulesChanged) on that entity immediately - **not in this hook and not in physics callbacks.**
+     * 	As long as you religiously follow the rules set by the examples this hook will work reliably without breaking, even a small mistake might break physics.
+     *
+     *
+     * This hook can cause all physics to break under certain conditions.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShouldCollide
+     */
+    Add(eventName: "ShouldCollide", identifier: any, func: (ent1: Entity, ent2: Entity) => boolean): void;
+    /**
+     * Called to determine if the [Global.LocalPlayer](https://wiki.facepunch.com/gmod/Global.LocalPlayer) should be drawn.
+     *
+     * If you're using this hook to draw a player for a [GM:CalcView](https://wiki.facepunch.com/gmod/GM:CalcView) hook, then you may want to consider using the `drawviewer` variable you can use in your [Structures/CamData](https://wiki.facepunch.com/gmod/Structures/CamData) table instead.
+     *
+     * **NOTE**: This hook has an internal cache that is reset at the start of every frame. This will prevent this hook from running in certain cases. This cache is reset in [cam.Start](https://wiki.facepunch.com/gmod/cam.Start) and in a future update in [render.RenderView](https://wiki.facepunch.com/gmod/render.RenderView) when rendering extra views.
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:ShouldDrawLocalPlayer
+     */
+    Add(eventName: "ShouldDrawLocalPlayer", identifier: any, func: (ply: Player) => boolean): void;
+    /**
+     * Called when a player executes `gm_showhelp` console command. (Default bind is F1)
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShowHelp
+     */
+    Add(eventName: "ShowHelp", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a player executes `gm_showspare1` console command ( Default bind is F3 ).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShowSpare1
+     */
+    Add(eventName: "ShowSpare1", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a player executes `gm_showspare2` console command ( Default bind is F4 ).
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShowSpare2
+     */
+    Add(eventName: "ShowSpare2", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * Called when a player executes `gm_showteam` console command. ( Default bind is F2 )
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShowTeam
+     */
+    Add(eventName: "ShowTeam", identifier: any, func: (ply: Player) => void): void;
+    /**
+     * 		Called whenever the Lua environment is about to be shut down, for example on map change, or when the server is going to shut down.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:ShutDown
+     */
+    Add(eventName: "ShutDown", identifier: any, func: () => void): void;
+    /**
+     * Called when spawn icon is generated.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:SpawniconGenerated
+     */
+    Add(eventName: "SpawniconGenerated", identifier: any, func: (lastmodel: string, imagename: string, modelsleft: number) => void): void;
+    /**
+     * Called when the Spawnmenu is Created.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:SpawnMenuCreated
+     */
+    Add(eventName: "SpawnMenuCreated", identifier: any, func: () => void): void;
+    /**
+     * Runs when the user tries to open the chat box.
+     *
+     * **WARNING**: Returning `true` won't stop the chatbox from taking VGUI focus. [chat.Close](https://wiki.facepunch.com/gmod/chat.Close) may be of use to mitigate that, or usage of [GM:PlayerBindPress](https://wiki.facepunch.com/gmod/GM:PlayerBindPress).
+     *
+     *
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:StartChat
+     */
+    Add(eventName: "StartChat", identifier: any, func: (isTeamChat: boolean) => boolean): void;
+    /**
+     * Allows you to change the players inputs before they are processed by the server. This function is also called for bots, making it the best solution to control them.
+     *
+     * This is basically a shared version of [GM:CreateMove](https://wiki.facepunch.com/gmod/GM:CreateMove).
+     *
+     *
+     * **NOTE**: This hook is predicted, but not by usual means, it is called when a [CUserCmd](https://wiki.facepunch.com/gmod/CUserCmd) is generated on the client, and on the server when it is received, so it is necessary for this hook to be called clientside even on singleplayer
+     *
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:StartCommand
+     */
+    Add(eventName: "StartCommand", identifier: any, func: (ply: Player, ucmd: CUserCmd) => void): void;
+    /**
+     * Called right before an entity starts driving. Overriding this hook will cause it to not call [drive.Start](https://wiki.facepunch.com/gmod/drive.Start) and the player will not begin driving the entity.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:StartEntityDriving
+     */
+    Add(eventName: "StartEntityDriving", identifier: any, func: (ent: Entity, ply: Player) => void): void;
+    /**
+     * Called when you start a new game via the menu.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:StartGame
+     */
+    Add(eventName: "StartGame", identifier: any, func: () => void): void;
+    /**
+     * Called every rendered frame on client, except when the game is paused.
+     *
+     * Called every game tick on the server. This will be the same as [GM:Tick](https://wiki.facepunch.com/gmod/GM:Tick) on the server when there is no lag, but will only be called once every processed server frame during lag.
+     * [Global.CurTime](https://wiki.facepunch.com/gmod/Global.CurTime) is guaranteed to be different with each call to this hook on the server.
+     *
+     * See [GM:Tick](https://wiki.facepunch.com/gmod/GM:Tick) for a hook that runs every tick on both the client and server.
+     *
+     * **NOTE**: On server, this hook **WILL NOT** run if the server is empty, unless you set the [ConVar](https://wiki.facepunch.com/gmod/ConVar) `sv_hibernate_think` to `1`.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/GM:Think
+     */
+    Add(eventName: "Think", identifier: any, func: () => void): void;
+    /**
+     * Called every game tick. [engine.TickCount](https://wiki.facepunch.com/gmod/engine.TickCount) is guaranteed to be different between each call.
+     *
+     * Server side, this is similar to [GM:Think](https://wiki.facepunch.com/gmod/GM:Think) (See that page for details).
+     *
+     * The default tickrate is `66.6666` (15 millisecond intervals). It can be changed via the `-tickrate` [command line option](https://wiki.facepunch.com/gmod/Command_Line_Parameters).
+     * See [engine.TickInterval](https://wiki.facepunch.com/gmod/engine.TickInterval) for a function to retrieve this data at runtime.
+     *
+     * **NOTE**: This hook **WILL NOT** run if the server is empty, unless you set the [ConVar](https://wiki.facepunch.com/gmod/ConVar) `sv_hibernate_think` to 1
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:Tick
+     */
+    Add(eventName: "Tick", identifier: any, func: () => void): void;
+    /**
+     * 		**NOTE**: Isn't called when CalcMainActivity returns a valid override sequence id
+     *
+     * 		Allows you to translate player activities.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:TranslateActivity
+     */
+    Add(eventName: "TranslateActivity", identifier: any, func: (ply: Player, act: number) => number): void;
+    /**
+     * Animation updates (pose params etc) should be done here.
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:UpdateAnimation
+     */
+    Add(eventName: "UpdateAnimation", identifier: any, func: (ply: Player, velocity: Vector, maxSeqGroundSpeed: number) => void): void;
+    /**
+     * 		Called when a variable is edited on an Entity (called by Edit Properties... menu). See [Editable Entities](https://wiki.facepunch.com/gmod/Editable_Entities) for more information.
+     *
+     * 		**WARNING**: This hook is called to change a variable and not after a variable was changed
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:VariableEdited
+     */
+    Add(eventName: "VariableEdited", identifier: any, func: (ent: Entity, ply: Player, key: string, val: string, editor: table) => void): void;
+    /**
+     * Called when you are driving a vehicle. This hook works just like [GM:Move](https://wiki.facepunch.com/gmod/GM:Move).
+     *
+     * This hook is called before [GM:Move](https://wiki.facepunch.com/gmod/GM:Move) and will be called when [GM:PlayerTick](https://wiki.facepunch.com/gmod/GM:PlayerTick) is not.
+     *
+     * @realm shared
+     * @source https://wiki.facepunch.com/gmod/GM:VehicleMove
+     */
+    Add(eventName: "VehicleMove", identifier: any, func: (ply: Player, veh: Vehicle, mv: CMoveData) => void): void;
+    /**
+     * Called when user clicks on a VGUI panel.
+     * @realm client
+     * @source https://wiki.facepunch.com/gmod/GM:VGUIMousePressAllowed
+     */
+    Add(eventName: "VGUIMousePressAllowed", identifier: any, func: (button: number) => boolean): void;
+    /**
+     * Called when a mouse button is pressed on a VGUI element or menu.
+     * @realm client and menu
+     * @source https://wiki.facepunch.com/gmod/GM:VGUIMousePressed
+     */
+    Add(eventName: "VGUIMousePressed", identifier: any, func: (pnl: Panel, mouseCode: number) => void): void;
+    /**
+     * Called as a weapon entity is picked up by a player. (Including [Player:Give](https://wiki.facepunch.com/gmod/Player:Give))
+     *
+     * Contrary to the name of the hook, it is **not called** when the player switches their active weapon to another.
+     *
+     * See also [GM:PlayerDroppedWeapon](https://wiki.facepunch.com/gmod/GM:PlayerDroppedWeapon) and [GM:PlayerCanPickupWeapon](https://wiki.facepunch.com/gmod/GM:PlayerCanPickupWeapon).
+     *
+     * **NOTE**: At the time when this hook is called [Entity:GetOwner](https://wiki.facepunch.com/gmod/Entity:GetOwner) will return `NULL`. The owner is set on the next frame.
+     *
+     * **NOTE**: This will not be called when picking up a weapon you already have as the weapon will be removed and [WEAPON:EquipAmmo](https://wiki.facepunch.com/gmod/WEAPON:EquipAmmo) will be called instead.
+     *
+     *
+     * @realm server
+     * @source https://wiki.facepunch.com/gmod/GM:WeaponEquip
+     */
+    Add(eventName: "WeaponEquip", identifier: any, func: (weapon: Weapon, owner: Player) => void): void;
+    /**
+     * Called when an addon from the Steam workshop finishes downloading. Used by default to update details on the workshop downloading panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopDownloadedFile
+     */
+    Add(eventName: "WorkshopDownloadedFile", identifier: any, func: (id: number, title: string) => void): void;
+    /**
+     * Called when an addon from the Steam workshop begins downloading. Used by default to place details on the workshop downloading panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopDownloadFile
+     */
+    Add(eventName: "WorkshopDownloadFile", identifier: any, func: (id: number, imageID: number, title: string, size: number) => void): void;
+    /**
+     * Called while an addon from the Steam workshop is downloading. Used by default to update details on the fancy workshop download panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopDownloadProgress
+     */
+    Add(eventName: "WorkshopDownloadProgress", identifier: any, func: (id: number, imageID: number, title: string, downloaded: number, expected: number) => void): void;
+    /**
+     * Called after [GM:WorkshopStart](https://wiki.facepunch.com/gmod/GM:WorkshopStart).
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopDownloadTotals
+     */
+    Add(eventName: "WorkshopDownloadTotals", identifier: any, func: (remain: number, total: number) => void): void;
+    /**
+     * Called when downloading content from Steam workshop ends. Used by default to hide fancy workshop downloading panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopEnd
+     */
+    Add(eventName: "WorkshopEnd", identifier: any, func: () => void): void;
+    /**
+     * Called while an addon from the Steam workshop is extracting. Used by default to update details on the fancy workshop download panel.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopExtractProgress
+     */
+    Add(eventName: "WorkshopExtractProgress", identifier: any, func: (id: number, ImageID: number, title: string, percent: number) => void): void;
+    /**
+     * Called when downloading content from Steam workshop begins. Used by default to show fancy workshop downloading panel.
+     *
+     * The order of Workshop hooks is this:
+     * * WorkshopStart
+     * * WorkshopDownloadTotals
+     * * * These are called for each new item:
+     * * WorkshopDownloadFile
+     * * WorkshopDownloadProgress - This is called until the file is finished
+     * * WorkshopDownloadedFile
+     * * WorkshopEnd (this ones called once)
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopStart
+     */
+    Add(eventName: "WorkshopStart", identifier: any, func: () => void): void;
+    /**
+     * Called when UGC subscription status changes.
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopSubscriptionsChanged
+     */
+    Add(eventName: "WorkshopSubscriptionsChanged", identifier: any, func: () => void): void;
+    /**
+     * 		Called when a Workshop Message is received?. Currently, it seems like the message will be **#ugc.mounting** every time.
+     * 		When does this exactly get called?. If an addon is subscribed, unsubscribed, error occurs or on any event?
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopSubscriptionsMessage
+     */
+    Add(eventName: "WorkshopSubscriptionsMessage", identifier: any, func: (message: string) => void): void;
+    /**
+     * **INTERNAL**: This is used internally - although you're able to use it you probably shouldn't.
+     *
+     * Called by the engine when the game initially fetches subscriptions to be displayed on the bottom of the main menu screen.
+     *
+     * @realm menu
+     * @source https://wiki.facepunch.com/gmod/GM:WorkshopSubscriptionsProgress
+     */
+    Add(eventName: "WorkshopSubscriptionsProgress", identifier: any, func: (num: number, max: number) => void): void;
+    /** Any other hook, including gamemode-defined ones. */
+    Add(eventName: string, identifier: any, func: function): void;
+}