simppassforfree

SimpPassForFree — мод аутентификации и входа

Кроссплатформенная система аутентификации и входа игроков Minecraft, обеспечивающая надёжную проверку личности для серверов.

📖 Обзор

SimpPassForFree — это мод аутентификации игроков, созданный для серверов Minecraft на Fabric. Он решает задачи, требующие надёжной аутентификации, за счёт интеграции с API SimpPass, эффективно предотвращая использование альт-аккаунтов и злоупотребление кодами подтверждения с помощью множества механизмов безопасности. Текущая версия: Fabric 1.20.1 и 1.20.2
План разработки: версии для Forge и Paper в разработке
В будущем: версия с байткод-инъекцией для Minecraft 1.21.11+ с полной совместимостью с загрузчиками

✨ Возможности

🔐 Механизм проверки безопасности

Этот мод использует официальный API SimpPass для проверки личности игроков, который объединяет несколько механизмов безопасности:

1. Верификация через WeChat Mini Program

• Игрокам необходимо получить код подтверждения через WeChat Mini Program
• Реальная аутентификация аккаунта WeChat гарантирует подлинность личности игрока
• Предотвращает массовую регистрацию и фейковые аккаунты

2. Проверка безопасности через API SimpPass

• Верификация через официальный API SimpPass
• На стороне API интегрировано несколько механизмов безопасности (включая проверку IP, геолокацию, контроль рисков и т. д.)
• Обеспечивает безопасность и надёжность процесса верификации

🛡️ Внутриигровая защита

Управление статусом входа

• Ограничения для неаутентифицированных: игроки, не прошедшие верификацию, не могут выполнять никакие игровые действия

  • Не могут двигаться (позиция заблокирована)
  • Не могут использовать предметы и взаимодействовать с блоками
  • Не могут использовать большинство игровых команд
  • Не могут отправлять сообщения в чат (кроме команд из белого списка)

Управление сессией

• 120-секундное окно верификации: у игроков есть 120 секунд на прохождение верификации после входа на сервер
• Автоматический кик: игроки, не прошедшие верификацию в срок, автоматически кикаются
• Защита сессии: предотвращает перехват сессии и повторные атаки

Сохранение данных

• Информация о привязке игрока хранится локально
• Автоматическая запись времени последнего входа
• Поддержка общей конфигурации для нескольких серверов (через файлы конфигурации)

🎮 Оптимизация пользовательского опыта

• Дружелюбные сообщения: понятные подсказки при входе и сообщения об ошибках
• Быстрый процесс верификации: упрощённая двухэтапная верификация (привязка + код подтверждения)
• Автоопределение: автоматически распознаёт привязанных пользователей для входа сразу по коду подтверждения
• Оповещение о статусе входа: игроки видят статус входа других игроков на сервере

🚀 Быстрый старт

Требования

• Версия Minecraft: 1.20.1 или 1.20.2
• Fabric Loader: ≥ 0.18.4
• Fabric API: последняя версия
• Java: 17 или выше

Установка

1. Скачайте мод

   • Скачайте JAR-файл для вашей версии Minecraft со страницы Releases

2. Установите Fabric Loader

   • Если он ещё не установлен, посетите сайт Fabric, чтобы скачать и установить Fabric Loader

3. Установите Fabric API

   • Скачайте и установите Fabric API

4. Установите мод

   • Поместите скачанный JAR-файл мода в папку mods вашего сервера
   • Перезапустите сервер

5. Настройте UUID разработчика

   • После запуска сервера мод создаст файл конфигурации в config/simppassforfree/
   • Отредактируйте файл конфигурации и введите ваш UUID разработчика SimpPass
   • Перезапустите сервер, чтобы конфигурация вступила в силу

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

Расположение файла конфигурации: config/simppassforfree/config.json

{
  "developer_uuid": "your-developer-uuid-here",
  "session_timeout_seconds": 120,
  "kick_on_timeout": true
}

Параметры конфигурации:

• developer_uuid: ваш UUID разработчика SimpPass (обязательно)
• session_timeout_seconds: время ожидания сессии верификации в секундах, по умолчанию 120
• kick_on_timeout: автоматически кикать игроков при истечении времени, по умолчанию true

📝 Руководство по использованию

Процесс для игрока

Первый вход (привязка аккаунта)

1. После входа на сервер игроки получают приветственное сообщение и подсказку для входа
2. Игрокам нужно получить свой SimpPass UID из WeChat Mini Program
3. Используйте команду в игре: `/auth `
4. Система проверит действительность UID
5. После успешной проверки игрокам нужно завершить вход с помощью кода подтверждения в течение 120 секунд

Вход привязанного пользователя

1. После входа на сервер система автоматически определяет привязанные аккаунты
2. Игроки получают код подтверждения из WeChat Mini Program
3. Используйте команду в игре: /p <код_подтверждения>
4. Система проверяет код через API SimpPass
5. После успешной проверки игроки могут играть нормально

Команды

`/auth `

