SetAccountPassword: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (li fix)
(Removed passwordType parameter)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setAccountPassword ( account theAccount, string password[, string passwordType="plaintext"] )
bool setAccountPassword ( account theAccount, string password)
</syntaxhighlight>  
</syntaxhighlight>  
{{OOP||[[account]]:setPassword|password|}}
{{OOP||[[account]]:setPassword|password|}}
Line 11: Line 11:
*'''theAccount:''' the account whose password you want to set
*'''theAccount:''' the account whose password you want to set
*'''password:''' the password
*'''password:''' the password
 
{{Note|The password will always be encrypted with '''sha256''', other types are no longer supported. See [[CAccountPassword]] for more information.}}
===Optional Arguments===
{{New feature/item|3.0151|1.5.1|7385|<ul><li>'''passwordType:''' can be "plaintext", "sha256", or "md5" - See [[CAccountPassword]] for more information</li></ul>}}


===Returns===
===Returns===
Line 19: Line 17:


===Limits===
===Limits===
Unless hashed with sha256 (length 97) or md5 (length 32), the following limits apply:
The following limits apply:
* Minimal account password length is 1 character.
* Minimal account password length is 1 character.
* Maximum account password length is 30 characters.
* Maximum account password length is 30 characters.

Revision as of 18:53, 3 June 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:

  • Minimal 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=55176"