This event is triggered when an IP address or serial is banned from the server.

Parameters

ban theBan

• theBan: the ban which was added.

Source

element: The source of this event is the element that was responsible for the banning. If no responsible was specified, the source is the global root element.

Canceling

This event cannot be canceled.

Code Examples

server

This example outputs a simple message to all players when a player added a ban.

function announceBan( theBan )
   if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
  outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
   end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root

See Also

Server Events

• onChatMessage
• onBan
• onDebugMessage
• onSettingChange
• onExplosion
• onShutdown
• onUnban

Server Functions

• getServerConfigSetting
• getServerHttpPort
• getMaxPlayers
• getServerIpFromMasterServer
• getServerName
• getServerPassword
• getServerPort
• isGlitchEnabled
• setGlitchEnabled
• setMaxPlayers
• setServerConfigSetting
• setServerPassword
• shutdown

Server Elements

• console

Reference

• Scripting Events