Linux/CentOS YSF 0.2 released

[Y_Less]

YSF 0.2 - Linux/CentOS 0.2x support included!

Introduction

You've been asking for it for months, and it's FINALLY done! This new version of YSF, so fundamental I created a whole new topic for it, supports Windows 0.2.2, 0.2.2r2 and 0.2x AND Linux 0.2x. I will not be doing support for older Linux versions so don't even ask, if you can't be bothered to upgrade to the latest version that's your own lookout.

The .so also apparently supports CentOS.

Download

Straight to the point:

HERE

Use

• Windows

Make sure "YSF.dll" is in your "plugins" directory. If you don't have a "plugins" directory make one in your root server directory. Then add:

plugins YSF

To "server.cfg".

• Linux

Make sure "YSF.so" is in your "plugins" directory. If you don't have a "plugins" directory make one in your root server directory. Then add:

plugins YSF.so

To "server.cfg".

• PAWN

To use the YSF functions in your scripts make sure "YSF.inc" is in "pawno/include". Then add:

#include <YSF>

To the script you wish to use the functions in. See "Examples" for further usage information.

Fixes

List of bugs and whether or not they're fixed yet in YSF (or can be fixed). Credits to BeckzyBoi for the original bugs list.


Bug
Status
Notes


a_objects.inc

• SetPlayerObjectRot

F



a_players.inc

• SpawnPlayer

W
What I thought would solve it didn't, need to find something else to try.

• GetPlayerInterior

-

• SetPlayerAmmo

-

• GetPlayerAmmo

-

• SetPlayerTeam

-

• GetPlayerTeam

-

• GetPlayerColor

F

• SetPlayerDisabledWeapons

R
Was removed, although may be simpleish to implement

• RemovePlayerFromVehicle

?
May be doable by faking the data sent to other players to say that player got out, instead of was forced out

• TogglePlayerControllable

-
Doable

• SetPlayerCheckpoint

X

• SetPlayerRaceCheckpoint

X

• SetPlayerWorldBounds

X

• AllowPlayerTeleport

F
Fixed, along with AllowAdminTeleport, was a simple logic mix-up.

• IsPlayerInCheckpoint

F

• IsPlayerInRaceCheckpoint

F

• TogglePlayerSpectating

?
Irritating but more a client problem.

• SPECTATE_MODE_FIXED

?
This should put you in spectate mode in a fixed location. Easily faked with SetPlayerCamera.


a_samp.inc

• AddStaticPickup

-
Should be easy enough to "fix".

• CreatePickup

W
Discussion.

• GetWeaponName

-
Random.

• AllowAdminTeleport

F
See AllowPlayerTeleport.

• SetDeathDropAmount

R

• DisableInteriorEnterExits

X

• CreateMenu

X

• GetPlayerMenu

-

• TextDrawColor/TextDrawBackgroundColor

-
Just hide and reshow them.

• OnPlayerDeath

?

• OnVehicleDeath

N
Future expansion.

• OnPlayerEnterVehicle

?

• OnRconCommand

F



a_vehicles.inc

• SetVehiclePos

?
Doubt it can be solved.

• GetVehicleZAngle

?

• SetVehicleParamsForPlayer

X
I've warned people about this before, it's to do with the map icon limit.

• GetVehicleTrailer

-

• SetVehicleVirtualWorld

-



string.inc

• strcmp

?
strcmp returns the lexographic difference between two strings, the fact that this value can be used to see if two strings are the same is not it's main function. I don't know what the lexographic difference between a string a nothing is, requires looking up to see if this is really a bug or just a function working differently to how people expect. Basically: use dcmd!

• strval

F



Misc

• unloadfs

F

• SQLite

F




Key
FFixed
YYet to be released (fixed in my dev version)
NNot a bug (IMHO)
RRemoved
XCan't be done server side
-Not looked into
?Don't know
WWIP


Once everything is green or red YSF is basically finished.

Features

List of features which aren't bug fixes or new functions.

• Improved plugin architecture.
• Extracted nickname check function, define your own allowed characters.

Functions

List of new PAWN functions.

• SetPlayerGravity(playerid, gravity);

  Set a single player's gravity (beware desyncs).

• AddServerRule(name[], value[]);

  Add server information to the server browser.

• SetServerRule(name[], value[]);

  Modify server information in the server browser.

• SetPlayerSkinForPlayer(skinplayer, forplayer, skin);

  Set the skin a player sees another player with.

• GetPlayerSkinForPlayer(skinplayer, forplayer);

  Get the skin one player sees another player using.

