Function Calling API (SourceMod Scripting) - Revision history

Asherkin: Correct void forward event type

2022-01-06T11:45:11Z

Correct void forward event type

Bacardi: /* Private Forwards */ remove const

2021-08-01T21:31:38Z

‎Private Forwards: remove const

Benito: Syntax update

2020-10-02T00:00:23Z

Syntax update

Joinedsenses: Update formatting for readability and consistency

2020-03-30T01:34:50Z

Update formatting for readability and consistency

Show changes

Joinedsenses: Update highlighting

2020-03-29T23:59:57Z

Update highlighting

Show changes

DJ Tsunami at 20:27, 12 January 2020

2020-01-12T20:27:30Z

DJ Tsunami: /* Private Forwards */

2020-01-12T20:13:25Z

‎Private Forwards

DJ Tsunami: /* Global Forwards */

2020-01-12T20:10:48Z

‎Global Forwards

DJ Tsunami: /* Generic Calling */

2020-01-12T20:10:10Z

‎Generic Calling

DJ Tsunami: /* Private Forwards */

2020-01-12T20:05:01Z

‎Private Forwards

@@ Line 95: / Line 95: @@
 public void OnPluginStart()
+{
-     g_DeathForward = new GlobalForward("OnClientDied", ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell);
+     g_DeathForward = new GlobalForward("OnClientDied", ET_Ignore, Param_Cell, Param_Cell, Param_String, Param_Cell);
      HookEvent("player_death", EventHandler);
+}
@@ Line 107: / Line 107: @@
+{
      char weapon[64];
      event.GetString("weapon", weapon, sizeof(weapon));
@@ Line 120: / Line 118: @@
      Call_PushCell(GetEventInt(event, "headshot"));
-     /* Finish the call, get the result */
+     /* Finish the call */
-     Call_Finish(result);
+     Call_Finish();
      return result;
@@ Line 145: / Line 143: @@
 public void OnPluginStart()
+{
-     g_DeathForward = new PrivateForward(ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell);
+     g_DeathForward = new PrivateForward(ET_Ignore, Param_Cell, Param_Cell, Param_String, Param_Cell);
      CreateNative("HookClientDeath", Native_HookClientDeath);

@@ Line 168: / Line 168: @@
 // typedef MyFunction = function void (int client);
 // native void My_NativeEx(MyFunction func);
-public APLRes AskPluginLoad2(Handle plugin, bool late, const char[] error, int err_max)
+public APLRes AskPluginLoad2(Handle plugin, bool late, char[] error, int err_max)
+{
      RegPluginLibrary("MyPlugin");

@@ Line 54: / Line 54: @@
          Call_PushCell(GetClientOfUserId(event.GetInt("userid")));
          Call_PushString(weapon);
-         Call_PushCell(GetEventInt(event, "headshot"));
+         Call_PushCell(event.GetInt("headshot"));
          /* Finish the call, get the result */

@@ Line 18: / Line 18: @@
+{
 	char name[MAX_NAME_LENGTH];
-	GetClientName(victim, name, sizeof(name))
+	GetClientName(victim, name, sizeof(name));
 	if (attacker != victim)
+	{
 		char other[MAX_NAME_LENGTH];
-		GetClientName(attacker, other, sizeof(other))
+		GetClientName(attacker, other, sizeof(other));
-		PrintToServer("<\"%s\"> killed by <\"%s\"> with \"%s\" (headshot: %d)", name, other, weapon, headshot)
+		PrintToServer("<\"%s\"> killed by <\"%s\"> with \"%s\" (headshot: %d)", name, other, weapon, headshot);
 	} else if (!attacker) {
-		PrintToServer("<\"%s\"> killed by \"world\" with \"%s\" (headshot: %d)", name, weapon, headshot)
+		PrintToServer("<\"%s\"> killed by \"world\" with \"%s\" (headshot: %d)", name, weapon, headshot);
 	} else {
-		PrintToServer("<\"%s\"> killed by \"self\" with \"%s\" (headshot: %d)", name, weapon, headshot)
+		PrintToServer("<\"%s\"> killed by \"self\" with \"%s\" (headshot: %d)", name, weapon, headshot);
+	}
 }</pawn>

@@ Line 141: / Line 141: @@
 public void OnPluginStart()
+{
-   g_DeathForward = new PrivateForward(ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell);
+	g_DeathForward = new PrivateForward(ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell);
-   CreateNative("HookClientDeath", Native_HookClientDeath);
+	CreateNative("HookClientDeath", Native_HookClientDeath);
-   HookEvent("player_death", EventHandler);
+	HookEvent("player_death", EventHandler);
+}
 public int Native_HookClientDeath(Handle plugin, int numParams)
+{
-   g_DeathForward.AddFunction(plugin, GetNativeFunction(1));
+	g_DeathForward.AddFunction(plugin, GetNativeFunction(1));
 }</pawn>
@@ Line 164: / Line 164: @@
 public APLRes AskPluginLoad2(Handle plugin, bool late, const char[] error, int err_max)
+{
-   RegPluginLibrary("MyPlugin");
+	RegPluginLibrary("MyPlugin");
-   CreateNative("My_NativeEx", My_Native);
+	CreateNative("My_NativeEx", My_Native);
-   return APLRes_Success;
+	return APLRes_Success;
+}
 public void OnPluginStart()
+{
-   HookEvent("player_death", Event_Death);
+	HookEvent("player_death", Event_Death);
-   g_hDeathFwd = new PrivateForward(ET_Ignore, Param_Cell);
+	g_hDeathFwd = new PrivateForward(ET_Ignore, Param_Cell);
+}
 public int My_Native(Handle plugin, int numParams)
+{
-   g_hDeathFwd.AddFunction(plugin, GetNativeFunction(1));
+	g_hDeathFwd.AddFunction(plugin, GetNativeFunction(1));
+}
 public Action Event_Death(Event event, const char[] name, bool dontBroadcast)
+{
-   int client = GetClientOfUserId(event.GetInt("userid"));
+	int client = GetClientOfUserId(event.GetInt("userid"));
-   Call_StartForward(g_hDeathFwd);
+	Call_StartForward(g_hDeathFwd);
-   Call_PushCell(client);
+	Call_PushCell(client);
-   Call_Finish();
+	Call_Finish();
 }</pawn>
 [[Category:SourceMod Scripting]]

@@ Line 137: / Line 137: @@
 An implementation of this might look like:
-<pawn>public void OnPluginStart()
+<pawn>PrivateForward g_DeathForward;
+{
-    g_DeathForward = CreateForward(ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell)
+    g_DeathForward = new PrivateForward(ET_Event, Param_Cell, Param_Cell, Param_String, Param_Cell);
-    CreateNative("HookClientDeath", Native_HookClientDeath)
+    CreateNative("HookClientDeath", Native_HookClientDeath);
-    HookEvent("player_death", EventHandler)
+    HookEvent("player_death", EventHandler);
+}
 public int Native_HookClientDeath(Handle plugin, int numParams)
+{
-    AddToForward(g_DeathForward, plugin, GetNativeFunction(1))
+    g_DeathForward.AddFunction(plugin, GetNativeFunction(1));
 }</pawn>
@@ Line 155: / Line 157: @@
 native void My_NativeEx(MyFunction func);</pawn>
-<pawn>Handle g_hDeathFwd;
+<pawn>PrivateForward g_hDeathFwd;
@@ Line 171: / Line 173: @@
+{
     HookEvent("player_death", Event_Death);
-    g_hDeathFwd = CreateForward(ET_Ignore, Param_Cell);
+    g_hDeathFwd = new PrivateForward(ET_Ignore, Param_Cell);
+}
 public int My_Native(Handle plugin, int numParams)
+{
-    AddToForward(g_hDeathFwd, plugin, GetNativeFunction(1));
+    g_hDeathFwd.AddFunction(plugin, GetNativeFunction(1));
+}