This function will return the serial of the specified ban.

OOP Syntax Help! I don't understand this!

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

Syntax

​string|false getBanSerial ( ​ban theBan )

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.

• string|false: serial

Code Examples

Example 1 Example 2 (OOP)

server

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

local function banPlayerCommand(thisPlayer, commandName, bannedName, reason)
    if (hasObjectPermissionTo(thisPlayer, "function.banPlayer")) then -- If the command user has the rights
        local bannedPlayer = getPlayerFromName(bannedName) -- Get player by name
        if (bannedPlayer) then
            local theBan = banPlayer(bannedPlayer, true, false, true, 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
        else
            outputChatBox("Player "..bannedName.." not found", thisPlayer)
        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)

server

OOP Required

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

local function banPlayerCommand(thisPlayer, commandName, bannedName, reason)
    if (ACL.hasObjectPermissionTo(thisPlayer, "function.banPlayer")) then -- If the command user has the rights
        local bannedPlayer = Player(bannedName) -- Get player by name
        if (bannedPlayer) then
            local theBan = bannedPlayer:ban(true, false, true, thisPlayer, reason) -- Ban the player
            thisPlayer:outputChat("ban: " .. bannedName .. " successfully banned") -- Send the banner a succes message
            thisPlayer:outputChat("At Serial: " ..theBan.serial) -- And send him the serial of the banned player
        else
            thisPlayer:outputChat("Player "..bannedName.." not found")
        end
    else
        thisPlayer:outputChat("ban: You don't have enough permissions") -- If the command user doesn't have the permissions
    end
end
addCommandHandler("ban", banPlayerCommand)

See Also

Admin Functions

• addBan
• banPlayer
• getBanAdmin
• getBanIP
• getBanNick
• getBanReason
• getBans
• getBanSerial
• getBanTime
• getUnbanTime
• isBan
• kickPlayer
• reloadBans
• removeBan
• setBanAdmin
• setBanNick
• setBanReason
• setUnbanTime

Reference

• Scripting Functions