pawn-plus-hooks's Introduction

pawn-plus-hooks

Installation

Simply install to your project:

sampctl package install AGraber/pawn-plus-commands

Include in your code and begin using the library:

#include <PawnPlusCMD>

Usage

If you're familiar with y_hooks then the syntax will be familiar:

#include <pp-hooks>
hook OnPlayerEnterDynArea(playerid, areaid)
{
    new string[145];
    format(string, sizeof string, "You entered area id %d", areaid);
    SendClientMessage(playerid, -1, string);
}


#include <pp-hooks>
hook OnPlayerEnterDynArea(playerid, areaid)
{
    printf("playerid %d entered areaid %d", playerid, areaid);
}

hook native SetPlayerPos(playerid, Float:x, Float:y, Float:z)
{
    // Not recursive: calls next hook or the native
    return SetPlayerPos(playerid, x, y, z + 1.0);
}

hook ret OnPlayerUpdate(&ret, playerid)
{
    if(IsPlayerCheating(playerid))
    {
        // set return to 0 to desync
        ret = 0;
        // return non-zero to use that ret value
        return 1;
    }
}

You can change the default hook method (used by the hook and hook public macros) by defining PP_DEFAULT_PUBLIC_HOOK_METHOD to the desired method.

If the hook returns a non-zero value, the following hooks and the base callback won't be executed and that value (or the one at ret if it's a ret hook) will be returned.

Thanks

Y_Less: YSI macros used for reference
IllidanS4: PawnPlus

pawn-plus-hooks's People

Contributors

Stargazers

Watchers

pawn-plus-hooks's Issues

y_unique issue

i've included pp-hooks before hook in all modules.

Hook Get natives

For example, I need to hook GetPlayerPos native to replace the return value (not quite return, but I think you got the point).
How can I do this?

I've already tried

#include <pp-hooks>
hook native GetPlayerPos(playerid, &Float:x, &Float:y, &Float:z) {
    if(admin[playerid][admin_invisible]) {
        x = admin[playerid][admin_real_pos][0];
        y = admin[playerid][admin_real_pos][1];
        z = admin[playerid][admin_real_pos][2];
        return true;
    }
    return GetPlayerPos(playerid, x, y, z);
}

But it brokes SpawnPlayer like there -> IS4Code/PawnPlus#39

Recommend Projects