🍎Sourcepawn脚本入门(二)命令与事件监听

（控制台）命令是常用的插件形式，eg. noclip ...等都是常用的命令，在游戏中使用也很容易,souremod可以注册自己的命令。

事件的监听则需要考虑到不同的起源游戏支持的事件不同，具体可以参考如下：Game Events (Source) - AlliedModders Wiki (alliedmods.net)

1.注册控制台命令

使用RegConsoleCmd注册控制台命令

#include <sdkhooks>
#include <sdktools>
#include <sourcemod>
#pragma newdecls required
#pragma semicolon 1
​
​
public Plugin myinfo =
{
    name = "pluginOne",
    author = "",
    description = "",
    version = "1.0.0",
    url = "https://github.com//pluginOne"
};
​
​
public void OnPluginStart()
{
    PrintToChatAll("这是第一个测试");
    
    //注册控制台命令
    RegConsoleCmd("sm_sayhellow",SayHellowToAll,"这是一个测试测试的控制台命令");
​
}
​
//命令第二个参数为CallBack函数，参数固定为两个int变量（名字随便起）
//但分别代表客服端id和该命令参数的个数
public Action SayHellowToAll(int client,int args)
{
    //向所有人发送信息
    PrintToChatAll("WDNMD");
    
    //Plugin_Handled是Action的返回值，代表执行的结果
    //如果执行成功则为Plugin_Handled,失败则可以为Plugin_Error等
    //当然也可以不返回，但不利于调试
    return Plugin_Handled;
}
​

编译部署到服务器的执行结果：

获取参数信息和客户端信息

#include <sdkhooks>
#include <sdktools>
#include <sourcemod>
#pragma newdecls required
#pragma semicolon 1
​
​
public Plugin myinfo =
{
    name = "pluginOne",
    author = "",
    description = "",
    version = "1.0.0",
    url = "https://github.com//pluginOne"
};
​
​
public void OnPluginStart()
{
    PrintToChatAll("这是第一个测试");
    
    //注册控制台命令
    RegConsoleCmd("sm_sayhellow",SayHellowToAll,"这是一个测试测试的控制台命令");
    RegConsoleCmd("sm_everyone",SaySthSeveralTimes,"这是一个测试测试的控制台命令");
​
}
​
public Action SayHellowToAll(int client,int args)
{
    //向所有人发送信息
    PrintToChatAll("WDNMD");
    
    return Plugin_Handled;
}
​
public Action SaySthSeveralTimes(int client,int args){
​
    char clientname[36],args1[64],args2[10];
    
    //根据需要，限制参数的个数
    if(args!=2){
        PrintToChat(client,"此命令需要两个参数，1为内容，2为要重复的次数");
        return Plugin_Handled;
    }
    
    //利用参数和client的API获取信息
    GetClientName(client,clientname,sizeof(clientname));
​
    GetCmdArg(1,args1,sizeof(args1));
​
    GetCmdArg(2,args2,sizeof(args2));
​
    int times = StringToInt(args2);
​
    if(times<1||times>=10){
​
        PrintToChat(client,"次数必须在10以内！");
        return Plugin_Handled;
​
    }
    
    //循环输出
    for(int i =0;i<times;i++){
        PrintToChatAll("| %s | say %s To EveryOne",clientname,args1);
    }
​
    return Plugin_Handled;
}

2.监听游戏事件

游戏事件在具体游戏上会有一些差别，所以在此处请参考文档

Game Events (Source) - AlliedModders Wiki (alliedmods.net)

此处以Player_death为例：

列表中提供的参数里事件中可以获取到的参数。

#include <sdkhooks>
#include <sdktools>
#include <sourcemod>
#pragma newdecls required
#pragma semicolon 1
​
​
public Plugin myinfo =
{
    name = "pluginOne",
    author = "",
    description = "",
    version = "1.0.0",
    url = "https://github.com//pluginOne"
};
​
​
public void OnPluginStart()
{
    PrintToChatAll("这是第一个测试");
    //绑定事件和它的触发函数
    HookEvent("player_death",OnPlayerDeathFunction);
}
​
//事件触发函数，同上参数类型固定，变量名不固定
public void OnPlayerDeathFunction(Event event, const char[] name, bool dontBroadcast){
    //找到文档中可以参照的属性
    //short userid  user ID who died
    //short attacker    user ID who killed
    //string    weapon  weapon name killer used
    //bool  headshot    singals a headshot
    
    //获取被打人的userid
    int userid = event.GetInt("userid");
    //获取攻击者的id
    int attacker = event.GetInt("attacker");
    //获取是否爆头
    bool isHeadshot = event.GetBool("headshot");
​
    //通过事件ID获取ClientID
    int clientid = GetClientOfUserId(userid);
​
    int attackerid = GetClientOfUserId(attacker);
​
    char victim_name[36],attacker_name[36];
​
    GetClientName(clientid,victim_name,sizeof(victim_name));
​
    GetClientName(attackerid,attacker_name,sizeof(attacker_name));
    //广播通知信息
    if(isHeadshot){
        PrintToChatAll(" | %s | kill | %s |  in headshot ",attacker_name,victim_name);
    }else{
        PrintToChatAll(" | %s | kill | %s |  ",attacker_name,victim_name);
    }
​
​
}
​