• Функция: привязка или проверка SimpPass UID
• Права: все игроки

• Описание:

  • Первое использование: привязка нового аккаунта SimpPass
  • Уже привязан: запуск процесса верификации, подсказка использовать команду /p

/p <код_подтверждения>

• Функция: завершение входа с помощью кода подтверждения
• Права: все игроки

• Описание:

  • Должна использоваться в течение 120 секунд после привязки UID
  • Код подтверждения получается из WeChat Mini Program
  • После успешной проверки игроки могут играть нормально

Команды из белого списка

Неаутентифицированные игроки могут использовать следующие команды:

• /p — команда входа по коду подтверждения
• /auth — команда привязки аккаунта
• /help — команда помощи
• /list — просмотр игроков онлайн
• /me — команда действия
• /tell, /msg, /w, /r — команды личных сообщений

• /tellraw — команда сырых сообщений

• /version — информация о версии
• /seed — информация о сиде
• /scoreboard — команды таблицы очков
• /team — команды команд
• /bossbar — команды боссбара
• /datapack — команды датапаков

🔧 Техническая архитектура

Дизайн совместимости с загрузчиками

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

• Основные модули: Кроссплатформенная общая основная функциональность (управление данными пользователей, API-клиент и т.д.)
• Слой адаптера загрузчика: Реализации для конкретных загрузчиков (Fabric, Forge, Paper и т.д.)
• Унифицированный интерфейс: Кроссплатформенная совместимость через унифицированные интерфейсы

Основные модули

• Управление данными пользователей (UserDataManager): Управляет информацией о привязке игроков и сохранением данных пользователей
• Управление сессиями аутентификации (AuthSessionManager): Управляет сессиями входа и процессом верификации
• Управление аутентификацией игроков (PlayerAuthManager): Управляет статусом входа игроков и контролем разрешений
• API-клиент (SimpPassApiClient): Взаимодействует с API-сервером SimpPass
• Обработчики команд (AuthCommands): Обрабатывает команды, связанные с аутентификацией игроков (реализация для конкретного загрузчика)
• Перехватчик команд (CommandInterceptor): Перехватывает выполнение команд для неаутентифицированных игроков (реализация для конкретного загрузчика)
• Обработчики событий (PlayerJoinHandler, AuthEventHandler): Обрабатывает события входа игроков и аутентификации (реализация для конкретного загрузчика)

Будущая архитектура: версия с инъекцией байт-кода

В версии Minecraft 1.21.11+ мы выпустим версию с инъекцией байт-кода:

• Инъекция байт-кода: Прямая инъекция байт-кода с использованием инструментов вроде ASM, без необходимости в реализации для конкретных загрузчиков
• Автоопределение: Автоматически определяет тип загрузчика, используемого сервером
• Унифицированная реализация: Одна кодовая база работает для всех загрузчиков
• Оптимизация производительности: Снижает накладные расходы слоя адаптера, повышает производительность

Реализация механизма безопасности

1. Верификация через API SimpPass

   • Верификация пользователя через официальный API SimpPass
   • Обработка IP-адресов, геолокации и других проверок безопасности на стороне API
   • Обеспечивает безопасность и надёжность процесса верификации

2. Управление сессиями

   • 120-секундное окно верификации, автоматическое истечение по таймауту
   • Предотвращает атаки повторного воспроизведения сессий
   • Автоматическая очистка истёкших сессий

3. Внутриигровая защита

   • Неаутентифицированные игроки не могут выполнять игровые операции
   • Блокировка позиции предотвращает несанкционированное перемещение
   • Перехват команд защищает безопасность сервера

🛠️ Расширенная конфигурация

Настройка таймаута верификации

Измените значение session_timeout_seconds в файле конфигурации (в секундах):

{
  "session_timeout_seconds": 180
}

Настройка поведения кика по таймауту

Вы можете настроить, автоматически ли кикать игроков по таймауту:

{
  "kick_on_timeout": false
}

Если установлено false, игроки с истёкшим таймаутом не будут автоматически кикнуты, но всё ещё не смогут выполнять игровые операции.

Совместное использование конфигурации для нескольких серверов

Если у вас несколько серверов, вы можете совместно использовать данные пользователей:

1. Настройте директорию config/simppassforfree/ как общее хранилище (например, NFS, SMB)
2. Убедитесь, что все серверы имеют права на чтение/запись в общую директорию
3. Все серверы будут использовать одни и те же данные привязки пользователей

🔒 Рекомендации по безопасности

1. Защитите UUID разработчика

   • Не делитесь своим UUID разработчика с другими
   • Регулярно меняйте UUID при утечке
   • Используйте переменные окружения или зашифрованные файлы конфигурации для хранения UUID

2. Безопасность сервера

   • Регулярно обновляйте версии сервера и мода
   • Используйте файрвол для ограничения доступа к серверу
   • Включите запись логов сервера

3. Следите за аномальным поведением

   • Регулярно проверяйте логи сервера
   • Обращайте внимание на аномальные попытки входа
   • Своевременно реагируйте на инциденты безопасности

