Serverauth Mod

Модуль входа ServerAuth — обзор возможностей

Это чисто серверный мод для Fabric (1.20.x 1.21.x 26.1.x), который обеспечивает вашему серверу комплексную систему проверки безопасности, включая принудительный вход, автоматическую привязку, управление сессиями и меры против бездействия.

Основные принципы дизайна

· Полный контроль администратора над аккаунтами: только OP (уровень прав 4) может создавать/удалять аккаунты; обычные

игроки не могут регистрироваться самостоятельно.

· Обязательная проверка входа: неавторизованные игроки не могут двигаться или взаимодействовать (телепортируются в пустоту с чёрным экраном).

· Автовход по привязке к устройству: игроки могут привязать свой аккаунт к UUID своего устройства для автоматического

входа при последующих заходах на сервер.

· Восстановление места входа: после успешного входа игроки телепортируются обратно к своей начальной точке появления.

· Двойной механизм тайм-аута:

· Тайм-аут бездействия: принудительный выход после заданного количества минут неактивности после входа, требуется повторный вход.

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

· Добавлено 6 языков, только администраторы могут использовать/менять chinese|english|spanish|french|russian|arabic для переключения между китайским и английским, испанским и так далее, язык мода по умолчанию — китайский

Игровой опыт (возможности для игроков)

1. Первый вход на сервер · При входе в игру игроки оказываются в пустоте (чёрный экран), подвешенными, и не могут двигаться. · В чате появится подсказка, предлагающая игрокам использовать команду /login для входа.
2. Команда входа /login · Введите имя пользователя и пароль, предоставленные администратором, для входа. · После успешного входа: · Игроки мгновенно телепортируются обратно к месту входа (точке появления или координатам при входе). · Режим игры переключится на выживание, позволяя нормально играть.
3. Привязка устройства (автовход) /login -b или /login --bind · Добавление параметра -b при входе навсегда привязывает аккаунт к UUID игрока (уникальному идентификатору для проверенных аккаунтов). · Игрок будет автоматически входить при последующих заходах на сервер без каких-либо действий.
4. Ручной выход /logout · Игроки могут вручную выйти, чтобы вернуться в состояние пустоты. Отвязка устройства /unbind · Используйте эту команду, чтобы отвязать текущий аккаунт от устройства (например, при смене игроков). · После отвязки для следующего входа потребуется ручной вход. Функции администратора (только для OP)

Все команды администратора начинаются с /auth. Команда Описание Пример

/auth create Создать аккаунт обычного игрока

/auth create -admin Создать аккаунт администратора (с правами OP)

/auth delete Удалить указанный аккаунт

/auth unbind Принудительно отвязать указанный аккаунт (для игроков, меняющих устройства)

/auth list Показать список всех аккаунтов и статус привязки

/auth kickall Кикнуть всех неавторизованных игроков (очистить сервер)

⚠️ Примечание: перед использованием команд /auth администраторы должны выдать себе права OP через консоль или другими способами (op [playername]). Настраиваемые параметры (config/serverauth/config.json) Файл конфигурации создаётся автоматически при запуске сервера. Вы можете изменять и сохранять его в любое время без перезапуска (мод периодически перечитывает настройки).

