Writing Multi-Game SourceMod Plugins - Revision history

Joinedsenses: Update highlighting

2020-03-30T01:29:07Z

Update highlighting

Nosoop: Added page to SourceMod Scripting category

2015-11-26T03:40:08Z

Added page to SourceMod Scripting category

Nosoop: Converted code references to 1.7 version

2015-11-25T15:25:18Z

Converted code references to 1.7 version

Psychonic: /* Detecting Fake Deaths */

2015-11-22T13:25:23Z

‎Detecting Fake Deaths

Powerlord: full_reset, not full round

2014-07-01T15:20:29Z

full_reset, not full round

Powerlord: Fixed link

2014-04-25T17:13:42Z

Fixed link

Powerlord: Moved Detecting Headshots out to its own section, since it contains more than just player_death

2014-03-21T21:29:07Z

Moved Detecting Headshots out to its own section, since it contains more than just player_death

Powerlord: /* Detecting Headshots */

2014-03-21T21:25:32Z

‎Detecting Headshots

Powerlord: Kinda need the define and include of sdkhooks

2014-03-21T21:23:48Z

Kinda need the define and include of sdkhooks

Powerlord: /* SDKHooks TraceAttack and OnTakeDamage */

2014-03-21T21:22:16Z

‎SDKHooks TraceAttack and OnTakeDamage

@@ Line 7: / Line 7: @@
 To detect the current game, use the GetEngineVersion() function, like this:
-<pawn>
+<sourcepawn>
 EngineVersion g_EngineVersion;
@@ Line 14: / Line 14: @@
      g_EngineVersion = GetEngineVersion();
+}
-</pawn>
+</sourcepawn>
 This isn't always necessary for games that use different events, but it's still a good idea.
@@ Line 122: / Line 122: @@
 Team Fortress 2 introduced the concept of fake deaths.  In order to detect if a death was fake, you need to do something like this:
-<pawn>
+<sourcepawn>
 #include <tf2_stocks>
@@ Line 135: / Line 135: @@
      // do other stuff
+}
-</pawn>
+</sourcepawn>
 == Detecting Headshots ==
@@ Line 146: / Line 146: @@
 Headshots can be detected in player_death similarly to this:
-<pawn>
+<sourcepawn>
 #include <tf2_stocks>
@@ Line 172: / Line 172: @@
+     }
+}
-</pawn>
+</sourcepawn>
 Unfortunately, some games don't appear to track headshots for death (Half-Life 2: DeathMatch for example).
@@ Line 179: / Line 179: @@
 player_hurt is a bit trickier.
-<pawn>
+<sourcepawn>
 #include <tf2_stocks>
@@ Line 207: / Line 207: @@
+     }
+}
-</pawn>
+</sourcepawn>
 As you can see, more games support detecting if a shot was a headshot in player_hurt than player_death.
@@ Line 217: / Line 217: @@
 Note: Changing damage and returning Plugin_Changed for either event will change the damage the player takes.
-<pawn>
+<sourcepawn>
 #include <sdkhooks>
@@ Line 263: / Line 263: @@
      return Plugin_Continue;
+}
-</pawn>
+</sourcepawn>
 [[Category:SourceMod Scripting]]

← Older revision		Revision as of 03:40, 26 November 2015
Line 264:		Line 264:
	}		}
	</pawn>		</pawn>
		+
		+	[[Category:SourceMod Scripting]]

@@ Line 7: / Line 7: @@
 To detect the current game, use the GetEngineVersion() function, like this:
-<pawn>new EngineVersion:g_EngineVersion;
+<pawn>
-// In OnPluginStart
+public void OnPluginStart()
      g_EngineVersion = GetEngineVersion();
 </pawn>
@@ Line 120: / Line 123: @@
 <pawn>
 #include <tf2_stocks>
-// in player_death hook
+// Hook the "player_death" event during OnPluginStart and pass in the following callback:
-   new bool:bFake = g_EngineVersion == Engine_TF2 && (GetEventInt(event, "death_flags") & TF_DEATHFLAG_DEADRINGER);
+public Action Event_PlayerDeath(Event event, const char[] name, bool dontBroadcast)
-   // if bFake is true, the it was a fake death
 </pawn>
@@ Line 138: / Line 147: @@
 <pawn>
 #include <tf2_stocks>
-// in player_death hook
+// Hook the "player_death" event during OnPluginStart and pass in the following callback:
-     new bool:bHeadshot;
+public Action Event_PlayerDeath(Event event, const char[] name, bool dontBroadcast)
      switch (g_EngineVersion)
+     {
-         case Engine_CSS, Engine_CSGO, Engine_L4D, Engine_L4D2:
+         case Engine_CSS, Engine_CSGO, Engine_Left4Dead, Engine_Left4Dead2:
+         {
-             bHeadshot = GetEventBool(event, "headshot");
+             bHeadshot = event.GetBool("headshot");
+         }
          case Engine_TF2:
+         {
-             bHeadshot = GetEventInt(event, "customkill") == TF_CUSTOM_HEADSHOT;
+             bHeadshot = event.GetInt("customkill") == TF_CUSTOM_HEADSHOT;
+         }
+     }
@@ Line 161: / Line 171: @@
          // This was a headshot, do something
+     }
 </pawn>
@@ Line 169: / Line 180: @@
 <pawn>
 #include <tf2_stocks>
 #define HITGROUP_HEAD 1
