AuthMeReloaded - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #golang #go #machine-learning #deep-learning #kubernetes #vue #awesome-list #pytorch #security #openai #open-source

AuthMeReloaded

(★ 878)

The best authentication plugin for the Bukkit/Spigot API!

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
- - maven.yml
- dependabot.yml
- ISSUE_TEMPLATE.MD
- codeStyleSettings.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- - configuration.md
- build.md
- commands.md
- config.md
- converters.md
- hash_algorithms.md
- permission_nodes.md
- premium.md
- translations.md
- - xenforo.sql
- - AuthMeController.php
  - Bcrypt.php
  - index.php
  - Pbkdf2.php
  - Sha256.php
.checkstyle.xml
.codeclimate.yml
.editorconfig
.gitignore
LICENSE
pom.xml
README.md
wallpaper.png

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/AuthMe/AuthMeReloaded

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AuthMeReloaded

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Maven (Java)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

cd authme-bungee

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AuthMeReloaded
**"The best authentication plugin for the Bukkit modding API!"**

<img src="wallpaper.png?raw=true" alt="AuthMeLogo"/>

| Type              | Badges                                                                                                                                                                                                                                                                                                                                                                                |
|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Code quality:** | [![Code Climate](https://codeclimate.com/github/AuthMe/AuthMeReloaded/badges/gpa.svg)](https://codeclimate.com/github/AuthMe/AuthMeReloaded) [![Coverage status](https://coveralls.io/repos/AuthMe-Team/AuthMeReloaded/badge.svg?branch=master&service=github)](https://coveralls.io/github/AuthMe-Team/AuthMeReloaded?branch=master)                                                 |
| **Jenkins CI:**   | [![Jenkins Status](https://img.shields.io/website-up-down-green-red/http/shields.io.svg?label=ci.codemc.org)](https://ci.codemc.org/) [![Build Status](https://ci.codemc.org/buildStatus/icon?job=AuthMe/AuthMeReloaded)](https://ci.codemc.org/job/AuthMe/job/AuthMeReloaded) ![Jenkins Tests](https://img.shields.io/jenkins/tests?jobUrl=https%3A%2F%2Fci.codemc.io%2Fjob%2FAuthMe%2Fjob%2FAuthMeReloaded) |
| **Other CIs:**    | [![Build Status](https://www.travis-ci.com/AuthMe/AuthMeReloaded.svg?branch=master)](https://www.travis-ci.com/AuthMe/AuthMeReloaded)                                                                                                                                                                                                                                                             |

## Description

Prevent username stealing on your server!<br>
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,<br>
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:
<ul>
  <li>Dedicated builds for <strong>Spigot Legacy</strong> (1.16–1.19), <strong>Spigot 1.21</strong> (1.20–1.21), <strong>Paper 1.21+</strong>, and <strong>Folia 1.21+</strong></li>
  <li>Native proxy plugins for <strong>BungeeCord</strong> and <strong>Velocity</strong></li>
  <li><strong>E-Mail Recovery System!</strong></li>
  <li>Username spoofing protection.</li>
  <li>Countries Whitelist/Blacklist! <a href="https://dev.maxmind.com/geoip/legacy/codes/iso3166/">(country codes)</a></li>
  <li><strong>Built-in AntiBot System!</strong></li>
  <li><strong>ForceLogin Feature: Admins can login with all account via console command!</strong></li>
  <li><strong>Avoid the "Logged in from another location" message!</strong></li>
  <li>Two-factor (2FA) support!</li>
  <li>Session Login!</li>
  <li>Messages served in each player's own Minecraft client language, with server-language fallback</li>
  <li>Editable translations and messages!</li>
  <li><strong>MySQL, MariaDB, PostgreSQL and SQLite Backend support!</strong></li>
  <li>Supported password encryption algorithms: SHA256, ARGON2, BCRYPT, PBKDF2, PBKDF2BASE64 — <a href="https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/hash_algorithms.md">full list</a></li>
  <li>Supports hashes from external systems for zero-downtime migration (XFBCRYPT, MYBB, PHPBB, JOOMLA, WORDPRESS, WBB3/WBB4, IPB3, and <a href="https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/hash_algorithms.md">more</a>)</li>
  <li>Custom MySQL tables/columns names (useful with forum databases)</li>
  <li><strong>Cached database queries!</strong></li>
  <li><strong>Fully compatible with Citizens2, CombatTag, CombatTagPlus!</strong></li>
  <li>Graphical login/register dialogs, with optional Paper/Folia pre-join dialogs</li>
  <li>Restricted users (associate a username with an IP)</li>
  <li>Protect player's inventory until correct authentication (requires PacketEvents)</li>
  <li><strong>Premium bypass: Mojang-account holders skip password auth (requires PacketEvents)</strong></li>
  <li>Saves the quit location of the player</li>
  <li>Ender pearls thrown before authentication are returned to the player on login</li>
  <li>Separate timeouts for login and registration</li>
  <li>Email address confirmation required before saving on <code>/email add</code> and <code>/email change</code></li>
  <li>Automatic database backup</li>
  <li>Available languages: <a href="https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/translations.md">translations</a></li>
  <li><strong>Account importers for Auth+, LibreLogin, LimboAuth, nLogin, OpeNLogin, tiAuth — and built-in SQLite ↔ MySQL/MariaDB/PostgreSQL migration.</strong></li>
</ul>

#### Configuration
[How to configure AuthMe](https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/config.md)

#### Dialog UI
AuthMe can display graphical login/register dialogs instead of chat-based prompts.

- `settings.registration.dialog.postJoin.enable` enables the **post-join** dialog flow.
- `settings.registration.dialog.preJoin.enable` enables the **pre-join** dialog flow on **Paper/Folia**.
- Both options are independent: you can enable either one, both, or neither.
- Pre-join dialogs currently require modern dialog-capable server versions such as **Paper/Folia 1.21.11+**.
- Verified premium players skip the pre-join dialog entirely when premium bypass is enabled.

#### Premium bypass
AuthMe can let players with a legitimate Mojang account skip password authentication entirely.
Identity is verified via a cryptographic handshake with Mojang's session server during the
Minecraft login phase — no password prompt is ever shown.

- Enable with `settings.enablePremium: true` in `config.yml`.
- Players opt in with `/premium` and out with `/freemium` (must be logged in). Admins can enrol or remove players with `/authme premium <player>` / `/authme freemium <player>`.
- **Direct-connection (offline-mode, no proxy):** requires [PacketEvents](https://github.com/retrooper/packetevents) 2.x. Without it, premium bypass is disabled at startup (fail-closed).
- **Behind an online-mode proxy (Velocity / BungeeCord):** the proxy authenticates with Mojang and forwards the verified UUID — no PacketEvents needed on the backend. Set `Hooks.bungeecord: true` on the backend.
- **Behind an offline-mode proxy:** install `authme-velocity` or `authme-bungee` on the proxy; premium players are authenticated per-player by the proxy and the verified UUID is forwarded to the backend.
- Full documentation: [docs/premium.md](docs/premium.md)

#### Commands
[Command list and usage](https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/commands.md)
#### Permissions
- authme.player.* - for all user commands
- authme.admin.* - for all admin commands
- [List of all permission nodes](http://github.com/AuthMe/AuthMeReloaded/blob/master/docs/permission_nodes.md)

#### How To
- [How to use the account importers (Auth+, LibreLogin, LimboAuth, nLogin, OpeNLogin, tiAuth)](docs/converters.md)
- [Website integration](https://github.com/AuthMe/AuthMeReloaded/tree/master/samples/website_integration)
- Convert between database types (e.g. SQLite to MySQL): `/authme converter sqliteToSql`

## Links and Contacts

- **Support:**
   - [GitHub issue tracker](https://github.com/AuthMe/AuthMeReloaded/issues)
   - [Discord](https://discord.gg/Vn9eCyE)
   - [BukkitDev page](https://dev.bukkit.org/projects/authme-reloaded)
   - [Spigot page](https://www.spigotmc.org/resources/authmereloaded.6269/)

- **Dev resources:**
  - <a href="https://ci.codemc.org/job/AuthMe/job/AuthMeReloaded/javadoc/">JavaDocs</a>
  - <a href="http://repo.codemc.org/repository/maven-public/">Maven Repository</a>
  ```xml
    <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](https://bstats.org/signatures/bukkit/AuthMe.svg)](https://bstats.org/plugin/bukkit/AuthMe/164)

## Requirements

##### Compiling requirements:
>- JDK 17+ for `authme-core`, `authme-tools`, and `authme-spigot-legacy`
>- JDK 21+ for the full multi-module build (`authme-bungee`, `authme-spigot-1.21`, `authme-paper-common`, `authme-paper`, `authme-folia`, `authme-velocity`)
>- 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](docs/build.md)

##### Running requirements:
>- Use the jar matching your server platform/version:
>  - Java 17+: `AuthMe-*-Spigot-Legacy.jar` — Spigot 1.16.x – 1.19.x
>  - Java 21+: `AuthMe-*-Spigot-1.21.jar` — Spigot 1.20.x – 1.21.x
>  - Java 21+: `AuthMe-*-Paper.jar` — Paper 1.21+
>  - Java 21+: `AuthMe-*-Folia.jar` — Folia 1.21+
>  - Java 21+: `AuthMe-*-Bungee.jar` — BungeeCord / Waterfall proxy (1.19 API)
>  - Java 21+: `AuthMe-*-Velocity.jar` — Velocity 3.4+ proxy
>- [PacketEvents](https://github.com/retrooper/packetevents) 2.x (optional plugin; required for inventory protection, tab-complete blocking, and premium bypass in direct-connection mode)

## Credits

##### Contributors:
Team members: <a href="https://github.com/AuthMe/AuthMeReloaded/wiki/Development-team">developers</a>, <a href="https://github.com/AuthMe/AuthMeReloaded/wiki/Translators">translators</a>

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