Pair: removeAccount

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

• 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

• account|false: result

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

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-11138The 30-character password length limit has been removed.

See Also

Account Functions

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

Account Events

• onAccountCreate
• onAccountDataChange
• onAccountRemove

Account Elements

• account

Reference

• Scripting Functions