Added in 1.6.0 r23232

This function sets the serial number for a specified player account. It allows administrators to update or assign a new serial to registered accounts.

OOP Syntax Help! I don't understand this!

• Method: account:setSerial(...)
• Variable: .serial

Syntax

bool setAccountSerial ( account theAccount, string serial )

Required Arguments

• theAccount: The account element to set the serial for.
• serial: A valid 32-character hexadecimal string representing the new serial number.

Returns

• bool: result

Returns true if the serial was successfully set, false otherwise.

Code Examples

Example 1 Example 2 (OOP)

server

-- Advanced example: Administrative command system
local function changePlayerSerial(player, newSerial)
    local account = getPlayerAccount(player)
    if (account and not isGuestAccount(account)) then
        if (setAccountSerial(account, newSerial)) then
            outputChatBox("Serial number updated successfully!", player, 0, 255, 0)
            return true
        else
            outputChatBox("Failed to update serial number. Invalid format!", player, 255, 0, 0)
            return false
        end
    else
        outputChatBox("You must be logged into a registered account.", player, 255, 0, 0)
        return false
    end
end

-- Command to set a player's account serial
addCommandHandler("setserial", function(player, cmd, targetPlayer, newSerial)
    if (not targetPlayer or not newSerial) then
        outputChatBox("Usage: /setserial <player> <32-char-hex-serial>", player)
        return
    end

    local target = getPlayerFromName(targetPlayer)
    if (target) then
        if (string.len(newSerial) == 32 and string.match(newSerial, "^[A-Fa-f0-9]+$")) then
            changePlayerSerial(target, newSerial)
        else
            outputChatBox("Serial must be 32 hexadecimal characters!", player, 255, 0, 0)
        end
    else
        outputChatBox("Player not found!", player, 255, 0, 0)
    end
end)

server

OOP Required

-- Advanced example: Administrative command system
local function changePlayerSerial(player, newSerial)
    local account = player.account
    if (account and not account.guest) then
        if (account:setSerial(newSerial)) then
            player:outputChat("Serial number updated successfully!", 0, 255, 0)
            return true
        else
            player:outputChat("Failed to update serial number. Invalid format!", 255, 0, 0)
            return false
        end
    else
        player:outputChat("You must be logged into a registered account.", 255, 0, 0)
        return false
    end
end

-- Command to set a player's account serial
addCommandHandler("setserial", function(player, cmd, targetPlayer, newSerial)
    if (not targetPlayer or not newSerial) then
        player:outputChat("Usage: /setserial <player> <32-char-hex-serial>")
        return
    end

    local target = Player(targetPlayer)
    if (target) then
        if (newSerial:len() == 32 and newSerial:match("^[A-Fa-f0-9]+$")) then
            changePlayerSerial(target, newSerial)
        else
            player:outputChat("Serial must be 32 hexadecimal characters!", 255, 0, 0)
        end
    else
        player:outputChat("Player not found!", 255, 0, 0)
    end
end)

See Also

Account Functions

• addAccount
• copyAccountData
• getAccountByID
• getAccount
• getAccountData
• getAccountID
• getAccountIP
• getAccountName
• getAccountPlayer
• getAccountSerial
• getAccountType
• getAccounts
• getAccountsByData
• getAccountsByIP
• getAccountsBySerial
• getAllAccountData
• getPlayerAccount
• isGuestAccount
• logIn
• removeAccount
• logOut
• setAccountData
• setAccountName
• setAccountPassword
• setAccountSerial

Account Events

• onAccountCreate
• onAccountDataChange
• onAccountRemove

Account Elements

• account

Reference

• Scripting Functions