note Help Needed

This wiki is the result of an ongoing community effort — thank you all for helping!

If you want to provide changes to this page then please click here.

NetStats_PacketLossPercent

Description

Gets the packet loss percentage of a player. Packet loss means data the player is sending to the server is being lost (or vice-versa).

Name	Description
playerid	The ID of the player to get the data from.

Returns

The percentage packet loss as a float. 0 if player not connected.

Examples

public OnPlayerCommandText(playerid,cmdtext[])
{
    if (!strcmp(cmdtext, "/packetloss"))
    {
        new szString[144];
        format(szString, sizeof(szString), "Packets lost: %.2f percent.", NetStats_PacketLossPercent(playerid));
        SendClientMessage(playerid, -1, szString);
    }
    return 1;
}

Notes

tip

This function has been found to be currently unreliable the output is not as expected when compared to the client. Therefore this function should not be used as a packet loss kicker. A more accurate packetloss function:

stock GetPlayerPacketLoss(playerid, &Float:packetLoss)
{
    /* Returns the packetloss percentage of the given playerid - Made by Fusez */

    if(!IsPlayerConnected(playerid))
    {
        return 0;
    }

    new nstats[400+1], nstats_loss[20], start, end;
    GetPlayerNetworkStats(playerid, nstats, sizeof (nstats));

    start = strfind(nstats, "packetloss", true);
    end = strfind(nstats, "%", true, start);

    strmid(nstats_loss, nstats, start+12, end, sizeof (nstats_loss));
    packetLoss = floatstr(nstats_loss);
    return 1;
}

tip

Be advised that this function will report the packets lost by the server. The packet loss number reported by the client will be different, not because either is incorrect, but because both the server and the client are only aware of the loss packages sent by them.

tip

Anything greater than 0.0% should already be a cause of concern. Anything greater than 1.0% is outright bad.

Related Functions

GetPlayerNetworkStats: Gets a player's networkstats and saves it into a string.
GetNetworkStats: Gets the server's networkstats and saves it into a string.
NetStats_GetConnectedTime: Get the time that a player has been connected for.
NetStats_MessagesReceived: Get the number of network messages the server has received from the player.
NetStats_BytesReceived: Get the amount of information (in bytes) that the server has received from the player.
NetStats_MessagesSent: Get the number of network messages the server has sent to the player.
NetStats_BytesSent: Get the amount of information (in bytes) that the server has sent to the player.
NetStats_MessagesRecvPerSecond: Get the number of network messages the server has received from the player in the last second.
NetStats_ConnectionStatus: Get a player's connection status.
NetStats_GetIpPort: Get a player's IP and port.