SetAccountPassword: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Removed passwordType parameter)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setAccountPassword ( account theAccount, string password)
bool setAccountPassword ( account theAccount, string password )
</syntaxhighlight>  
</syntaxhighlight>  
{{OOP||[[account]]:setPassword|password|}}
{{OOP||[[account]]:setPassword|password|}}
Line 18: Line 18:
===Limits===
===Limits===
The following limits apply:
The following limits apply:
* Minimal account password length is 1 character.
* Minimum account password length is 1 character.
* Maximum account password length is 30 characters.
* Maximum account password length is 30 characters.
* Account password can not be equal to "*****"
* Account password can not be equal to "*****"

Revision as of 22:26, 1 July 2018

This function sets the password of the specified account.

Syntax

bool setAccountPassword ( account theAccount, string password )

OOP Syntax Help! I don't understand this!

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


Required Arguments

  • theAccount: the account whose password you want to set
  • password: the password
[[{{{image}}}|link=|]] Note: The password will always be encrypted with sha256, other types are no longer supported. See CAccountPassword for more information.

Returns

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

Limits

The following limits apply:

  • Minimum account password length is 1 character.
  • Maximum account password length is 30 characters.
  • Account password can not be equal to "*****"

Example

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)

See Also

Retrieved from "https://wiki.multitheftauto.com/wiki/SetAccountPassword?oldid=55530"