AuthMe 설정
서버의 로그인과 회원가입을 설정하고 바로 사용할 수 있는 줄을 받으세요 config.yml 각 항목에 대한 설명과 함께.
프리셋
config.yml에서 변경할 항목: 0
현재는 모두 기본 config와 일치합니다. 프리셋을 선택하거나 아래 설정을 변경하면 붙여넣을 줄이 여기에 표시됩니다.
기본 정보
메시지 언어 및 계정 모드
settings.messagesLanguageAuthMe가 플레이어에게 “register”와 “enter your password”를 안내할 때 사용하는 언어예요. 기본값은 영어이며, 러시아 서버라면 ru로 설정하세요.
settings.perPlayerLocale각 플레이어는 자신의 게임 언어로 메시지를 받고, 위에서 설정한 언어는 대체 언어로 사용돼요.
settings.serverName플러그인 메시지와 이메일에 삽입돼요.
settings.enablePremium공식 Minecraft 계정을 가진 플레이어는 비밀번호 없이 접속하고, 나머지는 평소처럼 접속해요. 플러그인이 인증 방식을 스스로 선택해요.
settings.preventOtherCaseXephi가 등록되어 있으면 XEPHI와 xephi는 로그인할 수 없어요. 대소문자를 바꿔 사칭하는 것을 막아줘요.
가입
플레이어가 처음 계정을 만드는 방식
settings.registration.enabled끄면 새 플레이어가 계정을 만들 수 없어요.
settings.registration.force가입과 로그인 없이는 플레이어가 아무것도 할 수 없어요. 예외는 아래 제한 섹션에서 설정해요.
settings.registration.typePASSWORD: 플레이어가 직접 비밀번호를 정해요. EMAIL: 비밀번호가 생성되어 플레이어가 입력한 이메일 주소로 전송돼요.
settings.registration.secondArgNONE: 비밀번호를 한 번만 입력해요. CONFIRMATION: 두 번째 단어로 다시 입력해야 해요. EMAIL_OPTIONAL과 EMAIL_MANDATORY: 두 번째 인수가 이메일이며, 선택 사항이거나 필수예요.
settings.registration.messageInterval플러그인이 플레이어에게 “로그인 또는 회원가입” 메시지를 반복하는 주기예요.
settings.restrictions.maxRegPerIp한 주소에서 가입할 수 있는 횟수예요. 0은 제한 없음을 뜻해요. 1로 설정하면 같은 집에서 함께 플레이하는 사람들에게는 너무 엄격해요.
settings.restrictions.registerTimeout플레이어가 가입해야 하는 시간(초)이에요. 0은 추방하지 않음을 뜻해요.
settings.registration.forceLoginAfterRegister가입에 성공한 후 플레이어가 명령어로 다시 로그인해야 해요.
settings.registration.forceKickAfterRegister가입 직후 플레이어를 추방하여 다시 접속하게 해요. 위의 /login 요구와 함께 활성화하지 마세요.
로그인
플레이어가 비밀번호를 입력할 때 발생하는 일
settings.restrictions.loginTimeout플레이어가 비밀번호를 입력해야 하는 시간(초)이에요. 0은 추방하지 않음을 뜻해요.
settings.restrictions.kickOnWrongPassword실수 직후 플레이어를 서버에서 추방해요. 무차별 대입 공격을 막는 데 도움이 되지만 일반 플레이어에게는 불편해요.
settings.restrictions.kickNonRegistered계정이 없는 플레이어는 접속 즉시 추방돼요. 비공개 서버 모드예요.
settings.restrictions.ForceSingleSession같은 닉네임으로 접속한 사람이 온라인 플레이어를 추방할 수 없어요(“Logged in from another Location”). 잘 알려진 세션 탈취 취약점을 막아줘요.
settings.restrictions.maxLoginPerIp한 주소에서 로그인할 수 있는 플레이어 수예요. 0은 제한 없음을 뜻해요.
settings.restrictions.maxJoinPerIp한 주소에서 허용되는 연결 수예요. 0은 제한 없음을 뜻해요.
세션
접속이 끊길 때마다 비밀번호를 입력하지 않도록
settings.sessions.enabled플러그인이 닉네임과 IP를 기억해요. 만료 전에 같은 주소에서 다시 접속하면 비밀번호를 묻지 않아요.
settings.sessions.timeout비밀번호를 다시 묻는 시간(분)입니다. IP가 바뀌어도 세션이 종료됩니다.
로그인 전
비밀번호 입력 전 플레이어가 할 수 있는 행동
settings.restrictions.allowChat끄면 게스트는 채팅할 수 없습니다. 아래에 나열된 명령 외의 모든 명령도 차단됩니다.
settings.restrictions.hideChat로그인하지 않은 플레이어는 다른 플레이어의 채팅을 볼 수 없습니다.
settings.restrictions.allowCommands나머지는 모두 차단됩니다. 여기서 /login 또는 /register를 제거하면 아무도 접속할 수 없습니다.
settings.restrictions.allowMovement게스트가 이동할 수 있습니다. 반경은 아래에서 설정합니다.
settings.restrictions.allowedMovementRadius게스트가 접속 지점에서 걸어갈 수 있는 거리입니다. 0은 제한 없음을 뜻합니다.
settings.restrictions.teleportUnAuthedToSpawn로그인 전에는 플레이어가 스폰에 머물고, 로그인 후에는 떠났던 위치로 돌아갑니다. 이렇게 하면 아무도 시야로 다른 사람의 기지를 엿볼 수 없습니다.
settings.restrictions.ProtectInventoryBeforeLogIn게스트는 로그인할 때까지 인벤토리 내용을 볼 수 없습니다. PacketEvents가 필요합니다.
플러그인 문서에 따르면 PacketEvents가 설치된 경우에만 작동합니다.
settings.restrictions.DenyTabCompleteBeforeLogin게스트가 자동완성으로 닉네임과 명령을 엿볼 수 없습니다. PacketEvents가 필요합니다.
settings.applyBlindEffect플레이어가 로그인할 때까지 실명 효과로 화면이 어두워집니다.
settings.restrictions.noTeleportAuthMe가 플레이어를 전혀 이동시키지 않습니다. 다른 플러그인이 텔레포트를 처리해 충돌할 때 필요합니다.
비밀번호
길이, 금지 비밀번호, 저장 방식
settings.security.minPasswordLength더 짧은 비밀번호는 허용되지 않습니다.
settings.security.passwordMaxLength비밀번호 길이의 상한입니다.
settings.security.passwordHash해싱 알고리즘입니다. BCRYPT와 ARGON2는 의도적으로 느려서 좋습니다. 무차별 대입 비용이 커지기 때문입니다. 목록의 다른 값은 비밀번호 데이터베이스가 포럼 엔진에서 넘어올 때 필요합니다.
운영 중인 서버에서 알고리즘을 바꾸시나요? settings.security.legacyHashes에 이전 알고리즘을 추가하지 않으면 사람들이 비밀번호로 로그인할 수 없습니다.
settings.security.unsafePasswords비밀번호로 사용할 수 없습니다. 소문자로 작성하세요. help는 반드시 남겨두세요. 문서에서 명령과의 충돌을 경고합니다.
settings.restrictions.allowedPasswordCharacters정규식입니다. 기본값 [!-~]는 모든 표시 가능한 ASCII 문자를 뜻하며, 제작자가 권장하는 값입니다.
사용자 이름
서버에서 허용되는 닉네임
settings.restrictions.minNicknameLength더 짧은 닉네임은 허용되지 않습니다.
settings.restrictions.maxNicknameLengthMinecraft의 표준 제한은 16입니다.
settings.restrictions.allowedNicknameCharacters정규식입니다. 기본값은 게임 자체가 허용하는 것과 같은 라틴 문자, 숫자, 밑줄입니다.
봇과 무차별 대입
대량 접속과 비밀번호 추측 방지
Protection.enableAntiBot짧은 시간에 너무 많은 플레이어가 접속하면 플러그인이 스스로 보호를 켭니다.
Protection.antiBotSensibility해당 간격 동안 몇 번의 접속을 공격으로 간주할지 정합니다.
Protection.antiBotInterval접속 수를 집계하는 시간 범위예요.
Protection.antiBotDuration보호가 작동한 후 유지되는 시간(분)이에요.
Protection.quickCommands.denyCommandsBeforeMilliseconds접속 후 이 시간보다 빨리 명령어가 오면 봇으로 간주해 추방해요.
Security.captcha.useCaptcha여러 번 틀리면 입력할 코드가 표시돼요.
Security.captcha.maxLoginTry코드를 요청하기 전까지 허용되는 실수 횟수예요.
Security.captcha.captchaLength코드의 문자 수예요.
Security.tempban.enableTempban해당 주소에서 비밀번호를 너무 많이 틀리면 차단돼요.
Security.tempban.maxLoginTries주소를 차단하기 전까지 플러그인이 허용하는 실수 횟수예요.
Security.tempban.tempbanLength임시 주소 차단이 유지되는 시간(분)이에요.
Protection.enableProtection아래 국가 목록에 있는 주소에서만 로그인과 가입이 허용돼요. GeoIP 데이터베이스가 필요해요.
Protection.countries두 글자 국가 코드예요. LOCALHOST는 서버 머신 자체에서 로그인할 때 사용해요.
FAQ
이 줄들은 어디에 붙여넣나요?
서버의 plugins/AuthMe/config.yml 파일에 붙여넣습니다. 빌더는 변경된 키만 중첩 구조를 유지한 채 출력하므로, 파일에서 같은 경로를 찾아 값을 설정하세요. 여기에 없는 설정도 있으므로 파일 전체를 교체할 필요는 없습니다. 편집 후 서버를 재시작하거나 /authme reload를 실행하세요.
플러그인의 메시지 언어를 어떻게 변경하나요?
settings.messagesLanguage를 필요한 언어 코드(예: ru)로 설정하세요. 기본값은 en이므로 새로 설치한 AuthMe는 플레이어에게 영어로 말합니다. settings.perPlayerLocale도 있습니다. 이 옵션이 켜져 있으면 각 플레이어는 게임 언어로 메시지를 받고, 위의 값은 대체값으로 사용됩니다.
플레이어가 접속을 끊을 때마다 비밀번호를 입력해야 한다고 불평합니다
세션을 활성화하세요. settings.sessions.enabled를 true로 설정하고 settings.sessions.timeout을 예를 들어 30분으로 설정하세요. 플러그인은 닉네임과 IP를 기억하고 그 시간 동안 같은 주소에서는 비밀번호를 묻지 않습니다. IP가 변경되면 세션이 종료되며, 이는 설정할 수 없습니다.
서버가 봇 공격을 받고 있다면 어떻게 해야 하나요?
플러그인에는 내장 안티봇이 있습니다. Protection.enableAntiBot은 기본적으로 켜져 있으며, Protection.antiBotSensibility는 일정 간격당 몇 번의 접속을 공격으로 간주할지 설정합니다. 여러 번 잘못된 비밀번호 입력 후의 캡차와 무차별 대입에 대한 임시 주소 차단도 도움이 됩니다. 위의 “봇 공격을 받는 중” 프리셋은 이 모든 것을 한 번에 켭니다.
국가 필터는 주의하세요
Protection.enableProtection은 국가 목록으로만 접속을 제한하지만, 기본적으로 그 목록에는 US, GB, LOCALHOST만 포함되어 있습니다. 목록을 편집하지 않고 보호를 활성화하면 다른 모든 국가의 플레이어가 접속할 수 없게 됩니다. 국가 코드는 두 글자 ISO 3166 코드입니다.
정품 플레이어는 비밀번호 없이 접속할 수 있나요?
네, settings.enablePremium이 그 역할을 합니다. 공식 Minecraft 계정이 있는 플레이어는 자동으로 인증되어 비밀번호를 입력하지 않고, 나머지는 평소처럼 접속합니다. 플러그인이 인증 방법을 자동으로 선택합니다.
어떤 비밀번호 저장 방식을 선택해야 하나요?
기본값은 SHA256입니다. BCRYPT와 ARGON2는 의도적으로 계산이 느리며, 그게 핵심입니다. 무차별 대입이 비싸지기 때문입니다. 중요: 운영 중인 서버에서 알고리즘을 변경하면 이전 알고리즘을 settings.security.legacyHashes에 추가하세요. 그렇지 않으면 사람들이 비밀번호로 로그인할 수 없게 됩니다.
게스트가 로그인 전에 다른 사람의 건축물을 볼 수 있습니다
settings.restrictions.teleportUnAuthedToSpawn을 활성화하세요. 로그인 전에는 플레이어가 스폰에 머물고, 로그인 후에는 떠났던 위치로 돌아갑니다. 보통 채팅 숨기기 및 이동 차단과 함께 사용합니다.
데이터 출처
설정 이름과 기본값은 2026년 9월 1일 기준 플러그인의 공식 문서에서 가져왔습니다. 빌더에는 사람들이 실제로 수동으로 변경하는 설정만 있으며, 나머지는 플러그인이 직접 생성합니다.