GetBans: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server function}}
{{Server function}}
This function will return a table over all the [[ban]] values in the server.
This function will return a table containing all the [[ban]]s present in the server's banlist.xml.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
table getBans ()
table getBans ( )
</syntaxhighlight>
</syntaxhighlight>


===Returns===
===Returns===
Returns a [[table]] of all the [[ban]]s.
Returns a [[table]] containing all the [[ban]]s.


==Example==
==Example==

Revision as of 13:31, 24 November 2015

This function will return a table containing all the bans present in the server's banlist.xml.

Syntax

table getBans ( )

Returns

Returns a table containing all the bans.

Example

Click to collapse [-]
Example 1: Server

This example lists every ban when somebody types "/bans". WARNING: This will spam chat (for the player that executed the command) if the server has a lot of bans.

function listBans ( playerSource )
local banList = getBans() -- Return a table of all the bans.
	--
	for banID, ban in ipairs ( banList ) do -- For every ban do the following...	
		--
		local nick = getBanNick ( ban ) -- Get the IP of the ban
		--
		if nick then
			outputChatBox ( "Ban #" .. banID .. ": " .. nick, playerSource , 255, 0, 0, true ) -- Output the ban.
		end
		--
	end
	--
end
addCommandHandler ( "bans", listBans ) -- Add "/bans" as the trigger for the function.

See Also