json {

“requireLogin”: true, // Требовать вход (рекомендуется оставить true)

“kickOnFailedLogin”: true, // Кикать игрока при неудачном входе

“maxLoginAttempts”: 3, // Максимальное количество попыток входа (подсчёт пока не реализован)

“enableSession”: true, // Включить функционал сессий

“sessionTimeout”: 30, // Зарезервированное поле, не используется

“sessionTimeoutMinutes”: 30, // Тайм-аут бездействия (минуты). Принудительный выход после неактивности, превышающей эту длительность (0=без тайм-аута)

“autoLoginExpiryDays”: 30 // Срок действия автовхода (дни). Аккаунты, привязанные дольше этого срока, требуют ручного ввода пароля при входе (0=бессрочно)

· Чтобы отключить тайм-аут бездействия: “sessionTimeoutMinutes”: 0

· Чтобы включить бессрочную привязку аккаунта: “autoLoginExpiryDays”: 0

**Вся информация об аккаунтах (включая хеши паролей, привязанные UUID, время создания) хранится в: [корневая директория сервера]/config/serverauth/accounts.json

· Хранение паролей: используется хеширование SHA-256, которое невозможно обратить.

· Привязки: основаны на Minecraft UUID (фиксированы для официальных аккаунтов; генерируются из имён игроков в офлайн-режиме). **

中文:

ServerAuth — мод для входа на сервер: подробное описание функций

Это чисто серверный мод для Fabric (1.20.x 1.21.x 26.1.x), который обеспечивает полную систему безопасности для вашего сервера: обязательный вход, автоматическую привязку, управление сессиями, защиту от AFK и многое другое.

Основная концепция

· Полный контроль администратора над аккаунтами: только OP (уровень прав 4) может создавать/удалять аккаунты, обычные игроки не могут регистрироваться самостоятельно.

· Обязательная проверка входа: неавторизованные игроки не могут двигаться и взаимодействовать (телепортируются в пустоту, чёрный экран, зависание).

· Автовход по привязанному устройству: при входе игрок может привязать аккаунт к своему UUID, и в дальнейшем будет входить на сервер автоматически.

· Восстановление позиции входа: после успешного входа игрок телепортируется обратно на позицию, где он только что зашёл на сервер.

· Двойная система тайм-аутов:

· Тайм-аут бездействия в сети: после входа, если игрок не проявляет активности дольше заданного количества минут, его принудительно выкидывает, и требуется повторный вход.

· Срок действия автовхода: после привязки аккаунта, если игрок не заходит дольше заданного количества дней, автовход перестаёт работать, и в следующий раз нужно вводить пароль вручную.

·Добавлено 6 языков, переключение доступно только администратору через /change chinese|english|spanish|french|russian|arabic — китайский, английский, испанский, русский, арабский, французский. Начальный язык мода — китайский.

Игровой опыт (функции с точки зрения игрока)

1. Первый вход на сервер

· После входа в игру игрок обнаруживает себя в пустоте (чёрный экран), в состоянии зависания, без возможности двигаться.

· В чате отображается подсказка с требованием войти через команду /login.

2. Команда входа

/login <аккаунт> <пароль>

· Введите выданные администратором логин и пароль для входа.

· После успешного входа: · Мгновенная телепортация обратно на позицию при входе на сервер (точка спавна или координаты входа). · Игровой режим переключается на выживание, можно нормально играть. 3. Привязка устройства (автовход)

/login <аккаунт> <пароль> -b или

/login <аккаунт> <пароль> --bind

· При входе с параметром -b текущий аккаунт навсегда привязывается к UUID игрока (уникальный идентификатор официального аккаунта).

· В дальнейшем этот игрок будет автоматически входить на сервер при каждом заходе, без каких-либо действий.

4. Ручной выход

/logout

· Игрок может самостоятельно выйти, вернувшись в состояние пустоты.

Отвязка устройства

/unbind

· Если игрок хочет отвязать текущий аккаунт от устройства (например, чтобы играл другой человек), он может использовать эту команду.

· После отвязки при следующем входе потребуется ручная авторизация.

Функции администратора (только для OP) Все административные команды начинаются с /auth.

Команда | Описание | Пример

/auth create <аккаунт> <пароль> | Создать аккаунт обычного игрока

/auth create <аккаунт> <пароль> -admin | Создать аккаунт администратора (с правами OP)

/auth delete <аккаунт> | Удалить указанный аккаунт

/auth unbind <аккаунт> | Принудительно отвязать указанный аккаунт (при смене устройства игроком)

/auth list | Показать список всех аккаунтов и статус привязки

/auth kickall | Кикнуть всех неавторизованных игроков (очистка)

⚠️ Внимание: перед использованием команд /auth администратор должен выдать себе права OP через консоль или другим способом (op имя_игрока). Настраиваемые параметры (config/serverauth/config.json) Файл конфигурации создаётся автоматически при запуске сервера, его можно изменять и сохранять в любое время без перезапуска (мод периодически перечитывает его).

json {

"requireLogin": true, // Обязательный вход (рекомендуется оставить true)

"kickOnFailedLogin": true, // Кикать ли игрока при неудачном входе

"maxLoginAttempts": 3, // Максимальное количество попыток входа (подсчёт пока не реализован)

"enableSession": true, // Включить функционал сессий

"sessionTimeout": 30, // Зарезервированное поле, не используется

"sessionTimeoutMinutes": 30, // Тайм-аут бездействия в сети (минуты), при превышении принудительный выход (0=никогда не истекает)

"autoLoginExpiryDays": 30 // Срок действия автовхода (дни), после привязки аккаунта при превышении этого срока требуется ручной ввод пароля (0=бессрочно)

· Чтобы игроки никогда не выкидывались за бездействие: "sessionTimeoutMinutes": 0

· Чтобы привязанный аккаунт был бессрочным: "autoLoginExpiryDays": 0

Вся информация об аккаунтах (включая хеши паролей, привязанные UUID, время создания) хранится в:

[корневая директория сервера]/config/serverauth/accounts.json

· Хранение паролей: используется хеширование SHA-256, невозможно обратить.

· Привязки: основаны на Minecraft UUID (фиксированы для официальных аккаунтов, в офлайн-режиме генерируются из имён игроков)