Matrix Useful Function's [v1.0]

#include <a_samp>

public
    OnFilterScriptInit()                                                        //- executa os testes
{
    return 1;
}
stock
    ClearString(string[])                                                       //- faz com que a string deixe strng limpa
        return format(string,1,"%s",EOS);

stock
    SubChars(source[],ch,char2)                                                 //- Substitui todos caracters contidos em uma strng por outros
{
    for(new i; source[i] ; ++ i)
        if(source[i] == ch)
            source[i] = char2;
}

stock
    FindChar(source[],chars)                                                    //- Procura um caracter em uma strng
{
    for(new i;source[i];i++)
        if(source[i] == chars)
            return true;
    return false;
}

stock
    RandomTwoValues(value1, value2)
        return random(value2-value1)+value1;

stock
    DeleteChar(string[],chars)                                                  //- Deleta todos Caracters de uma String
{
    for(new i = 0; string[i]; ++i)
         if(string[i] == chars)
            string[i] = string[i+1];
    return true;
}

stock
    StringFind(String1[],text[])                                                //- Procura algum texto na string | funcao pronta retorna true
{
    if(String1[0] == EOS || String2[0] == EOS)
        return false;
    if(strfind(String1 ,text, true ) == 0 )
        return true;
    else  return false;
}

stock
    StringCompare(String1[],String2[])                                          //- Compara duas string se são iguais | funcao pronta retorna true
{
    if(String1[0] == EOS || String2[0] == EOS)
        return false;
    if(strcmp(String1 ,String2, true ) == 0 )
        return true;
    else  return false;
}

stock
    GetPlayersInInterior(interiorid)                                            //- Vê quantos players está no interior
{
    new
        PlayersNoInterior
    ;
    for(new i = 0; i< MAX_PLAYERS; i++)
    {
        if(IsPlayerConnected(i)  && GetPlayerInterior(i)  == interiorid)
            PlayersNoInterior++;
    }
    return PlayersNoInterior;
}

stock
    SetHealthRangeOfPlayer(playerid, Float:range, Float:health)                 //- Seta vida de Players próximos ao player
{
    static
        Float:X,
        Float:Y,
        Float:Z
    ;
    GetPlayerPos(playerid,X,Y,Z);
    for(new i=0; i < MAX_PLAYERS; i++) if(IsPlayerConnected(i))
        if(IsPlayerInRangeOfPoint(i, range, X, Y, Z))
            SetPlayerHealth(i,health);
    return true;
}

stock
    TeleportPlayerToPlayer(playerid, gotoid)                                    //- Teleporta player para o player
{
    static
        Float:X,
        Float:Y,
        Float:Z
    ;
    GetPlayerPos(gotoid, X, Y, Z);
    SetPlayerVirtualWorld(playerid, GetPlayerVirtualWorld(gotoid));
    SetPlayerInterior(playerid, GetPlayerInterior(gotoid));
    return SetPlayerPos(playerid, X+1, Y+1, Z);
}

stock
    GiveWeaponRangeOfPlayer(playerid, Float:range, weaponid, ammo)              //- Da armas para players perto do player
{
    static
        Float:X,
        Float:Y,
        Float:Z
    ;
    GetPlayerPos(playerid,X,Y,Z);
    for(new i=0; i < MAX_PLAYERS; i++)
        if(IsPlayerConnected  && IsPlayerInRangeOfPoint(i, range, X, Y, Z))
            GivePlayerWeapon(player, weaponid, ammo);
    return true;
}

stock
    GivePVarInt(playerid, var[], val)                                           //- Aumenta PVars
        return SetPVarInt(playerid,var,GetPVarInt(playerid, var)+val);

stock
    GetRemainder(divider, divide)                                               //- Geta o Resto de uma divisão
        return divider % divide;

stock
    GetPower(n1, n2)                                                            //- Executa potenciação
        return floatround(floatpower(n1,n2));

stock
    GetDivision(divider, divide)                                                //- Divide um Numero
        return divider / divide;

stock
    GetMultiplication(number, product)                                          //- Multiplica 2 Nuemros
        return number * product;

stock
    GetSubtraction(number, slow)                                                //- Substrai numeros
        return number - slow;

stock
    GetAddition(number,add)                                                     //- Adiciona Numneros
        return number + add;

stock
    GetPercent(n1,n2)
        return (n1 / n2) * 100;

stock
    SaveFileInStr(file[],string[],size=sizeof(string))                          //- Armazena arquivo em string
{
    if(!fexist(file))
        return false;
    static
        File:file_add
    ;
    file_add = fopen(file, io_read);
    fread(file_add, string,size);
    fclose(file_add);
    return true;
}

