This function will return the IP of the specified ban.

OOP Syntax Help! I don't understand this!

• Method:ban:getIP(...)
• Variable: .ip

Syntax

​string|false getBanIP ( ​ban theBan )

Required arguments

• theBan: The ban in which you want to return the IP of.

Returns

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

• string|false: ip

Code Examples

Example 1 Example 2 (OOP)

server

This example will show the user who banned a player the IP adress 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 IP Adress: " ..getBanIP(theBan), thisPlayer) -- And send him the IP adress 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 IP adress 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 IP Adress: " ..theBan.ip) -- And send him the IP adress 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