Pair: removeAccount

This function adds an account to the list of registered accounts of the current server.

Note

• Minimal account name/password length is 1 character.
• Account name/password can not be equal to *****.
• Account names are case-sensitive if allowCaseVariations is true.
• Maximum account password length was 30 characters until version 1.5.4-11138. Currently there is no upper limit.

OOP Syntax Help! I don't understand this!

• Method:Account.add(...)

Syntax

​account|false addAccount ( ​string name, ​string pass, [ ​bool allowCaseVariations = false ] )

Required arguments

• name: The name of the account you wish to make, this normally is the player's name.
• pass: The password to set for this account for future logins.

Optional arguments

Note: when using optional arguments, you might need to supply all arguments before the one you wish to use.

• allowCaseVariations (default: false): Whether the username is case sensitive (if this is set to true, usernames "Bob" and "bob" will refer to different accounts).

Returns

Returns an account or false if the account already exists or an error occured.

• account|false: result

Code Examples

Example 1 Example 2 Example 3 Example 4 (OOP)

server

This enables players to register on your server by using /register <password> in the chat window.

function registerPlayer(source, commandName, password)
    -- Check if the password field is blank or not (only blank if they didnt enter one)
    if (password and #password > 0) then
        -- Attempt to add the account, and save its value in a var
        local accountAdded = addAccount(getPlayerName(source), password)
        if (accountAdded) then
            --  Tell the user all is done
            outputChatBox("Thank you " .. getPlayerName(source) ..", you're now registed, you can login with /login", source)
        else
            -- There was an error making the account, tell the user
            outputChatBox("Error creating account, contact the server admin", source)
        end
    else
        -- There was an error in the syntax, tell the user the correct syntax.
        outputChatBox("Error creating account, correct syntax: /register <password>", source)
    end
end
addCommandHandler("register", registerPlayer) -- add the command handler

server

This enables players to register on your server by using /register <username> <password> in the chat window.

function registerPlayer(source, commandName, username, password)
    if (username and #username > 0 and password and #password > 0) then
        local accountAdded = addAccount(username, password)
        if (accountAdded) then
            outputChatBox("Thank you " .. getPlayerName(source) ..", you're now registed, you can login with /login", source)
        else
            outputChatBox("Error creating account, contact the server admin.", source)
        end
    else
        outputChatBox("Error creating account, correct syntax: /register <nick> <pass>", source)
    end
end
addCommandHandler("register", registerPlayer) -- add the command handler

server

This code differs again so the user can only register once /register <username> <password>.

local bRegisteredOnce = {}

function registerPlayer(source, commandName, username, password)
    if ((password and #password > 0) and (username and #username > 0) and not bRegisteredOnce[source]) then
        local accountAdded = addAccount(username, password)
        if (accountAdded) then
            outputChatBox("Thank you " .. getPlayerName(source) ..", you're now registed, you can login with /login", source)
            bRegisteredOnce[source] = true
        else
            outputChatBox("Error creating account, contact the server admin.", source)
        end
    else
        if (bRegisteredOnce[source]) then
            outputChatBox("You already registered on this server!", source)
        else
            outputChatBox("Error creating account, correct syntax: /register <nick> <pass>", source)
        end
    end
end

server

OOP Required

This enables players to register on your server by using /register <password> in the chat window.

function registerPlayer(source, commandName, password)
    -- Check if the password field is blank or not (only blank if they didnt enter one)
    if (password and #password > 0) then
        -- Attempt to add the account, and save its value in a var
        local accountAdded = Account.add(source.name, password)
        if (accountAdded) then
            --  Tell the user all is done
            source:outputChat("Thank you " .. source.name ..", you're now registed, you can login with /login")
        else
            -- There was an error making the account, tell the user
            source:outputChat("Error creating account, contact the server admin")
        end
    else
        -- There was an error in the syntax, tell the user the correct syntax.
        source:outputChat("Error creating account, correct syntax: /register <password>")
    end
end
addCommandHandler("register", registerPlayer) -- add the command handler

Changelog

1.5.4-11138

The 30-character password length limit has been removed.

See Also

Account Functions

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

Account Events

• onAccountCreate
• onAccountDataChange
• onAccountRemove

Account Elements

• account

Reference

• Scripting Functions