-// in player_hurt hook
+// Hook "player_hurt", etc.
-     new bool:bHeadshot;
+public Action Event_PlayerHurt(Event event, const char[] name, bool dontBroadcast)
      switch (g_EngineVersion)
+     {
-         case Engine_CSS, Engine_CSGO, Engine_DODS, Engine_L4D, Engine_L4D2:
+         case Engine_CSS, Engine_CSGO, Engine_DODS, Engine_Left4Dead, Engine_Left4Dead2:
+         {
-             bHeadshot = GetEventInt(event, "hitgroup") == HITGROUP_HEAD;
+             bHeadshot = event.GetInt("hitgroup") == HITGROUP_HEAD;
+         }
          case Engine_TF2:
+         {
-             bHeadshot = GetEventInt(event, "custom") == TF_CUSTOM_HEADSHOT;
+             bHeadshot = event.GetInt("custom") == TF_CUSTOM_HEADSHOT;
+         }
+     }
@@ Line 195: / Line 206: @@
          // This was a headshot, do something
+     }
 </pawn>
@@ Line 206: / Line 218: @@
 <pawn>
 #include <sdkhooks>
 #define HITGROUP_HEAD 1
-public OnClientPutInServer(client)
+public void OnClientPutInServer(int client)
+{
      switch (g_EngineVersion)
+     {
-         case Engine_CSS, Engine_CSGO, Engine_DODS, Engine_L4D, Engine_L4D2:
+         case Engine_CSS, Engine_CSGO, Engine_DODS, Engine_Left4Dead, Engine_Left4Dead2:
+         {
              SDKHook(client, SDKHook_TraceAttack, TraceAttack);
+         }
          case Engine_TF2:
+         {
@@ Line 227: / Line 238: @@
+}
-public Action:TraceAttack(victim, &attacker, &inflictor, &Float:damage, &damagetype, &ammotype, hitbox, hitgroup)
+public Action TraceAttack(int victim, int &attacker, int &inflictor, float &damage,
+{
-     new bool:bHeadshot = hitgroup == HITGROUP_HEAD;
+     bool bHeadshot = hitgroup == HITGROUP_HEAD;
      if (bHeadshot)
@@ Line 239: / Line 251: @@
+}
-public Action:OnTakeDamage(victim, &attacker, &inflictor, &Float:damage, &damagetype, &weapon,
+public Action OnTakeDamage(int victim, int &attacker, int &inflictor, float &damage,
-		Float:damageForce[3], Float:damagePosition[3], damagecustom)
+        int &damagetype, int &weapon, float damageForce[3], float damagePosition[3], int damagecustom)
-−
+{
-     new bool:bHeadshot = damagecustom == TF_CUSTOM_HEADSHOT;
+     bool bHeadshot = damagecustom == TF_CUSTOM_HEADSHOT;
      if (bHeadshot)
@@ Line 250: / Line 262: @@
      return Plugin_Continue;
 }</pawn>

@@ Line 124: / Line 124: @@
 // in player_death hook
-    new bool:bFake = g_EngineVersion == Engine_TF2 && GetEventInt(event, "death_flags") & TF_DEATHFLAG_DEADRINGER;
+    new bool:bFake = g_EngineVersion == Engine_TF2 && (GetEventInt(event, "death_flags") & TF_DEATHFLAG_DEADRINGER);
     // if bFake is true, the it was a fake death
 </pawn>

@@ Line 41: / Line 41: @@
 | No
 | [[Team Fortress 2 Events#teamplay_round_start|teamplay_round_start]]
-| '''full_round''' will be false if this is not the first round of a multi-round map. In Arena mode, the [[Team Fortress 2 Events#arena_round_start|arena_round_start]] event fires when players can start moving.
+| '''full_reset''' will be false if this is not the first round of a multi-round map. In Arena mode, the [[Team Fortress 2 Events#arena_round_start|arena_round_start]] event fires when players can start moving.
 |-
 | Counter-Strike: Global Offensive

@@ Line 128: / Line 128: @@
 </pawn>
-=== Detecting Headshots ===
+== Detecting Headshots ==
 Not all games support headshots, but those that do have them done differently.
-==== player_death ====
+=== player_death ===
 Headshots can be detected in player_death similarly to this:
@@ Line 165: / Line 165: @@
 Unfortunately, some games don't appear to track headshots for death (Half-Life 2: DeathMatch for example).
-==== player_hurt ====
+=== player_hurt ===
 player_hurt is a bit trickier.
@@ Line 199: / Line 199: @@
 As you can see, more games support detecting if a shot was a headshot in player_hurt than player_death.
-==== SDKHooks TraceAttack and OnTakeDamage ====
+=== SDKHooks TraceAttack and OnTakeDamage ===
 Headshots can be detected by TraceAttack or OnTakeDamage depending on the game.

← Older revision		Revision as of 21:23, 21 March 2014
Line 201:		Line 201:

	<pawn>		<pawn>
		+	// At top of file
		+	#include <sdkhooks>
		+	#define HITGROUP_HEAD 1

	public OnClientPutInServer(client)		public OnClientPutInServer(client)

@@ Line 213: / Line 213: @@
          case Engine_TF2:
+         {
-             SDKHook(client, SDKHook_TraceAttack, OnTakeDamage);
+             SDKHook(client, SDKHook_OnTakeDamage, OnTakeDamage);
+         }
+     }