Linux/CentOS YSF 0.2 released

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:

Code:

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:

Code:

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:

PAWN Code:

#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
F	Fixed
Y	Yet to be released (fixed in my dev version)
N	Not a bug (IMHO)
R	Removed
X	Can't be done server side
-	Not looked into
?	Don't know
W	WIP

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.

PAWN Code:
SetPlayerGravity(playerid, gravity);
Set a single player's gravity (beware desyncs).
PAWN Code:
AddServerRule(name[], value[]);
Add server information to the server browser.
PAWN Code:
SetServerRule(name[], value[]);
Modify server information in the server browser.
PAWN Code:
SetPlayerSkinForPlayer(skinplayer, forplayer, skin);
Set the skin a player sees another player with.
PAWN Code:
GetPlayerSkinForPlayer(skinplayer, forplayer);
Get the skin one player sees another player using.
PAWN Code:
ffind(const pattern[], filename[], len, &idx);
Find files matching a pattern.
PAWN Code:
frename(const oldname[], const newname[]);
Rename a file.
PAWN Code:
dfind(const pattern[], filename[], len, &idx);
Fine directories matching a pattern.
PAWN Code:
dcreate(const name[]);
Create a directory.
PAWN Code:
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

PAWN Code:

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

PAWN Code:

// 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

PAWN Code:

// 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);
}
}