GetBanSerial: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Example added.)
(Fix oop syntax)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server function}}
{{Server function}}
This function will return the [[serial]] of the specified [[ban]] pointer.
This function will return the [[serial]] of the specified [[ban]].


==Syntax==  
==Syntax==  
Line 7: Line 7:
string getBanSerial ( ban theBan )
string getBanSerial ( ban theBan )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ban]]:getSerial|serial}}


===Required Arguments===  
===Required Arguments===  
Line 19: Line 21:
function banPlayerCommand ( thisPlayer, commandName, bannedName, reason )
function banPlayerCommand ( thisPlayer, commandName, bannedName, reason )
     if ( hasObjectPermissionTo ( thisPlayer, "function.banPlayer" ) ) then -- If the command user has the rights
     if ( hasObjectPermissionTo ( thisPlayer, "function.banPlayer" ) ) then -- If the command user has the rights
         local bannedPlayer = getPlayerFromNick ( bannedName ) -- Get the ID from the player who gets banned
         local bannedPlayer = getPlayerFromName ( bannedName ) -- Get the ID from the player who gets banned
         if getElementType ( bannedPlayer ) == "player" then -- If it's a player
         if getElementType ( bannedPlayer ) == "player" then -- If it's a player
             local theBan = banPlayer ( bannedPlayer, thisPlayer, reason ) -- Ban the player
             local theBan = banPlayer ( bannedPlayer, thisPlayer, reason ) -- Ban the player
Line 34: Line 36:
==See Also==
==See Also==
{{Admin functions}}
{{Admin functions}}
[[Category:Needs Example]]
[[ru:getBanSerial]]
[[ru:getBanSerial]]

Latest revision as of 15:34, 6 August 2016

This function will return the serial of the specified ban.

Syntax

string getBanSerial ( ban theBan )


OOP Syntax Help! I don't understand this!

Method: ban:getSerial(...)
Variable: .serial


Required Arguments

  • theBan: The ban you want to retrieve the serial of.

Returns

Returns a string of the serial if everything was successful, false if invalid arguments are specified or if there was no serial specified for the ban.

Example

This example will show the user who banned a player the serial of that banned player.

function banPlayerCommand ( thisPlayer, commandName, bannedName, reason )
    if ( hasObjectPermissionTo ( thisPlayer, "function.banPlayer" ) ) then -- If the command user has the rights
        local bannedPlayer = getPlayerFromName ( bannedName ) -- Get the ID from the player who gets banned
        if getElementType ( bannedPlayer ) == "player" then -- If it's a player
            local theBan = banPlayer ( bannedPlayer, thisPlayer, reason ) -- Ban the player
            outputChatBox ( "ban: " .. bannedName .. " successfully banned", thisPlayer ) -- Send the banner a succes message
            outputChatBox ( "At Serial: " ..getBanSerial ( theBan ), thisPlayer ) -- And send him the serial of the banned player
        end
    else
        outputChatBox ( "ban: You don't have enough permissions", thisPlayer ) -- If the command user doesn't have the permissions
    end
end
addCommandHandler ( "ban", banPlayerCommand )

See Also