BanPlayer - Revision history

Srslyyyy: Replace to predefined variables.

2023-06-04T09:37:04Z

Replace to predefined variables.

← Older revision		Revision as of 09:37, 4 June 2023
Line 65:		Line 65:
	-- Example function with the root element. Here you would pass a player element to the function.		-- Example function with the root element. Here you would pass a player element to the function.
	function banCheater(theCheater)		function banCheater(theCheater)
	banPlayer(theCheater, ~~getRootElement()~~, "You are banned because of cheating.")		banPlayer(theCheater, root, "You are banned because of cheating.")
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 79:		Line 79:
	}		}

	addEventHandler ( 'onPlayerLogin', ~~getRootElement ( )~~,		addEventHandler ( 'onPlayerLogin', root,
	function ( _, theCurrentAccount )		function ( _, theCurrentAccount )
	local Serial = Firewall[getAccountName(theCurrentAccount)]		local Serial = Firewall[getAccountName(theCurrentAccount)]
	if ( Serial ) then		if ( Serial ) then
	if Serial ~= getPlayerSerial ( source ) then		if Serial ~= getPlayerSerial ( source ) then
	banPlayer ( source, false, false, true, ~~getRootElement ( )~~, 'reason ban' )		banPlayer ( source, false, false, true, root, 'reason ban' )
	end		end
	end		end

2023-02-16T23:29:08Z

Add note for obsolete username arg

← Older revision		Revision as of 23:29, 16 February 2023
Line 30:		Line 30:
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''IP:''' Will player be banned by IP?		*'''IP:''' Will player be banned by IP?
	*'''Username:''' Will player be banned by username?		*'''Username:''' Will player be banned by [http://community.mtasa.com/ MTA Community] username (obsolete, set to ''false'')?
	*'''Serial:''' Will player be banned by serial?		*'''Serial:''' Will player be banned by serial?
	}}		}}

2018-06-24T03:54:26Z

← Older revision		Revision as of 03:54, 24 June 2018
Line 1:		Line 1:
			{{note\| Don't forget to give admin rights to the resource, in which you are using banPlayer function or it won't work.}}
	__NOTOC__		__NOTOC__
	{{Server function}}		{{Server function}}

2015-09-23T21:17:10Z

← Older revision		Revision as of 21:17, 23 September 2015
Line 12:		Line 12:
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )		ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player/string responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
	</syntaxhighlight>		</syntaxhighlight>
	}}		}}

2015-06-07T14:38:27Z

Returns

← Older revision		Revision as of 14:38, 7 June 2015
Line 37:		Line 37:

	===Returns===		===Returns===
	~~{{Deprecated_feature\|3\|1.0\|~~
	~~Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.~~
	}}

	~~{{New feature\|3\|1.0\|~~
	Returns a [[ban]] object if banned successfully, or ''false'' if unsuccessful.		Returns a [[ban]] object if banned successfully, or ''false'' if unsuccessful.
	}}

	==Example==		==Example==

2015-01-11T21:32:41Z

removed old verifyserials

← Older revision		Revision as of 21:32, 11 January 2015
Line 31:		Line 31:
	*'''Username:''' Will player be banned by username?		*'''Username:''' Will player be banned by username?
	*'''Serial:''' Will player be banned by serial?		*'''Serial:''' Will player be banned by serial?

	~~:'''Note:''' to ban by username or serial, ''verifyserials'' must be enabled in the server configuration file.~~

	}}		}}
	*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()) (Maximum 30 characters if using a string).		*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()) (Maximum 30 characters if using a string).

2014-11-18T08:11:41Z

Syntax

← Older revision		Revision as of 08:11, 18 November 2014
Line 12:		Line 12:
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false,		ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
	player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
	</syntaxhighlight>		</syntaxhighlight>
	}}		}}

2014-10-26T23:21:56Z

2014-10-26T23:20:02Z

2014-07-15T04:00:15Z

Syntax

← Older revision		Revision as of 04:00, 15 July 2014
Line 22:		Line 22:
	</syntaxhighlight>		</syntaxhighlight>
	}}		}}
			{{OOP\|\|[[player]]:ban\|\|}}
	===Required Arguments===		===Required Arguments===
	*'''bannedPlayer:''' The player that will be banned from the server.		*'''bannedPlayer:''' The player that will be banned from the server.