[IllidanS4]

YSF 2.2.1
Latest version • Sources

This is my fork of kurta999's YSF version bringing multitudes of useful functions to Pawn. My intention is to update the plugin for new SA-MP versions and add more features.

Update: As kurta is now back in action and the functions from this fork were merged into his code, this is now obsolete. Thanks for all your support! kurta999's thread

Changelog
0.3.7-R2

2.2.1
• Fixed crash on incoming RCON connections.

2.2
• Added ResetPlayerMarkerForPlayer (by ziggi).
• Fixed memory leak for OnServerQueryInfo.
• Added GetNPCCommandLine for requesting the parameters NPC was created with. Needs to be enabled first with YSF_ToggleNPCTracking. Don't call right in OnPlayerConnect.

Example return from GetNPCCommandLine:

Code:

"path_to\samp-npc.exe" -h 127.0.0.1 -p 7777 -n npc_name -m npc_script

2.1.1
• Removed GetVehicleAngularVelocity (it didn't work).
• Correct Float tags for OnPlayerClientGameInit's parameters globalchatradius and nametagdistance in Pawn.

2.1
• Fixed IsBanned for Linux via a memory edit, may not work for bans with a timeout.
• Added callback OnOutcomeScmEvent to control synchronization of vehicle components (useful for desyncing car mods for people with modified models). SendClientCheck
• Added callback OnServerQueryInfo allowing to customize query texts returned by the server, like hostname, gamemode, and language, for a specific IP address.

Example for OnServerQueryInfo:

Code:

public OnServerQueryInfo(addr[], hostname[51], gameMode[31], language[31])
{
    if(IsBanned(addr))
    {
        hostname = "You are banned from this server.";
        return 1; //Copy the arguments back and do not proceed to other scripts.
    }
    return -1; //Ignore the arguments; return 0 would copy them back and proceed to other scripts.
}

Example for OnOutcomeScmEvent:

Code:

public OnOutcomeScmEvent(playerid, issuerid, E_SCM_EVENT_TYPE:eventid, vehicleid, arg1, arg2)
{
    if(eventid == SCM_EVENT_MOD && GetPVarInt(playerid, "nocarmods")) //change the PVar to disable vehicle mods
    {
        switch(arg1) //the component id
        {
            case 1008,1009,1010,1087: return true; //nitro and hydraulics, safe to mod
            default: return false; //block all other car mods
        }
    }
    return true;
}

2.0 (R18)
Incoming RCON connections erase the banlist due to bugged IsBanned function on Linux.
• Return value of GetVehiclePaintjob matches the parameter of ChangeVehiclePaintjob. Update your code to reflect it!
• Fixed an assertion crash related to RakNet vector values out of bounds.
• Added a couple of vehicle functions, mainly ToggleVehicleSirenEnabled and IsVehicleSirenEnabled. It reflects the "addsiren" parameter of CreateVehicle. You have to re-sync the vehicle if you change its siren state like for SetVehicleNumberPlate, or respawn with SetVehicleToRespawn. Other functions include GetVehicleAngularVelocity, which probably returns radians, GetVehicleMatrix returning the internal vehicle rotation matrix, which can also be converted to a quaternion returned by GetVehicleRotationQuat. The last three parameters are observed to be 0 if an unoccupied vehicle is updated (invalidating the quaternion). SetVehicleMatrix doesn't seem to work at all, but maybe you'll find some use.
• Added new natives:

Code:

native GetSyncBounds(&Float:hmin, &Float:hmax, &Float:vmin, &Float:vmax);
native SetSyncBounds(Float:hmin, Float:hmax, Float:vmin, Float:vmax);

They address this issue. These functions control the bounds where the player position and shots are synced with other players. You can quite easily set them to infinity:

Code:

#define FLOAT_INFINITY (Float:0x7F800000)
SetSyncBounds(-FLOAT_INFINITY, FLOAT_INFINITY, -FLOAT_INFINITY, FLOAT_INFINITY);

Default bounds are "-20000, 20000, -1000, 200000". The first two parameters control the bounds for X and Y coordinates, while the second two for the Z coordinate, i.e. height.
• RCON connections are allowed again.
• GetObjectAttachedData and GetObjectAttachedOffset return correct values if attached on a player.

R17 – latest version by kurta
• Added OnPlayerClientGameInit*
• Added compatibility with SKY, now both plugin can be loaded without crash
• Added GetActorAnimation
• Added (Set/Get)RecordingDirectory
• Added GetVehicleModelCount, GetVehicleModelsUsed
• Added YSF_SetExtendedNetStatsEnabled, YSF_IsExtendedNetStatsEnabled (by default disabled)
• Added YSF_(Set/Get)AFKAccuracy to adjust AFK accuracy, in ms - default 1500
• TogglePlayerOnPlayerList renamed to TogglePlayerInServerQuery
• Fixed GangZoneShowForAll would call OnPlayerLeaveGangZone
• Fixed crash with AttachObjectToPlayer
• Fixed crash with AttachPlayerObjectToPlayer
• Fixed GetObjectAttachedData -> 'attachedplayerid'
• Other minor bugfixes & improvements

* This callback will be called immendiately after player connects to a server. You can change the inital settings here for the player, like cjwalk, onfoot_rate, etc.

Download: GitHub

Examples
The most useful functions:
SetPlayerGravity – change the gravity only for one player.

Code:

SetPlayerGravity(playerid, 0.001);

TextDrawSetPos – you can change an existing textdraw position only with ONE line. After you change the TD pos, you need to re-show it for every player.

Code:

TextDrawSetPos(myTextdraw, 320.0, 240.0);
TextDrawShowForAll(myTextdraw);

GetVehicleRespawnTick – get time since vehicle spawned and occupied, in milliseconds.

Code:

new respawn = GetTickCount() - GetVehicleRespawnTick(vehicleid);
new occupied = GetTickCount() - GetVehicleOccupiedTick(vehicleid);

Installation
1) Download the latest release, extract every file from .zip to your server directory. If you are downloading separate files, download the .dll or .so file to the "plugins" directory, and YSF.inc to "pawno\includes".

2) Add YSF to your server.cfg:

For Windows, "plugins YSF.dll";
For Linux, "plugins YSF.so".

3) Add YSF.inc to your mode and recompile, for beginers:
Put this into top of your mode:

Code:

#include <YSF>

4) Start server!

Natives and callbacks
See the latest include or the original post. Some functions are also documented on the GitHub wiki.

Compiling
In case you wanted to compile this project yourselves, you'll need Visual Studio 2010 or better on Windows. On Linux, it should be as easy as running "make" in the project directory.

Credits
kurta999 for maintaining this plugin for a long time and writing a tutorial on updating memory hacking plugins without which I would not be able to update this,
******,
OrMisicL,
0x688,
Riddick94,
Whitetiger,
iFarbod,
P3ti,
Mellnik,
Zeex,
Incognito,
balika011,
Gamer_Z