NullPass

NullPass — простой мод аутентификации для серверов Minecraft на NeoForge 1.21.1. Устанавливается только на сервер: игроки могут заходить с обычным совместимым клиентом, сам мод им ставить не нужно.

Новые игроки должны зарегистрировать аккаунт, а зарегистрированные — войти в него до начала игры. Пока аутентификация не пройдена, NullPass запрещает игроку двигаться, писать в чат, использовать большинство команд, взаимодействовать с миром, атаковать сущностей и открывать контейнеры.

Пароли никогда не сохраняются в виде открытого текста.

Возможности

• Установка только на стороне сервера.
• Безопасная регистрация и аутентификация аккаунтов.
• Хеширование паролей PBKDF2 с солью; пароли не хранятся в открытом виде.
• Настраиваемые ограничения длины пароля.
• Команды /register и /login с опциональными короткими псевдонимами.
• Команды /changepassword и опциональная /logout.
• Ограничения на движение, чат, команды, взаимодействие, инвентарь/контейнеры, ломание блоков и атаки до прохождения аутентификации.
• Подсказки об аутентификации в чате, на панели действий или в боссбаре.
• Настраиваемый интервал повторения подсказок.
• Настраиваемый тайм-аут регистрации/входа; неаутентифицированные игроки кикаются по его истечении.
• Настраиваемое ограничение на количество неверных попыток входа.
• Сообщение о неверном пароле с текущим числом попыток, например (1/3).
• Опциональные запоминаемые сессии для переподключающихся игроков.
• Опциональное требование того же IP для запоминаемых сессий.
• Настраиваемые сообщения с использованием старых цветовых кодов Minecraft (&).
• Языковые ресурсы на английском и русском; сообщения в конфигурации по умолчанию на русском.

Зачем использовать NullPass?

NullPass пригодится для серверов Minecraft в offline-режиме или приватных серверов, где игрокам нужен парольный слой входа. Он делает процесс аутентификации простым и настраиваемым, не требуя от каждого игрока устанавливать дополнительный мод. Используйте его, если хотите:

• защитить аккаунты игроков на сервере в offline-режиме;
• не давать неаутентифицированным игрокам взаимодействовать с миром;
• задать дедлайн входа и ограничить число попыток подбора пароля;
• предложить удобный период возобновления сессии после обычных переподключений;
• настроить все сообщения для игроков и место показа подсказок.

Основной синтаксис

Пароли считываются как один аргумент команды, поэтому они не могут содержать пробелы.

Конфигурация

NullPass использует общий конфигурационный файл NeoForge. После первого запуска мода отредактируйте созданный файл nullpass-common.toml в директории config вашего сервера, затем перезапустите сервер, чтобы применить изменения.

Основные параметры

Пример

shortCommands = true
sessionExpireSeconds = 60
requireSameIpForSession = true
messageDisplay = "ACTIONBAR"
messageRepeatSeconds = 3
allowLogoutCommand = true
authenticationTimeoutSeconds = 60
maxLoginAttempts = 3

[password]
minLength = 4
maxLength = 32

Сообщения и цвета

Любое сообщение для игрока можно изменить в секции messages. NullPass поддерживает старые цветовые коды с помощью &, например:

[messages]
login = "&6NullPass &7| &fPlease log in: /login <password>"
wrongPassword = "&6NullPass &7| &cIncorrect password."
authenticationTimeout = "&6NullPass &7| &fYou did not authenticate."
loginAttemptsExceeded = "&6NullPass &7| &fThe maximum number of login attempts has been exceeded."

Когда maxLoginAttempts включён, сообщение о неверном пароле автоматически получает серый счётчик перед последней неудачной попыткой:

NullPass | Incorrect password. (1/3)
NullPass | Incorrect password. (2/3)

При последней неудачной попытке игрок отключается с настроенным сообщением loginAttemptsExceeded.

Установка

1. Установите NeoForge для Minecraft 1.21.1 на ваш сервер.
2. Поместите JAR-файл NullPass в директорию mods сервера.
3. Запустите сервер один раз, чтобы создать конфигурационный файл.
4. При необходимости отредактируйте config/nullpass-common.toml.
5. Перезапустите сервер. Клиентам устанавливать NullPass не нужно.