• ffind(const pattern[], filename[], len, &idx);

  Find files matching a pattern.

• frename(const oldname[], const newname[]);

  Rename a file.

• dfind(const pattern[], filename[], len, &idx);

  Fine directories matching a pattern.

• dcreate(const name[]);

  Create a directory.

• drename(const oldname[], const newname[]);

  Rename a directory*.

* This function used to be identical to frename, it's now not, make sure you're using the correct one (they still interchangeable on Windows).

Examples

• SetPlayerSkinForPlayer

new
    gLastKiller[MAX_PLAYERS] = {INVALID_PLAYER_ID, ...};

public OnPlayerDisconnect(playerid, reason)
{
    gLastKiller[playerid] = INVALID_PLAYER_ID;
}

public OnPlayerDeath(playerid, killerid, reason)
{
    // Set your last killer to the clown skin for revenge kills
    if (killerid != INVALID_PLAYER_ID)
    {
        new
            last = gLastKiller[playerid];
        if (last != killerid)
        {
            if (last != INVALID_PLAYER_ID)
            {
                SetPlayerSkinForPlayer(last, playerid, GetPlayerSkin(last));
            }
            gLastKiller[playerid] = killerid;
            SetPlayerSkinForPlayer(killerid, playerid, 264);
        }
    }
}

• ffind

// Find all the vehicle files in Los Santos
main()
{
    new
        i,
        buf[64];
    i = 0;
    // Find all files matching the given wildcard string
    while (ffind("vehiclelists/ls_*.txt", buf, sizeof (buf), i))
    {
        printf("%d) %s", i - 1, buf);
    }
}

• dfind

// List everything in scriptfiles
main()
{
    // Start the search in scriptfiles
    ListDir("", 0);
}

ListDir(dir[], indent)
{
    new
        i,
        buf[128],
        search[128],
        ind[16],
        x = indent;
    // Create a string with the indents in
    ind[x] = '\0';
    while (x)
    {
        ind[--x] = '\t';
    }
    // Generate the search string
    format(search, sizeof (search), "%s/*", dir);
    i = 0;
    // Loop through all matching folders
    while (dfind(search, buf, sizeof (buf), i))
    {
        // Display the current directory
        printf("%s%s", ind, buf);
        // Enumerate child directories
        if (buf[0] != '.')
        {
            // Call this function recursively to check other dirs
            format(buf, sizeof (buf), "%s/%s", dir, buf);
            ListDir(buf, indent + 1);
        }
    }
    // Reset count - VERY important
    i = 0;
    // Loop through all matching files
    while (ffind(search, buf, sizeof (buf), i))
    {
        // List all files
        printf("%s%s", ind, buf);
    }
}

• AddServerRule

AddServerRule("YSF", "Present");

• SetServerRule

SetServerRule("worldtime", "The morning");

Further examples

More code elsewhere taking advantage of YSF's features:

• SetWorldTimeEx

Sets the world time to an hour/minute combination and uses SetServerRule to update the time viewed in the server browser.

Building

• Windows

To build a new Windows version open YPI.sln in Visual Studio and "build" project "YSF".

• Linux

To build a new version in Linux open a terminal on the "YPI" directory and type:

make YSF

[D0erfler]

nice
i love it on linux

[sebihunter]

finally!
Thanks

[boylett]

Linux+YSF = ftw

EDIT: works on CentOS no problems.

[Y_Less]

I forgot to mention YSI isn't ported yet, a lot of the base is the same but there's more work for the other streamer bits (more information on what's going on there later).

[Ytong]

Omg this is like a SA-MP 0.2.7 server-release
thx very much Y_Less
What's your next project? Making GTA IV playable on single core CPU's ? :>

*Tjong arranges a new power order*

• <insert Y_Less here>
• Chuck Norris
• God

[Kowalski]

Yahooooo! This is awesome! Thank you Y_Less!

Ковалски

[MasterOfQuebec]

Thanks you for this plugin.

[brains]

first off thanks a lot for porting this.

the compiler seems to crash because of these two new natives in the include,

native SetPlayerSkinForPlayer(skinplayer, forplayer, skin);
native GetPlayerSkinForPlayer(skinplayer, forplayer);

commenting them out solves the problem.

[boylett]

Originally Posted by brains

first off thanks a lot for porting this.

the compiler seems to crash because of these two new natives in the include,

native SetPlayerSkinForPlayer(skinplayer, forplayer, skin);
native GetPlayerSkinForPlayer(skinplayer, forplayer);

commenting them out solves the problem.

No reason for these to crash, it works for me so must be something in your mode