OnIncomingConnection
From SA-MP Wiki
| This callback was added in SA-MP 0.3z R2-2 and will not work in earlier versions! |
Description:
This callback is called when an IP address attempts a connection to the server. To block incoming connections, use BlockIpAddress.
(playerid, ip_address[], port)
| playerid | The ID of the player attempting to connect |
| ip_address[] | The IP address of the player attempting to connect |
| port | The port of the attempted connection |
Return Values:
- 1 - Will prevent other filterscripts from receiving this callback.
- 0 - Indicates that this callback will be passed to the next filterscript.
- It is always called first in filterscripts.
Example Usage:
public OnIncomingConnection(playerid, ip_address[], port) { printf("Incoming connection for player ID %i [IP/port: %s:%i]", playerid, ip_address, port); return 1; }
Related Callbacks
The following callbacks might be useful as well, as they are related to this callback in one way or another.
- OnPlayerConnect: Called when a player connects to the server.
- OnPlayerDisconnect: Called when a player leaves the server.
- OnPlayerFinishedDownloading: Called when a player finishes downloading custom models.
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- BlockIpAddress: Block an IP address from connecting to the server for a set amount of time.
- UnBlockIpAddress: Unblock an IP that was previously blocked.
