AddBan: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added updated ban syntax for time based bans.)
m (→‎Required Arguments: added the ORs ;))
Line 11: Line 11:
===Required Arguments===  
===Required Arguments===  
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.
'''or'''
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.
'''or'''
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.
''' or any combination.'''


===Optional Arguments===  
===Optional Arguments===  

Revision as of 09:11, 14 March 2009

This function will add a ban for the specified IP/username/serial to the server.

Syntax

ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         

Note: One of the three: IP, Username or Serial have to be specified.

Required Arguments

  • IP: The IP to be banned. If you don't want to ban by IP, set this to nil.

or

  • Username: The username to be banned. If you don't want to ban by username, set this to nil.

or

  • Serial: The serial to be banned. If you don't want to ban by serial, set this to nil.

or any combination.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • responsibleElement: The element that is responsible for banning the IP/username/serial. This can be a player or the root (getRootElement()).
  • reason: The reason the IP/username/serial will be banned from the server.
  • seconds: The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

Returns

Returns true if the IP/username/serial was banned succesfully, false if invalid arguments are specified.

Example

--TODO

See Also