stock
    CrashPlayer(playerid)                                                       //- Crash o Player
{
    SetPlayerHoldingObject(playerid, 0, 0);
    Kick(playerid);
    return true;
}

stock
    VehiclesRespawn()                                                           //- Spawn todos Veiculos
{
    for(new i=0; i < MAX_VEHICLES;i++)
        SetVehicleToRespawn(i);
    return 1;
}

stock
    StringHaveTag(string[])                                                     //- se a string tem tag
        return (StringFind(string,"[") ? (true) : (false);

stock
    StringHaveUnder(string[])                                                   //- se a string tem underline
        return (StringFind(string,"_") ? (true) : (false);

stock
    NPCFollowPlayer(npcid,playerid)                                             //- NOPC perseguir Player
{
    SetPlayerToFacePlayer(playerid,paraid);
    ApplyAnimation(playerid,"Muscular","MuscleRun",1,1,1,0,0,0);
}

stock
    SetPlayerToFacePlayer(playerid, targetid)                                   // Seta a Face de um player no outro ( Tannz0rz )
{

        new
                Float:pX,
                Float:pY,
                Float:pZ,
                Float:X,
                Float:Y,
                Float:Z,
                Float:ang
        ;

        if(!IsPlayerConnected(playerid) || !IsPlayerConnected(targetid)) return 0;

        GetPlayerPos(targetid, X, Y, Z);
        GetPlayerPos(playerid, pX, pY, pZ);

        if( Y > pY ) ang = (-acos((X - pX) / floatsqroot((X - pX)*(X - pX) + (Y - pY)*(Y - pY))) - 90.0);
        else if( Y < pY && X < pX ) ang = (acos((X - pX) / floatsqroot((X - pX)*(X - pX) + (Y - pY)*(Y - pY))) - 450.0);
        else if( Y < pY ) ang = (acos((X - pX) / floatsqroot((X - pX)*(X - pX) + (Y - pY)*(Y - pY))) - 90.0);

        if(X > pX) ang = (floatabs(floatabs(ang) + 180.0));
        else ang = (floatabs(ang) - 180.0);

        SetPlayerFacingAngle(playerid, ang);

        return 0;

}

stock
    CreateFile(filename[])                                                      //- Cria um Arquivo
{
    if (fexist(filename))
        return false;
    static
        File:Temp
    ;
    Temp = fopen(filename,io_write);
    fclose(Temp);
    return true;
}

stock
    FileRename(fileorigem[],filerename[])                                       //- Renomeia Arquivo
{
    new
        string[512];
        File:fileo = fopen(fileorigem, io_read),
        File:filer = fopen(filerename, io_write)
    ;

    while(fread(fileo, string))
        fwrite(filer,string);

    fclose(filer);
    fclose(fileo);
    fremove(fileorigem);
    printf("%s for %s",fileorigem,filerename);
    format(string,sizeof string,"%s",0);
    return 1;
}

stock
    CreateQuadrateFromPos(Float:x,Float:y,Float:distance)                       //- cria quadrado de x,y,z
{
    xmax = x + distance; xmin = x - distance;
    ymax = y + distance; ymin = y - distance;
    return true;
}

stock
    GetPlayersInArea(Float:minx, Float:maxx, Float:miny, Float:maxy)            //- Geta quantos player tem na area
{
    new
        PlayersArea
    ;
    static
        Float:x,
        Float:y,
        Float:z
    ;
    for(new i;i<MAX_PLAYERS;i++) if(IsPlayerConnected(i))
    {
        GetPlayerPos(i, x, y, z);
        if (x > minx && x < maxx && y > miny && y < maxy)
            PlayersArea++;
    }
    return PlayersArea;
}

stock
    GetPlayersInVehicle(vehicleid)                                              //- Geta quantos player tem num veiculos
{
    new PlayersVehicle = 0;
    for(new i = 0; i < MAX_PLAYERS; i++) if(IsPlayerConnected(i))
        if(IsPlayerConnected(i) && IsPlayerInVehicle(i,vehicleid))
            PlayersVehicle++;
    return PlayersVehicle;
}

stock
    SetPlayerMoney(playerid,count)                                              //- Seta o dinheiro do player
        return GivePlayerMoney(playerid,count-GetPlayerMoney(playerid));

stock
    GivePlayerHealth(playerid,count)                                            //- da vida ao player
        return SetPlayerHealth(playerid,count+GetPlayerLife(playerid));


stock
    GivePlayerArmour(playerid,count)                                            //- da colete ao player
        return SetPlayerArmour(playerid,count+GetPlayerArmor(playerid));

stock
    GetPlayerLife(pid)                                                          //- Geta a Life do player
{
    new Float:LifeID;
    return GetPlayerHealth(pid,LifeID);
}
stock
    GetPlayerArmor(pid)                                                         //- Geta colete do player
{
    new Float:ArmorID;
    return GetPlayerHealth(pid,ArmorID);
}
stock
    ClearChatText(playerid)                                                     //- Limpa o Chat
{
    for (new tx = -1 ; a < 100; a++)
        SendClientMessage(playerid,0xFFFFFFFF,"\n");
    return true;
}
stock
    GivePlayerVehicle(playerid, vehicleid)                                      //- Da um veiculo ao player
{
    if(!IsPlayerInAnyVehicle(playerid))
    {
        static
            Float:x,
            Float:y,
            Float:z,
            Float:a
        ;
        GetPlayerPos(playerid, x, y, z);
        GetPlayerFacingAngle(playerid, a);
        PutPlayerInVehicle(playerid,CreateVehicle(vehicleid, x, y, z, a, -1, -1, 50000),0);
    }
}

stock
    GetPlayerNick(playerid)                                                     //- Geta nick em array já
{
    static
        namep[24]
    ;
    GetPlayerName(playerid,namep,24);
    return namep;
}

stock
    GetIDFromName(part[])                                                       //Geta id pelo nome
{
    static
        namep[24]
    ;
    for(new id; id < MAX_PLAYERS; id++)
    {
        GetPlayerName(i,namep,24);
        if(StringFind(namep,namep))
            return id;
    }
    return -1;
}

stock
    GetPlayerRangeIP(playerid)                                                  //- Geta IP Permanente do Player
{
    static
        range[19]
    ;
    GetPlayerIp(playerid,range,19);
    strdel(range,strlen(range)-2,strlen(range));
    format(range,17,"%s**",range);
    return range;
}

stock
    StringLineChars(string[128])                                                //- Divide a string em letras por numeros | Criado por [OwN]Papet
{
    new
        Letter[128][2]
    ;
    for(new l = 0; string[l] ; l++)
    {
        format(Letter[l],2,"%s",string[l]);
        printf("Line: %d | Letter: %s",l,Letter[l]);
    }
}

stock
    TeleportPlayerToVehicle(playerid, vehicleid)                                //- Teleporte player para aveiculo
{
    static
        Float:X,
        Float:Y,
        FloatZ
    ;
    GetVehiclePos(vehicleid, X, Y, Z);
    SetPlayerVirtualWorld(playerid, GetVehicleVirtualWorld(vehicleid));
    return SetPlayerPos(playerid, X+1, Y+1, Z);
}

stock
    GetPlayerRankOne()                                                          //- Geta o melhor player do sevrer | Thankz to Toribio
{
    new
        PlayerScore = 0,
        PlayerHigh = -1
    ;
    for(new i = 0; i < MAX_PLAYERS ;i++) if(GetPlayerScore( i ) > PlayerScore)
    {
        PlayerHigh = i;
        PlayerScore = GetPlayerScore( i );
    }
    return PlayerHigh;
}

stock
    ChangeGameMode(gamemode[])                                                  //- Muda game mode
{
    new
        string[128]
    ;
    format(string, sizeof(string), "changegamemode %s", gamemode);
    return SendRconCommand(string);
}

stock
    RemoveLineFromFile(file[],line[])                                           //- remove linha do arquivo
{
    new
        strfile[256],
        stringline[100],
        File:gangfile = fopen(file, io_read),
        File:tempfile = fopen("tmpfile.tmp", io_write);
    ;
    format(stringline,100,"%s\r\n",line);
    while(fread(gangfile, strfile))
        if(strcmp(strfile,stringline, true) != 0)
           fwrite(tempfile, strfile);
    fclose(gangfile);
    fclose(tempfile);
    fremove(file);
    tempfile = fopen("tmpfile.tmp", io_read);
    gangfile = fopen(file, io_write);
    while(fread(tempfile, strfile))
        fwrite(gangfile, strfile);
    fclose(gangfile);
    fclose(tempfile);
    fremove("tmpfile.tmp");
    return true;
}

stock
    SendClientMessageFormated(pid,msg[],colour,a=0,b=0,c=0,d=0,e=0,f=0,g=0,h=0,i=0,j=0)    //- Envia mensagem formatada com suporte a 10 parametors
{
    new
        stringform[128]
    ;
    format(stringform,strlen(msg), "%s", msg,a,b,c,d,e,f,g,h,i,j);
    return SendClientMessage(pid,colour,stringform);
}

stock
    bool:IsPlayerInAnyInterior(playerid)                                        //- se player ta em qualquer interior
        return GetPlayerInterior(playerid) != 0 ? (true) : (false);

stock
    GetPlayersOnline()                                                          //- Pega todos Players Online no servidor
{
    new PlayersOn;
    for(new i;i < MAX_PLAYERS; i++)
        if(IsPlayerConnected(i))
            PlayersOn++.
     return PlayersOn;
}

stock
    SetVehicleRepaired(vehicleid)                                               //- Repara um veiculo totalmente
{
    SetVehicleHealth(vehicleid,1000);
    RepairVehicle(vehicleid);
    return true;
}

stock
    SetVehiclesToRespawns()                                                     //-Seta veiculos desocupados para respawn
{
    for( new j = 0; j < MAX_VEHICLES; j++)
        for(new i = 0; i < MAX_PLAYERS; i++)
            if(IsPlayerInVehicle(i, j) && GetPlayerState(i) == PLAYER_STATE_DRIVER)
                SetVehicleToRespawn(j);
    return true;
}

stock
    SendMessageToAllAdmins(colour,msg[])                                        //- Envia mensagens para admins online
{
    for(new i = 0; i < MAX_PLAYERS; i++)
        if(IsPlayerAdmin(i))
            SendClientMessage(i,colour,msg);
    return true;
}

stock
    freset(file[])
{                                                                               //- Limpa o um Arquivo
    if(!fexist(file))
        return false;
    fremove(file);
    new
        File:resetvar = fopen(file,io_write)
    ;
    fclose(resetvar);
    return true;
}

stock
    SetPlayerToClassSelection(playerid)                                         //- Seta layer para Selecao de Skins
{
    ForceClassSelection(playerid);
    SetPlayerPos(playerid,0,0,0);
    SpawnPlayer(playerid);
    return true;
}

stock
    GetStringFromServerCFG(const strn[])                                        //- Geta uma String do Server.cfg
{
    new str[64];
    GetServerVarAsString(strn, str, sizeof(str));
    return str;
}

stock                                                                           //- Geta FPS do Player By DraKiNs | Thankz Mr Turtle
    GetPlayerFPS(playerid)
{
    SetPVarInt(playerid, "DrunkL", GetPlayerDrunkLevel(playerid));
    if(GetPVarInt(playerid, "DrunkL") < 100) SetPlayerDrunkLevel(playerid, 2000);
        else{
            if(GetPVarInt(playerid, "LDrunkL") != GetPVarInt(playerid, "DrunkL"))
            {
                SetPVarInt(playerid, "FPS", (GetPVarInt(playerid, "LDrunkL") - GetPVarInt(playerid, "DrunkL")));
                SetPVarInt(playerid, "LDrunkL", GetPVarInt(playerid, "DrunkL"));
                if((GetPVarInt(playerid, "FPS") > 0) && (GetPVarInt(playerid, "FPS") < 256))
                {
                    return GetPVarInt(playerid, "FPS") - 1;
                }
            }
        }
    return 0;
}

stock SetVehicleSpeed ( vehicleid , Float:speed , mode = 1 )                    //Seta a Velocidade de um Carro
{
    static
        Float:vAngle,
        Float:poskm [ 3 ]
    ;
    GetVehicleZAngle ( vehicleid , vAngle ) ;
    speed = ( ( !mode ) ? ( floatdiv ( speed, 105.0 ) ) : ( floatdiv ( speed, 170.0 ) ) );
    return SetVehicleVelocity ( vehicleid , speed * floatsin ( -vAngle , degrees ) , speed * floatcos ( -vAngle , degrees ) , 0.0 ) ;
}

stock
    GetVehicleSpeed ( playerid , mode = 1 )                                     // Geta a Velocidade de Um Carro
{
    static
        Float:vAngle,
        Float:poskm [ 3 ]
    ;
    GetVehicleVelocity ( GetPlayerVehicleID ( playerid ) , poskm [ 0 ] , poskm [ 1 ] , poskm [ 2 ] ) ;
    return IsPlayerInAnyVehicle ( playerid ) ? floatround ( ( ( floatsqroot ( ( ( poskm [ 0 ] * poskm [ 0 ] ) + ( poskm [ 1 ] * poskm [ 1 ] ) + ( poskm [ 2 ] * poskm [ 2 ] ) ) ) * ( !mode ? 105.0 : 170.0 ) ) ) * 1 ) : 0;
}