PlayerAuth

PlayerAuth is a lightweight authentication plugin for Minecraft servers running on Paper and compatible server software.

It provides a simple and reliable registration and login system designed for servers that need basic account protection without a huge amount of configuration.

Features

🔐 Authentication

Players can register and authenticate their accounts using simple commands:

• /register <password> <password>
• /login <password>
• /changepassword <old> <new>
• /logout

Unauthenticated players can be restricted from interacting with the server until they successfully log in.

🛡️ Login Protection

PlayerAuth can protect accounts against repeated incorrect password attempts.

Server administrators can configure:

• Maximum login attempts
• Temporary account lockouts
• Authentication timeout
• Restrictions for unauthenticated players

💾 Data Storage

Player authentication data is stored separately from the main server configuration.

The plugin is designed to keep authentication data persistent across server restarts.

🌍 Multilingual Support

PlayerAuth supports multiple languages without requiring separate plugin builds.

Languages can be selected through the configuration, allowing server owners to use the plugin in their preferred language.

Additional languages can be added by creating new message files.

⚙️ Highly Configurable

Server owners can customize authentication behavior and plugin messages through configuration files.

This includes:

• Authentication settings
• Password requirements
• Login attempt limits
• Timeout settings
• Player restrictions
• Language selection
• Messages

Compatibility

PlayerAuth is primarily designed for Paper.

It may also work on compatible Paper-based server software such as:

• Paper
• Purpur
• Pufferfish

Spigot compatibility depends on whether the specific plugin version uses Paper-specific APIs.

Commands

Command	Description
/register	Register a new account
/login	Log into an existing account
/changepassword	Change the account password
/logout	Log out of the account

Permissions

Permissions can be configured for administrative commands and plugin management.

Configuration

PlayerAuth generates its configuration files automatically on first startup.

Example:

language: en

auth:
  login-timeout: 60
  max-attempts: 3

password:
  min-length: 6
  max-length: 32

Why PlayerAuth?

PlayerAuth is designed to stay simple.

Instead of providing dozens of unrelated systems, it focuses on one task: protecting player accounts with a clean and understandable authentication system.

More security features can be added over time while keeping the basic setup easy for server administrators.

---

PlayerAuth A simple login system for Minecraft servers.

PlayerAuth

PlayerAuth это лёгкий плагин авторизации для Minecraft-серверов на Paper и совместимом серверном ПО.

Он предоставляет простую систему регистрации и входа, предназначенную для серверов, которым нужна базовая защита аккаунтов без огромного количества сложных настроек.

Возможности

🔐 Авторизация

Игроки могут зарегистрировать аккаунт и войти в него с помощью простых команд:

• /register <пароль> <пароль>
• /login <пароль>
• /changepassword <старый> <новый>
• /logout

До успешной авторизации игрок может быть ограничен в возможности взаимодействовать с сервером.

🛡️ Защита от перебора пароля

PlayerAuth может защищать аккаунты от большого количества неправильных попыток входа.

Администратор может настроить:

• Максимальное количество попыток входа
• Временную блокировку
• Тайм-аут авторизации
• Ограничения для неавторизованных игроков

💾 Хранение данных

Данные авторизации игроков хранятся отдельно от основной конфигурации сервера.

Данные сохраняются между перезапусками сервера.

🌍 Поддержка нескольких языков

PlayerAuth поддерживает несколько языков без необходимости выпускать отдельный .jar для каждого языка.

Язык можно выбрать через конфигурацию плагина.

Дополнительные языки можно добавить самостоятельно, создав новый файл сообщений.

⚙️ Настройка

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

Можно настроить:

• Параметры авторизации
• Требования к паролю
• Количество попыток входа
• Время на авторизацию
• Ограничения для игроков
• Язык плагина
• Сообщения

Совместимость

Основной целью PlayerAuth является Paper.

Плагин также может работать на совместимых с Paper ядрах, например:

• Paper
• Purpur
• Pufferfish

Совместимость со Spigot зависит от конкретной версии плагина и того, используется ли API, специфичный для Paper.

Команды

Команда	Описание
/register	Зарегистрировать аккаунт
/login	Войти в аккаунт
/changepassword	Изменить пароль
/logout	Выйти из аккаунта

Права

Права доступа могут использоваться для административных команд и управления плагином.

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

При первом запуске PlayerAuth автоматически создаёт необходимые конфигурационные файлы.

Пример:

language: ru

auth:
  login-timeout: 60
  max-attempts: 3

password:
  min-length: 6
  max-length: 32

Почему PlayerAuth?

PlayerAuth создан с упором на простоту.

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

В дальнейшем систему безопасности можно расширять, сохраняя простой первоначальный интерфейс.

---

PlayerAuth Простая система авторизации для Minecraft-серверов.