GetPlayerIp

GetPlayerIp

Description:

Function GetPlayerIp get the specified player's IP address and store it in a string.

PAWN is case-sensitive. GetPlayerIP (Capital letter P at the end) will not work.

This function does not work when used in OnPlayerDisconnect because the player is already disconnected. It will return an invalid IP (255.255.255.255). Save players' IPs under OnPlayerConnect if they need to be used under OnPlayerDisconnect.

Parameters:

(playerid, ip[], len)

int

playerid

The ID of the player to get the IP address of.

string

ip

The string to store the player's IP address in, passed by reference.

int

len

The maximum length of the IP address (recommended 16).

Return Values:

The length of the player's IP address. -1 if player specified doesn't exist.

• The player's IP address is stored in the specified array.

Examples:

Example 1

public OnPlayerConnect(playerid)
{
    new plrIP[16];
    GetPlayerIp(playerid, plrIP, sizeof(plrIP));
    if(!strcmp(plrIP, "127.0.0.1"))
    SendClientMessage(playerid, 0xFFFFFFFF, "Welcome to your server, master :)");
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• NetStats_GetIpPort: Get a player's IP and port.
• GetPlayerName: Get a player's name.
• GetPlayerPing: Get the ping of a player.
• GetPlayerVersion: Get a player's client-version.

Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.

• OnIncomingConnection: Called when a player is attempting to connect to the server.
• OnPlayerConnect: Called when a player connects to the server.
• OnPlayerDisconnect: Called when a player leaves the server.