BanSerial

From Multi Theft Auto: Wiki
Revision as of 10:52, 16 January 2008 by ChrML (talk | contribs) (New page: __NOTOC__ {{Server function}} {{Needs_Checking|Does this take optional reason arguments?}} This function will ban the specified serial number from the server. ==Syntax== <syntaxhighlight lang="lua"> b...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Dialog-information.png This article needs checking.

Reason(s): Does this take optional reason arguments?

This function will ban the specified serial number from the server.

Syntax

bool banSerial ( string theSerial )         

Required Arguments

  • theSerial: The serial to ban from this server

Returns

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

Example

This example lets a client (console or player) ban a serial if he has ACL rights.

--Add the "banserial" command handler
function banSerialCommand ( theClient, commandName, bannedSerial )

	-- Give the player a nice error if he doesn't have rights
	if ( hasObjectPermissionTo ( theClient, "function.banSerial" ) ) 

		--Ban the serial
		banSerial ( bannedSerial )
		outputChatBox ( "banserial: Serial " .. bannedSerial .. " successfully banned", theClient )
	else
		outputChatBox ( "banserial: You don't have enough permissions", theClient )
	end

end
addCommandHandler ( "banserial", banSerialCommand )

See Also