📊 Метрики производительности

• Задержка верификации: В среднем < 500мс
• Время отклика API: В среднем < 300мс
• Использование памяти: < 10МБ
• Использование CPU: < 1% (в режиме простоя)
• Поддержка одновременных подключений: Поддерживает 100+ игроков, одновременно проходящих верификацию онлайн

🐛 Часто задаваемые вопросы

В: Что делать, если игрок не может войти?

О: Пожалуйста, проверьте следующее:

1. Убедитесь, что игрок правильно привязал свой SimpPass UID
2. Проверьте, правильный ли код верификации (6 цифр)
3. Убедитесь, что код верификации не истёк (в течение 120 секунд)
4. Проверьте, нормально ли сетевое соединение сервера
5. Просмотрите логи сервера для получения подробной информации об ошибке

В: Как сбросить информацию о привязке игрока?

О: Удалите файл config/simppassforfree/<player_name>/user.json, и игроку потребуется привязаться заново.

В: Какие ещё версии Minecraft поддерживаются?

О:

• Версия для Fabric:

  • ✅ Выпущено: 1.20.1, 1.20.2
  • 🚧 В разработке: 1.14 - 1.20.0, 1.20.3 - 1.21.11
• Версия для Forge: В разработке, планируется поддержка 1.12.2 - 1.21.11
• Версия для Paper: В разработке, планируется поддержка 1.7.0 - 1.21.11 (Spigot для версий ниже 1.16.5)
• Версия с инъекцией байт-кода: Планируется для Minecraft 1.21.11+, будет поддерживать все основные загрузчики
• Другие версии: Могут быть поддержаны через кастомные сервисы

В: Когда будут выпущены версии для Forge/Paper?

О: Версии для Forge и Paper активно разрабатываются и, как ожидается, будут выпущены в будущих версиях. Следите за обновлениями проекта, чтобы узнать конкретные даты выпуска.

В: Каковы преимущества версии с инъекцией байт-кода?

О: Версия с инъекцией байт-кода будет выпущена для Minecraft 1.21.11+ со следующими преимуществами:

• Полная совместимость с загрузчиками: Автоматически поддерживает все основные загрузчики, такие как Fabric, Forge, Paper, Quilt и т.д.
• Без выбора версии: Одна версия работает для всех загрузчиков
• Лучшая производительность: Более эффективная совместимость через инъекцию байт-кода
• Простота обслуживания: Унифицированная кодовая база снижает затраты на поддержку

В: Как просмотреть логи входа игроков?

В: Почему не проходит проверка?

О: Обычные причины:

• Неверный или просроченный код подтверждения
• Ошибка проверки через API SimpPass (может включать IP, геолокацию, факторы риск-контроля и т. д.)
• Проблемы с сетевым подключением
• Неверно указан UUID разработчика

🗺️ План разработки

Текущий этап (завершено)

• ✅ Версия для Fabric 1.20.1
• ✅ Версия для Fabric 1.20.2
• ✅ Реализация основной функциональности
• ✅ Несколько механизмов проверки безопасности

Ближайшие планы (в работе)

• 🚧 Другие версии Fabric (1.14 – 1.20.0, 1.20.3 – 1.21.11)
• 🚧 Разработка версии для Forge (1.12.2 – 1.21.11)
• 🚧 Разработка версии для Paper/Spigot (1.7.0 – 1.21.11)

Среднесрочные планы

• 📅 Поддержка других загрузчиков (Quilt, NeoForge и т. д.)
• 📅 Оптимизация производительности и рефакторинг кода
• 📅 Усиление механизмов безопасности
• 📅 Полное тестирование совместимости для разных версий

Долгосрочные планы

• 📅 Версия с байткод-инъекцией для Minecraft 1.21.11+
• 📅 Полная автоматическая совместимость с загрузчиками
• 📅 Единая кодовая база и процесс поддержки
• 📅 Поддержка обратной совместимости (поддержка более ранних версий Minecraft)

📄 Лицензия

Этот проект распространяется под лицензией GPL-3.0.

🤝 Участие в разработке

Мы рады вашему вкладу! Пожалуйста, не стесняйтесь создавать Issues и Pull Requests.

📞 Контакты

• Сообщения об ошибках: GitHub Issues
• Индивидуальные услуги: https://buy.xiaofansmp.xin
• Техническая поддержка: свяжитесь через сайт индивидуальных услуг

🙏 Благодарности

Спасибо всем разработчикам и пользователям, внёсшим вклад в этот проект!

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

• Текущая версия: Fabric 1.20.1/1.20.2

• В разработке:

  • Fabric: 1.14 – 1.20.0, 1.20.3 – 1.21.11
  • Forge: 1.12.2 – 1.21.11
  • Paper/Spigot: 1.7.0 – 1.21.11 (Spigot для версий ниже 1.16.5)
• Запланировано: версия с байткод-инъекцией (Minecraft 1.21.11+)