OnBan: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 8: | Line 8: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
*'''theBan ''': The [[ban]] which was added. | *'''theBan''': The [[ban]] which was added. | ||
==Source== | ==Source== | ||
| Line 20: | Line 20: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function announceBan( theBan ) | function announceBan( theBan ) | ||
if getElementType(source) == "player" then -- Check if the element responsible for the | 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 | outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial | ||
end | end | ||
end | end | ||
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root | |||
addEventHandler( "onBan", root, announceBan ) --Adds the event handler for | |||
</syntaxhighlight> | </syntaxhighlight> | ||
{{See also/Server event|Server events}} | {{See also/Server event|Server events}} | ||
Revision as of 21:15, 2 April 2018
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 ( 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
Event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getCancelReason
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- triggerClientEvent
- triggerLatentClientEvent
- wasEventCancelled