Skip to main content
Before integrating your website with AuthMe, ensure you are using the latest official version. You can download the newest AuthMe release here:
https://www.spigotmc.org/resources/authmereloaded.6269/

1. Connect the plugin to the database

First, open the /plugins/AuthMe/config.yml file in your server’s main directory. Edit the database configuration section to match the example below:
DataSource:
    backend: MYSQL # Enable the plugin to read from the website database.
    caching: false
    mySQLHost: DATABASE_HOST
    mySQLPort: DATABASE_PORT
    mySQLUseSSL: false
    mySQLCheckServerCertificate: true
    mySQLUsername: DATABASE_USERNAME
    mySQLPassword: DATABASE_PASSWORD
    mySQLDatabase: DATABASE_NAME
    mySQLTablename: userslist
    mySQLColumnId: id
    mySQLColumnName: subname
    mySQLRealName: nick
    mySQLColumnPassword: password
    mySQLColumnSalt: ''
    mySQLColumnEmail: email
    mySQLColumnLogged: authme_logged
    mySQLColumnHasSession: authme_session
    mySQLtotpKey: totp
    mySQLColumnIp: ip
    mySQLColumnLastLogin: authme_lastlogin
    mySQLColumnRegisterDate: authme_created_at
    mySQLColumnRegisterIp: authme_regip
    mySQLlastlocX: x
    mySQLlastlocY: y
    mySQLlastlocZ: z
    mySQLlastlocWorld: world
    mySQLlastlocYaw: yaw
    mySQLlastlocPitch: pitch
    poolSize: 10
    maxLifetime: 1140000
Replace the placeholders with your own database credentials.
If the database information is incorrect or incompatible with other systems, the plugin may not work or could cause server errors.

2. Define the encryption method (Cryptographic algorithm)

Whether users register in-game or on your website, you must ensure their passwords are stored securely by choosing an appropriate cryptographic hashing algorithm. AuthMe supports various encryption methods, and SHA256 is one of the most secure and widely used. To configure this, open /plugins/AuthMe/config.yml and find the following section:
security:
    minPasswordLength: 5 # Minimum password length.
    passwordMaxLength: 30 # Maximum password length.
    passwordHash: SHA256 # Cryptographic hash algorithm.
Update it as shown above.

3. Additional settings

AuthMe provides advanced configuration options, such as disabling in-game registration. This allows players to register only via your website. When in-game registration is disabled, unregistered players attempting to join will receive an informative message directing them to register on the website. After registering, they can log in to the server using the password they created.
AuthMe setup completed successfully. Congratulations!