[插件] kook-connect

[siwode]

KOOK 命令简单教程

这个教程演示如何在服务器里添加一个简单的 KOOK 指令。

一、设置命令前缀

如果希望 KOOK 指令使用 / 开头，需要在 include kook-cmd.inc 之前定义 KCMD_PREFIX：

代码:

#define KCMD_PREFIX '/'
#include "include/kook-connector.inc"
#include "include/kook-cmd.inc"

注意：
kook-cmd.inc 识别的是 KCMD_PREFIX，不是 KOOK_COMMAND_PREFIX。

二、创建一个简单指令

例如创建 /ping 指令：

代码:

KCMD:ping(user, channel, params[])
{
    KCC_SendChannelMessage(channel, "pong");
    return 1;
}

在 KOOK 频道输入：

代码:

/ping

机器人会回复：

代码:

pong

三、创建一个带参数的指令

例如创建 /say 指令：

代码:

KCMD:say(user, channel, params[])
{
    if(isnull(params))
        return KCC_SendChannelMessage(channel, "用法: /say [内容]");

    KCC_SendChannelMessage(channel, params);
    return 1;
}

在 KOOK 频道输入：

代码:

/say 你好

机器人会回复：

代码:

你好

四、获取发送者名字

代码:

KCMD:whoami(user, channel, params[])
{
    new username[KCC_USERNAME_SIZE];
    KCC_GetUserName(user, username, sizeof(username));

    KCC_SendChannelMessage(channel, sprintf("你是: %s", username));
    return 1;
}

在 KOOK 频道输入：

代码:

/whoami

机器人会回复你的 KOOK 用户名。

五、KCMD 参数说明

代码:

KCMD:命令名(user, channel, params[])
{
    return 1;
}

user：
发送 KOOK 指令的用户。

channel：
发送指令的 KOOK 频道。

params：
指令后面的内容。

例如：

代码:

/say hello

其中 /say 是命令，hello 是 params。

六、常用发送消息方法

发送普通文字：

代码:

KCC_SendChannelMessage(channel, "消息内容");

发送变量内容：

代码:

KCC_SendChannelMessage(channel, params);

发送格式化内容：

代码:

KCC_SendChannelMessage(channel, sprintf("你好，%s", username));

七、简单总结

添加 KOOK 指令只需要写：

代码:

KCMD:指令名(user, channel, params[])
{
    // 你的代码
    return 1;
}

例如：

代码:

KCMD:test(user, channel, params[])
{
    KCC_SendChannelMessage(channel, "测试成功");
    return 1;
}

KOOK 输入：

代码:

/test

机器人回复：

代码:

测试成功