AuthMeReloaded는 서버에서 계정 인증을 강제하는 Minecraft 플러그인입니다. 인증되지 않은 플레이어가 월드와 상호작용하는 것(블록 설치, 이동, 인벤토리나 명령어 사용)을 막고, offline-mode 설정을 안전하게 보호하고, 세션 로그인 관리와 2단계 인증 및 이메일 복구 연동 기능을 제공합니다.

🎯 목적

이 플러그인의 핵심 목적은 플레이어가 일반 플레이를 하기 전에 검증된 로그인을 요구하여 플레이어 계정과 서버 무결성을 보호하는 것입니다. offline-mode 서버에서 인증이 필요한 서버 운영자나, online-mode 서버에서 추가 검증과 세션 제어가 필요한 운영자를 대상으로 합니다.

⚙️ 기능

인증되지 않은 플레이어의 행동을 차단하는 강제 로그인/등록 흐름.
재접속 시 반복 인증을 피할 수 있는 세션 로그인.
2단계 인증(2FA) 지원.
계정 복구를 위한 이메일 복구 및 확인 흐름.
여러 저장 백엔드: 계정 데이터용 SQLite, MySQL, MariaDB, PostgreSQL 지원.
다양한 비밀번호 해시 방식(SHA256, Argon2, Bcrypt, PBKDF2 등) 지원 및 마이그레이션을 위한 여러 외부 해시 형식과의 호환성.
내장된 안티봇 보호와 설정 가능한 로그인/등록 타임아웃.
Premium bypass(검증된 Mojang 계정이 비밀번호 입력을 건너뛰도록 허용)와 선택적 PacketEvents 연동 또는 proxy 기반 검증.
지원되는 서버 플랫폼에서의 그래픽 로그인/등록 대화상자.
국가 화이트리스트/블랙리스트 및 사용자 이름 길이 검사.
네트워크 구성용 BungeeCord 및 Velocity의 네이티브 proxy 측 모듈.

🧩 대상 사용자

계정 수준의 인증이 필요한 offline-mode / cracked 서버 운영자.
명시적인 로그인/등록 차단이 필요한 서버(소규모부터 대형 공개 서버까지).
proxy 소프트웨어를 사용하며 proxy 모듈을 통해 중앙 집중식 인증 제어를 원하는 네트워크.

🏗️ 예시 사용 사례

offline-mode SMP에서는 접속한 모든 플레이어가 월드와 상호작용하기 전에 비밀번호를 등록해야 합니다.
한 네트워크는 proxy 측 플러그인을 사용해 proxy에서 플레이어를 검증하고, 인증된 UUID를 백엔드 서버로 전달합니다.
한 서버는 이메일 복구와 2FA를 사용해 계정 도난을 줄이고 플레이어가 안전하게 비밀번호를 복구할 수 있도록 합니다.

⌨️ 명령어

명령어	설명	권한	접근
`/premium`	premium bypass를 사용하도록 설정합니다(로그인 상태여야 함).	지정되지 않음	플레이어
`/freemium`	premium bypass를 해제합니다(로그인 상태여야 함).	지정되지 않음	플레이어
`/authme premium <player>`	플레이어를 premium bypass에 등록합니다(관리자 작업).	지정되지 않음	관리자
`/authme freemium <player>`	플레이어를 premium bypass에서 제거합니다(관리자 작업).	지정되지 않음	관리자
`/authme converter sqliteToSql`	데이터베이스 백엔드 간 계정을 변환합니다(예시 변환 명령어).	지정되지 않음	관리자
`/email add`	복구용 이메일 주소를 추가/확인합니다(확인 필요).	지정되지 않음	플레이어
`/email change`	등록된 이메일 주소를 변경합니다(확인 필요).	지정되지 않음	플레이어

참고: 이 플러그인은 포괄적인 명령어 목록과 사용자/관리자 명령어 분류를 제공합니다. 위 표에는 공식 문서에서 명시적으로 언급된 명령어만 나열되어 있습니다.

🔐 권한

권한	설명	기본값
`authme.player.*`	일반 사용자 명령어(login, register, email 등)에 대한 접근을 부여합니다.	지정되지 않음
`authme.admin.*`	관리 명령어 및 관리 작업에 대한 접근을 부여합니다.	지정되지 않음

⚙️ 설치

📥 설정

서버 플랫폼과 버전에 맞는 공식 jar 파일을 다운로드하세요.
jar 파일을 서버의 plugins/ 디렉터리에 넣으세요.
서버를 재시작하고 콘솔에서 AuthMe가 로드되었는지 확인하세요.

이 프로젝트는 서버 유형과 버전 범위에 맞춘 전용 빌드를 제공합니다. 서버 플랫폼과 Minecraft 버전에 맞는 jar를 선택하세요.

📦 의존성

PacketEvents(선택 사항) — 직접 연결에서의 premium bypass와 해당 기능이 활성화된 경우 인벤토리 보호 같은 일부 기능에 필요합니다.

🧠 기술 참고

공식 빌드는 여러 대상용으로 제공됩니다(구형 Spigot 1.16–1.19, Spigot 1.20–1.21, Paper 1.21+, Folia 1.21+용으로 각각 별도 jar/build). 서버에 맞는 빌드를 사용하세요.
지원되는 데이터베이스 백엔드: SQLite, MySQL, MariaDB, PostgreSQL(계정 데이터 저장용).
일부 기능은 추가 연동이 필요합니다: 직접 premium bypass 및 일부 인벤토리 보호 기능에는 PacketEvents가 필요합니다. proxy 설치는 일반적으로 Velocity/BungeeCord용 proxy 모듈에 의존합니다.
이 프로젝트는 오픈 소스이며 GPL-3.0으로 배포됩니다.