跳到正文

NeoLogin

作者:kmrvit

Secure NeoForge auth mod with PBKDF2, multi-language [EN/RU], SQLite/MySQL support.

收藏

截图

介绍

中文介绍正在准备中,下面暂时显示原文。

NeoLogin is a lightweight, high-performance, and secure authorization mod for Minecraft servers running on NeoForge 1.21.1. The mod protects player accounts on offline-mode (cracked) servers by requiring authentication upon joining.

It is designed with a focus on stability under load, enterprise-grade password security, console privacy, and ease of administration.

Key Features:

  • Flexible Database Storage: Out-of-the-box support for local SQLite storage (does not require any configuration) and remote MySQL database support for multi-server networks.
  • Enhanced Password Security (PBKDF2): Passwords are protected using PBKDF2 with HMAC-SHA256 (120,000 iterations and cryptographic salt). Existing legacy SHA-256 hashes are automatically upgraded to PBKDF2 upon the player’s next successful login.
  • Pre-auth Player Locking: Unauthenticated players are temporarily switched to Spectator mode and their movement is fully restricted. They cannot move, send chat messages, execute commands, interact with the world, or take damage.
  • Automatic and Manual Backups: Built-in commands to export and import player databases in JSON format. The database is also automatically backed up whenever the server starts.
  • Console Log Security: Automatic filtering of player passwords in console logs. During authentication or registration commands, passwords in console outputs are replaced with a secure mask (***).
  • Offline Player Management and Audit: Administrators can reset passwords, unregister accounts, or view the player’s last known IP address and login time even when the target player is not currently online.
  • Admin Performance Monitor: Built-in real-time monitor displaying server TPS and player Ping on the action bar.
  • Multi-Language and Branding: Built-in support for English and Russian, along with customizable branding for all in-game messages.
  • Automatic Config Migrator: Internal version tracking automatically updates the structure of the configuration file upon mod updates, preventing broken configurations and duplicate parameter bugs.

Mod Commands:

Player Commands:

  • /register (or /reg) – Register a new account.
  • /login (or /l) – Authenticate upon joining the server.
  • /changepassword (or /changepass) – Change your current account password.

Admin Commands (Requires permission neologin.admin or OP Level 2):

  • /neologin resetpassword – Generate a secure temporary password for a player.
  • /neologin setpassword – Forcefully set a new password for a player.
  • /neologin unregister – Delete a player account, resetting their registration status (works offline).
  • /neologin logininfo – Show the last known IP address and login date/time for a player.
  • /neologin forcelogin – Instantly authenticate an online player.
  • /neologin monitor – Toggle real-time TPS and Ping display on the action bar.
  • /neologin backup – Export the entire player database to a JSON backup file.
  • /neologin backups – List all available backup files on the server.
  • /neologin restore “filename” – Import player accounts from a selected backup file.
  • /neologin setbrand – Change the brand name displayed in auth messages.
  • /neologin setlang – Switch mod language between English and Russian.

Database Configuration:
The configuration file is located at config/neologin-server.toml. You can configure the database type and connection parameters in the database block:

[Database]
    # Type of database to use: 'sqlite' or 'mysql'
    databaseType = "sqlite"

    # Connection parameters (only used when databaseType is 'mysql')
    mysqlHost = "localhost"
    mysqlPort = 3306
    mysqlDatabase = "neologin"
    mysqlUsername = "root"
    mysqlPassword = "password"

NeoLogin — это легковесный, высокопроизводительный и безопасный мод авторизации для серверов Minecraft на базе NeoForge 1.21.1. Мод защищает аккаунты игроков на серверах в режиме offline-mode (пиратских), требуя прохождения аутентификации при входе.

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

Ключевые особенности:

  • Гибкое хранение данных: Поддержка локальной базы SQLite из коробки (не требует настройки) и удаленной базы MySQL для сетей из нескольких серверов.
  • Улучшенная защита паролей (PBKDF2): Пароли защищены с использованием алгоритма PBKDF2 с HMAC-SHA256 (120 000 итераций и криптографическая соль). Старые хеши SHA-256 автоматически обновляются до PBKDF2 при следующем успешном входе игрока.
  • Блокировка до авторизации: Неавторизованные игроки временно переводятся в режим наблюдателя с полным ограничением перемещения. Они не могут двигаться, писать в чат, выполнять команды, взаимодействовать с миром или получать урон.
  • Автоматические и ручные бэкапы: Встроенные команды для экспорта и импорта базы данных игроков в формате JSON. Также бэкап базы данных автоматически создается при каждом запуске сервера.
  • Безопасность логов консоли: Автоматическая фильтрация паролей игроков в логах. При выполнении команд входа и регистрации пароли в консоли заменяются на защитную маску (***).
  • Управление оффлайн-игроками и аудит: Администраторы могут сбрасывать пароли, удалять аккаунты и просматривать последний IP-адрес и время входа игрока, даже если он сейчас не в сети.
  • Монитор производительности для администрации: Встроенный монитор реального времени, отображающий TPS сервера и пинг игрока в строке action bar.
  • Мультиязычность и брендирование: Встроенная поддержка английского и русского языков, а также возможность настроить название проекта во всех внутриигровых сообщениях.
  • Автоматический мигратор конфигурации: Внутреннее отслеживание версии конфига автоматически обновляет структуру файла при выходе новых версий, предотвращая ошибки и дублирование параметров.

Команды мода:

Команды игроков:

  • /register (или /reg) – Зарегистрировать новый аккаунт.
  • /login (или /l) – Войти на сервер при подключении.
  • /changepassword (или /changepass) – Сменить текущий пароль аккаунта.

Команды администратора (требуется право neologin.admin или OP 2 уровня):

  • /neologin resetpassword – Сгенерировать надежный временный пароль для игрока.
  • /neologin setpassword – Принудительно установить новый пароль игроку.
  • /neologin unregister – Удалить аккаунт игрока и сбросить статус регистрации (работает оффлайн).
  • /neologin logininfo – Показать последний известный IP-адрес и дату/время входа игрока.
  • /neologin forcelogin – Мгновенно авторизовать игрока, находящегося в сети.
  • /neologin monitor – Включить/выключить отображение TPS и пинга в action bar.
  • /neologin backup – Экспортировать всю базу данных игроков в JSON-файл бэкапа.
  • /neologin backups – Показать список всех доступных файлов бэкапов на сервере.
  • /neologin restore “имя_файла” – Восстановить аккаунты игроков из выбранного файла бэкапа.
  • /neologin setbrand – Изменить название бренда, отображаемое в сообщениях мода.
  • /neologin setlang – Переключить язык мода между английским и русским.

Конфигурация базы данных:
Файл конфигурации находится по пути config/neologin-server.toml. Настроить тип базы данных и параметры подключения можно в блоке database:

[Database]
    # Тип используемой базы данных: 'sqlite' или 'mysql'
    databaseType = "sqlite"

    # Параметры подключения (используются только если databaseType = 'mysql')
    mysqlHost = "localhost"
    mysqlPort = 3306
    mysqlDatabase = "neologin"
    mysqlUsername = "root"
    mysqlPassword = "password"

常见问题

NeoLogin 支持哪些 Minecraft 版本?

NeoLogin 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

NeoLogin 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅服务端。

评论

登录后评论和评分