Налаштування AuthMe
Налаштуйте вхід і реєстрацію для свого сервера та отримайте готові рядки для config.yml з поясненням для кожного.
Пресети
Що змінити в config.yml: 0
Наразі все збігається з типовим config. Виберіть пресет або змініть налаштування нижче, і тут з'являться рядки для вставлення.
Основне
Мова повідомлень і режим акаунта
settings.messagesLanguageМова, якою AuthMe каже гравцям «зареєструйтеся» та «введіть пароль». Типово англійська; для російськомовного сервера вкажіть ru.
settings.perPlayerLocaleКожен гравець отримує повідомлення мовою своєї гри, а мова вище використовується як запасна.
settings.serverNameПідставляється в повідомлення та листи плагіна.
settings.enablePremiumГравці з офіційним акаунтом Minecraft заходять без введення пароля, решта — як звичайно. Спосіб перевірки плагін обирає сам.
settings.preventOtherCaseЯкщо Xephi зареєстрований, XEPHI та xephi не зможуть увійти. Захищає від видавання себе за іншого зміною регістру літер.
Реєстрація
Як гравець створює акаунт уперше
settings.registration.enabledВимкніть її, і нові гравці не зможуть створити акаунт.
settings.registration.forceБез реєстрації та входу гравець нічого не може робити. Винятки задаються в розділі обмежень нижче.
settings.registration.typePASSWORD: гравець сам обирає пароль. EMAIL: пароль генерується й надсилається на вказану ним адресу електронної пошти.
settings.registration.secondArgNONE: пароль вводиться один раз. CONFIRMATION: його треба повторити другим словом. EMAIL_OPTIONAL і EMAIL_MANDATORY: другий аргумент — це email, необов'язковий або обов'язковий.
settings.registration.messageIntervalЯк часто плагін повторює гравцеві повідомлення «увійдіть або зареєструйтеся».
settings.restrictions.maxRegPerIpСкільки разів можна зареєструватися з однієї адреси. 0 означає без обмежень. Одиниця сувора до тих, хто грає разом з однієї домівки.
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.maxNicknameLengthСтандартна межа Minecraft — 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 — для входу із самого сервера.
Часті питання
Куди вставляти ці рядки?
У файл 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: до входу гравець залишається на спавні, а після входу повертається туди, де був. Зазвичай це поєднують із приховуванням чату та блокуванням руху.
Звідки беруться дані
Назви налаштувань і типові значення взято з офіційної документації плагіна станом на 1 вересня 2026 року. У конструкторі є налаштування, які люди справді змінюють вручну; решту плагін створює сам.