OnBan

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

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.

Cancel effect

This event cannot be canceled.

Example

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

function announceBan( theBan )
   if getElementType(source) == "player" then -- Check if the element responsible for the banning is a player
	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

• onBan
• onChatMessage
• onDebugMessage
BETA: NEW FEATURE (BUILD: 1.6.0 r21914)
onExplosion
• onSettingChange
• onUnban

Event functions

• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• wasEventCancelled