Skip to content

AuthMe/AuthMeReloaded

Repository files navigation

AuthMeReloaded

"The best authentication plugin for the Bukkit modding API!"

AuthMeLogo

Type Badges
Code quality: Code Climate Coverage status
Jenkins CI: Jenkins Status Build Status Jenkins Tests
Other CIs: Build Status

Description

Prevent username stealing on your server!
Use it to secure your Offline mode server or to increase your Online mode server's protection!

AuthMeReloaded disallows players who aren't authenticated to do actions like placing blocks, moving,
typing commands or using the inventory. It can also kick players with uncommonly long or short player names or kick players from banned countries.

With the Session Login feature, you don't have to execute the authentication command every time you connect to the server! Each command and every feature can be enabled or disabled from our well-structured configuration file.

You can also create your own translation file and, if you want, you can share it with us! :)

Features:

  • E-Mail Recovery System!
  • Username spoofing protection.
  • Countries Whitelist/Blacklist! (country codes)
  • Built-in AntiBot System!
  • ForceLogin Feature: Admins can login with all account via console command!
  • Avoid the "Logged in from another location" message!
  • Two-factor (2FA) support!
  • Session Login!
  • Editable translations and messages!
  • MySQL and SQLite Backend support!
  • Supported password encryption algorithms: SHA256, ARGON2, BCRYPT, PBKDF2
  • Supported alternative registration methods:
    • PHPBB, VBulletin: PHPBB - MD5VB
    • Xenforo: XFBCRYPT
    • MyBB: MYBB
    • IPB3: IPB3
    • IPB4: IPB4
    • PhpFusion: PHPFUSION
    • Joomla: JOOMLA
    • WBB3: WBB3*
    • SHA512: SALTEDSHA512
    • DoubleSaltedMD5: SALTED2MD5
    • WordPress: WORDPRESS
    • List of all supported hashes
  • Custom MySQL tables/columns names (useful with forum databases)
  • Cached database queries!
  • Fully compatible with Citizens2, CombatTag, CombatTagPlus!
  • Compatible with Minecraft mods like BuildCraft or RedstoneCraft
  • Restricted users (associate a username with an IP)
  • Protect player's inventory until correct authentication (requires ProtocolLib)
  • Saves the quit location of the player
  • Automatic database backup
  • Available languages: translations
  • Built-in deprecated FlatFile (auths.db) to SQL (authme.sql) converter!
  • Import Auth+ accounts or migrate between SQLite and MySQL without losing AuthMe data.

Configuration

How to configure AuthMe

Commands

Command list and usage

Permissions

How To

Links and Contacts

  • Support:

  • Dev resources:

      <repositories>
          <repository>
              <id>codemc-repo</id>
              <url>https://repo.codemc.org/repository/maven-public/</url>
          </repository>
      </repositories>
    
      <dependencies>
          <dependency>
              <groupId>fr.xephi</groupId>
              <artifactId>authme-core</artifactId>
              <version>6.0.0-SNAPSHOT</version>
              <scope>provided</scope>
          </dependency>
      </dependencies>
  • Statistics: Graph

Requirements

Compiling requirements:
  • JDK 17+ for authme-core and authme-spigot-legacy
  • JDK 21+ for the full multi-module build (authme-spigot-1.21, authme-paper-common, authme-paper, authme-folia)
  • Maven (3.8.8+)
  • Git/GitHub (Optional)
How to compile the project:
  • Clone the project with Git/GitHub
  • Execute command mvn clean package
  • With JDK 17, Maven builds only the Java 17-compatible modules
  • With JDK 21+, Maven builds the full reactor
  • Build and tooling command reference: docs/build.md
Running requirements:
  • Use the jar matching your server platform/version
  • Java 17+ for AuthMe-*-Spigot-Legacy.jar (Spigot 1.16.x – 1.19.x)
  • Java 21+ for:
  • AuthMe-*-Spigot-1.21.jar (Spigot 1.20.x – 1.21.x)
  • AuthMe-*-Paper.jar (Paper 1.21+)
  • AuthMe-*-Folia.jar (Folia 1.21+)
  • ProtocolLib (optional, required by some features)

Credits

Contributors:

Team members: developers, translators

Credits for the old version of the plugin: d4rkwarriors, fabe1337, Whoami2 and pomo4ka

Thanks also to: AS1LV3RN1NJA, Hoeze and eprimex

GeoIP License:

This product uses data from the GeoLite API created by MaxMind, available at https://www.maxmind.com