SetServerPassword: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
Line 9: Line 9:
bool setServerPassword ( string thePassword )
bool setServerPassword ( string thePassword )
</syntaxhighlight>  
</syntaxhighlight>  
[[File:Mta-screen 2020-04-27 16-22-06.png|thumb|if server have a password, The lock mark appears.]]
[[File:Mta-screen 2020-04-27 16-22-06.png|thumb|Lock icon indicating a password protected server.]]


===Required Arguments===  
===Required Arguments===  

Latest revision as of 14:16, 27 April 2020

This function changes the password required to join the server to the given string.

Syntax

bool setServerPassword ( string thePassword )
Lock icon indicating a password protected server.

Required Arguments

  • thePassword: The new server password you want. Pass nil or an empty string to remove the password.

Returns

Returns true if the password was successfully changed or removed, false or nil otherwise.

Example

This example adds two commands for you to use: setpassword and removepassword.

addCommandHandler( "setpassword", -- add a command handler for the command
   function( thePlayer, command, password )
      if #password < 3 then -- check if the password is shorter than 3 letters
         outputChatBox( "The password needs to be atleast 3 letters long!", thePlayer ) -- tell the player that password was too short
         return -- abort command
      end
      local success = setServerPassword( password ) -- check whether changing password worked
      if success then
         outputChatBox( "Server password change to: " .. password, thePlayer ) -- if it did, tell the player
      else
         outputChatBox( "Failed to change servers password.", thePlayer ) -- if it didn't, tell the player
      end
   end
)

addCommandHandler( "removepassword", -- add a command handler for the command
   function( thePlayer, command )
      local success = setServerPassword( nil ) -- check whether removing password worked
      if success then
         outputChatBox( "Server password removed successfully", thePlayer ) -- if it did, tell the player
      else
         outputChatBox( "Failed to remove servers password.", thePlayer ) -- if it didn't, tell the player
      end
   end
)

See Also