BlockIpAddress
From SA-MP Wiki
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 specific amount of seconds and, upon reconnect, will receive the same message. Effect takes place only when server is running (it is not persistent).
(ip_address[], timems)
ip_address | The IP to block. |
timems | The time (in milliseconds) that the connection will be blocked for. 0 can be used for an indefinite block. |
Return Values:
1 if ip_address string is not empty, otherwise 0.
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 | 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. |
[edit]
Related Functions
The following functions may be helpful as they relate to this function in one way or another.
- UnBlockIpAddress: Unblock an IP that was previously blocked.
- OnIncomingConnection: Called when a player is attempting to connect to the server.