BlockIpAddress

From SA-MP Wiki

Jump to: navigation, search


This function was added in SA-MP 0.3z R2-2 and will not work in earlier versions!


Description:

Blocks an IP address from further communication with the server for a set amount of time (with wildcards allowed). Players trying to connect to the server with a blocked IP address will receive the generic "You are banned from this server." message. Players that are online on the specified IP before the block will timeout after a few seconds and, upon reconnect, will receive the same message.


Parameters:
(ip_address[], timems)
ip_addressThe IP to block.
timemsThe time (in milliseconds) that the connection will be blocked for. 0 can be used for an indefinite block.


Return Values:

This function does not return any specific values.


Example Usage:

public OnRconLoginAttempt(ip[], password[], success)
{
    if(!success) // if they supplied a bad password
    {
        BlockIpAddress(ip, 60 * 1000); // block the connections from this ip for one minute
    }
    return 1;
}
Tip

Image:Light_bulb_icon.png

Wildcards can be used with this function, for example blocking the IP '6.9.*.*' will block all IPs where the first two octets are 6 and 9 respectively. Any number can be in place of an asterisk.


Related Functions

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

Personal tools
In other languages