GetPlayerNetworkStats

Tags: player

WARNING

This function was added in SA-MP 0.3c R4 and will not work in earlier versions!

Description

Gets a player's network stats and saves them into a string.

Name Description
playerid The ID of the player you want to get the networkstats of.
retstr[] The string to store the networkstats in, passed by reference.
retstr_size The length of the string that should be stored.

Returns

This function always returns 1.

Examples

public OnPlayerCommandText(playerid,cmdtext[])
{
    if(!strcmp(cmdtext, "/mynetstats"))
    {
        new stats[400+1];
        GetPlayerNetworkStats(playerid, stats, sizeof(stats)); // get your own networkstats
        ShowPlayerDialog(playerid, 0, DIALOG_STYLE_MSGBOX, "My NetworkStats", stats, "Okay", "");
    }
    return 1;
}

Notes

TIP

This function may not return accurate data when used under OnPlayerDisconnect if the player has quit normally. It usually returns accurate data if the player has been kicked or has timed out.

  • GetNetworkStats: Gets the servers 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_PacketLossPercent: Get a player's packet loss percent.
  • NetStats_ConnectionStatus: Get a player's connection status.
  • NetStats_GetIpPort: Get a player's IP and port.