Logging in

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. Optimally, the entire process should take less than 300 ms.

• 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 subsequent logins will overwrite the previous ones.