Skip to content

Logging in

archfan edited this page Jun 1, 2021 · 3 revisions

Logging into the relay

Wiki pages on logins/commands assume the user is using the default command prefix of !.

Logging into the relay is required for running all bot commands except the status command. It is accomplished by running the !login <username> [password] command in DMs (Direct Messages) with the bot.

If the user runs !login anywhere other than DMs, the bot will respond with the following message, which it will delete after 10 seconds:

@user You've quite possible just leaked your password; it is advised that you change it at once.
This message will be automatically deleted.

If the user runs !login correctly in DMs with the bot, the login request is added to the queue and processed on the next server request. If the server is down when the login request is sent, the login request will still be added to the queue and processed once the server returns.

  • Important: Multiple Discord users can be logged in as the same Minetest user. The only way to clear logins is to restart the relay.

Once the login has been processed, the user will be sent the result: "Login successful." or "Login failed."

The login can fail for a number of reasons, including:

  • The password is incorrect.
  • The user does not exist.
  • The auth data is corrupted, or a mod is overriding the API's auth functions incorrectly.

If the login succeeds, the Discord user will be logged in as the Minetest user and can run commands as them. Users cannot log in as more than one user at once, and a user's subsequent logins will overwrite their previous ones.

Clone this wiki locally