SDKHooks - Revision history

Luki1412: Added more information about how to hook and some hooks and how to use takedamage

2026-03-31T20:08:18Z

Added more information about how to hook and some hooks and how to use takedamage

Luki1412 at 17:24, 7 September 2025

2025-09-07T17:24:19Z

Luki1412 at 15:35, 7 September 2025

2025-09-07T15:35:07Z

Luki1412 at 15:25, 7 September 2025

2025-09-07T15:25:06Z

Luki1412 at 14:10, 7 September 2025

2025-09-07T14:10:41Z

Luki1412 at 13:59, 7 September 2025

2025-09-07T13:59:31Z

Luki1412 at 13:57, 7 September 2025

2025-09-07T13:57:39Z

Luki1412 at 13:33, 7 September 2025

2025-09-07T13:33:04Z

Luki1412 at 13:03, 7 September 2025

2025-09-07T13:03:40Z

Luki1412: Added other hooks

2025-09-07T12:59:01Z

Added other hooks

@@ Line 1: / Line 1: @@
 ==Introduction==
 SDKHooks was previously an external extension to Sourcemod. It was rolled in [https://wiki.alliedmods.net/Sourcemod_1.5.0_API_Changes#SDKHooks Sourcemod 1.5] and it does not need to be manually installed anymore.
-SDKHooks blocks hooking the same hook twice.
+SDKHooks extension provides hooks, functions and natives.
 ==Hooks==
@@ Line 59: / Line 104: @@
 ===SDKHook_OnTakeDamagePost===
 ===SDKHook_OnTakeDamageAlive===
 This hook works in a similar way to SDKHook_OnTakeDamage but it gives the [https://bugs.alliedmods.net/show_bug.cgi?id=6249#c7 actual, calculated damage amount done to the player. The pre-hook will fire after an OnTakeDamage pre-hook, and the post-hook will fire before an OnTakeDamage post-hook. The health is subtracted in between pre and post unless the hook is blocked.] {{pr|149}}
@@ Line 64: / Line 110: @@
 [https://forums.alliedmods.net/showthread.php?p=2309798#post2309798 OnTakeDamageAlive is also only called for players.]
 ===SDKHook_OnTakeDamageAlivePost===
 ===SDKHook_PreThink===
 Called before OnGameFrame(), but only for the hooked entity.
@@ Line 76: / Line 123: @@
 Triggers when the hooked entity is about to spawn. Entity creation and spawn are not the same thing. Some entity properties are not available until the entity spawns.
 ===SDKHook_SpawnPost===
-Triggers when the hooked entity was spawned.
+Triggers after the hooked entity was spawned.
 ===SDKHook_StartTouch===
 Triggers when the hooked entity is about to be touched by another entity. Not all entities can trigger/fire touch events. Adjusting collision groups for the entity can fix that.
@@ Line 100: / Line 147: @@
 When a weapon is dropped in tf2, a new entity is created called tf_dropped_weapon and this new entity is not the same entity as the one that player had equipped nor do they share entity IDs. They share the m_iAccountID property however, which contains the steam ID of the owner of the weapon that dropped it. You cannot prevent weapon drop through this hook in TF2.
 ===SDKHook_WeaponDropPost===
-Triggers when the hooked weapon was dropped.
+Triggers after the hooked weapon was dropped.
 ===SDKHook_WeaponEquip===
 Triggers when the hooked weapon is about to be equipped.
 ===SDKHook_WeaponEquipPost===
-Triggers when the hooked weapon was equipped.
+Triggers after the hooked weapon was equipped.
 ===SDKHook_WeaponSwitch===
 Triggers when the hooked weapon is about to be switched for another one.
 ===SDKHook_WeaponSwitchPost===
-Triggers when the hooked weapon was switched for another one.
+Triggers after the hooked weapon was switched for another one.
 [[Category:SourceMod Scripting]]

@@ Line 1: / Line 1: @@
 ==Introduction==
 SDKHooks was previously an external extension to Sourcemod. It was rolled in [https://wiki.alliedmods.net/Sourcemod_1.5.0_API_Changes#SDKHooks Sourcemod 1.5] and it does not need to be manually installed anymore.
 ==Hooks==
@@ Line 88: / Line 89: @@
 ===SDKHook_UsePost===
 ===SDKHook_VPhysicsUpdate===
-Triggers when the hooked entity is about to move.
+Triggers when the hooked entity is about to update.
 ===SDKHook_VPhysicsUpdatePost===
 ===SDKHook_WeaponCanSwitchTo===

@@ Line 10: / Line 10: @@
 ===SDKHook_EndTouchPost===
 ===SDKHook_FireBulletsPost===
 ===SDKHook_GetMaxHealth===
    (ep2v and later)

@@ Line 63: / Line 63: @@
 ===SDKHook_OnTakeDamageAlivePost===
 ===SDKHook_PreThink===
 ===SDKHook_PreThinkPost===
 ===SDKHook_PostThink===
@@ Line 86: / Line 87: @@
 ===SDKHook_UsePost===
 ===SDKHook_VPhysicsUpdate===
 ===SDKHook_VPhysicsUpdatePost===
 ===SDKHook_WeaponCanSwitchTo===
@@ Line 102: / Line 104: @@
 Triggers when the hooked weapon was equipped.
 ===SDKHook_WeaponSwitch===
-Triggers when the hooked weapon is about to be switched.
+Triggers when the hooked weapon is about to be switched for another one.
 ===SDKHook_WeaponSwitchPost===
-Triggers when the hooked weapon was switched.
+Triggers when the hooked weapon was switched for another one.
 [[Category:SourceMod Scripting]]

@@ Line 96: / Line 96: @@
 When a weapon is dropped in tf2, a new entity is created called tf_dropped_weapon and this new entity is not the same entity as the one that player had equipped nor do they share entity IDs. They share the m_iAccountID property however, which contains the steam ID of the owner of the weapon that dropped it. You cannot prevent weapon drop through this hook in TF2.
 ===SDKHook_WeaponDropPost===
-Triggers when the hooked was dropped.
+Triggers when the hooked weapon was dropped.
 ===SDKHook_WeaponEquip===
 Triggers when the hooked weapon is about to be equipped.
@@ Line 102: / Line 102: @@
 Triggers when the hooked weapon was equipped.
 ===SDKHook_WeaponSwitch===
 ===SDKHook_WeaponSwitchPost===
+Triggers when the hooked weapon was switched.
 [[Category:SourceMod Scripting]]

@@ Line 71: / Line 71: @@
 ===SDKHook_ShouldCollide===
 ===SDKHook_Spawn===
-Entity creation and spawn are not the same thing. Some entity properties are not available until the entity spawns. This hook is before the entity spawns.
+Triggers when the hooked entity is about to spawn. Entity creation and spawn are not the same thing. Some entity properties are not available until the entity spawns.
 ===SDKHook_SpawnPost===
 ===SDKHook_StartTouch===
 ===SDKHook_StartTouchPost===
 ===SDKHook_Think===
@@ Line 90: / Line 92: @@
 ===SDKHook_WeaponCanUsePost===
 ===SDKHook_WeaponDrop===
-Triggered when a weapon is about to be dropped.
+Triggered when the hooked weapon is about to be dropped.
 ====Under TF2====
 When a weapon is dropped in tf2, a new entity is created called tf_dropped_weapon and this new entity is not the same entity as the one that player had equipped nor do they share entity IDs. They share the m_iAccountID property however, which contains the steam ID of the owner of the weapon that dropped it. You cannot prevent weapon drop through this hook in TF2.
 ===SDKHook_WeaponDropPost===
 ===SDKHook_WeaponEquip===
 ===SDKHook_WeaponEquipPost===
 ===SDKHook_WeaponSwitch===
 ===SDKHook_WeaponSwitchPost===
 [[Category:SourceMod Scripting]]

@@ Line 4: / Line 4: @@
 ==Hooks==
 Some information on various hooks below:
-==SDKHook_Blocked==
+===SDKHook_Blocked===
-==SDKHook_BlockedPost==
+===SDKHook_BlockedPost===
-==SDKHook_CanBeAutobalanced==
+===SDKHook_CanBeAutobalanced===
-==SDKHook_EndTouch==
+===SDKHook_EndTouch===
-==SDKHook_EndTouchPost==
+===SDKHook_EndTouchPost===
-==SDKHook_FireBulletsPost==
+===SDKHook_FireBulletsPost===
-==SDKHook_GetMaxHealth==
+===SDKHook_GetMaxHealth===
    (ep2v and later)
-==SDKHook_GroundEntChangedPost==
+===SDKHook_GroundEntChangedPost===
-==SDKHook_OnTakeDamage==
+===SDKHook_OnTakeDamage===
 inflictor (3rd argument) is the entity that inflicts the damage. If a player directly damages another, inflictor should be equal to the attacking player id. An example of an indirect damage would be a grenade.
-==Under CSS==
+====Under CSS====
-===Non-regular cases for SDKHook_OnTakeDamage===
+'''Non-regular cases for SDKHook_OnTakeDamage'''
 In the scenario where a player throw a grenade to another player then quickly disconnect, the attacker (2nd argument) will become the inflictor (3rd argument).
@@ Line 62: / Line 24: @@
 In the scenario where a terrorist plants the bomb, when the bomb explodes, the attacker (2nd argument) will be the same as the inflictor (3rd argument) which will have the Classname "planted_c4".
-===Some damage types===
+'''Some damage types'''
 A normal HEGrenade and the C4 inflict damage of type DMG_BLAST.
@@ Line 80: / Line 42: @@
 sm_burn will trigger two different callback : an entity with the classname "entityflame" will deal once 0 damage of type DMG_BURN and once 1 damage of type (DMG_BURN | DMG_DIRECT) every tick.
-===Regarding SDKHook_OnTakeDamage and SDKHook_OnTakeDamageAlive===
+'''Regarding SDKHook_OnTakeDamage and SDKHook_OnTakeDamageAlive'''
 SDKHook_OnTakeDamage/Post is triggered when hitting a teammate with mp_friendlyfire 0 (except in TF2), but not SDKHook_OnTakeDamageAlive.
-==Under TF2==
+====Under TF2====
 Under TF2, the SDKHook_OnTakeDamage hook isn't 100% accurate, it's damage parameter is the weapon's base damage. the DMG_CRIT flag is for both crits and minicrits. Weapon spread and minicrit/crit damage is calculated after this call (in SDKHook_OnTakeDamageAlive/Post).
-===Some damage types===
+'''Some damage types'''
 Shotgun = DMG_BUCKSHOT | DMG_SLOWBURN
@@ Line 93: / Line 55: @@
 If a crit, |= DMG_CRIT
 [[Category:SourceMod Scripting]]