This function sets the password of the specified account.

Note

Don't forget to give admin rights to the resource, in which you are using setAccountPassword function or it won't work.

Note

• Minimal account password length is 1 character.
• Account password can not be equal to *****.
• Maximum account password length was 30 characters until version 1.5.4-11138. Currently there is no upper limit.

Important

The password will always be encrypted with sha256, other types are no longer supported.

OOP Syntax Help! I don't understand this!

• Method: account:setPassword(...)
• Variable: .password

Syntax

bool setAccountPassword ( account theAccount, string password )

Required Arguments

• theAccount: The account whose password you want to set.
• password: The password.

Returns

• bool: result

Returns true if the password was set correctly, false otherwise.

Code Examples

Example 1 Example 2 (OOP)

server

This example allows a user to change their password with a command.

function ChangePlayerPassword(player, command, oldpass, newpass)
  -- get the account the player is currently logged into
  local account = getPlayerAccount(player)
  if (account) then
    -- if its only a guest account, do not allow the password to be changed
    if (isGuestAccount(account)) then
      outputChatBox("You must be logged into an account to change your password.", player)
      -- end the function
      return
    end

    -- check that the old password is correct
    local password_check = getAccount(getAccountName(account), oldpass)
    if (password_check) then
      -- check the length of the new password
      if (string.len(newpass)>=5) then
        setAccountPassword(account,newpass)
      else
        outputChatBox("Your new password must be at least 5 characters long.", player)
      end
    else
      outputChatBox("Old password invalid.", player)
    end
  end
end
addCommandHandler("changepass", ChangePlayerPassword)

server

OOP Required

This example allows a user to change their password with a command.

function ChangePlayerPassword(player, command, oldpass, newpass)
  -- get the account the player is currently logged into
  local account = player.account
  if (account) then
    -- if its only a guest account, do not allow the password to be changed
    if (account.guest) then
      player:outputChat("You must be logged into an account to change your password.")
      -- end the function
      return
    end

    -- check that the old password is correct
    local password_check = Account(account.new, oldpass)
    if (password_check) then
      -- check the length of the new password
      if (string.len(newpass)>=5) then
        account:setPassword(newpass)
      else
        player:outputChat("Your new password must be at least 5 characters long.")
      end
    else
      player:outputChat("Old password invalid.")
    end
  end
end
addCommandHandler("changepass", ChangePlayerPassword)

Changelog

1.5.4-11138The 30-character password length limit has been removed.

See Also

Account Functions

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

Account Events

• onAccountCreate
• onAccountDataChange
• onAccountRemove

Account Elements

• account

Reference

• Scripting Functions