Gatekeeper

Gatekeeper заменяет вход по логину и паролю на офлайн-серверах на криптографическую аутентификацию по ключу. У каждого игрока есть уникальный цифровой ключ, который распознаёт сервер — пароль не нужно угадывать, передавать или красть. Создан для небольших офлайн-серверов, где оператор лично знает каждого игрока. Работает на Fabric и на Paper — обе серверные реализации используют один протокол, и один и тот же клиентский мод для Fabric подходит к любой из них.

Как это работает

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

Требования

• Сервер: либо Fabric с Fabric API, либо Paper
• Клиент: Fabric с Fabric API
• Каждый подключающийся клиент должен иметь установленный мод, независимо от того, какую серверную платформу вы используете
• Клиент и сервер должны быть на совпадающих версиях — устаревший клиент получает отказ с сообщением, какую версию нужно установить
• Сервер должен работать с online-mode=false в server.properties Spigot, CraftBukkit и Folia не поддерживаются: удержание игрока в фазе конфигурации требует connection API от Paper.

Установка

Сервер (Fabric)

1. Установите Fabric и Fabric API.
2. Поместите `gatekeeper-.jarв папкуmods/`.
3. Установите online-mode=false в server.properties.
4. Запустите сервер — каталог config/mcgatekeeper/ создастся автоматически.

Сервер (Paper)

1. Поместите `gatekeeper-paper-.jarв папкуplugins/`.
2. Установите online-mode=false в server.properties.
3. Запустите сервер — каталог plugins/McGatekeeper/ создастся автоматически.

Важно: online-mode=false без Gatekeeper означает, что любой, кто знает ник игрока, может выдать себя за него. Gatekeeper устраняет этот риск, но из-за этого вы должны одобрять каждого нового игрока перед тем, как он сможет зайти.

Клиент

1. Установите Fabric и Fabric API.
2. Поместите `gatekeeper-.jarв вашу папкуmods/`.
3. Всё — ключи создаются и сохраняются автоматически.

---

Первое подключение

Когда игрок подключается впервые:

1. В фоне создаётся пара ключей для этого сервера.
2. На экране подключения появляется сообщение, что сервер ждёт одобрения администратора.
3. Оператор выполняет `/gate allow `, чтобы одобрить игрока и зарегистрировать его ключ. Игрока впускают сразу, а его ключ запоминается для всех будущих подключений с этого устройства.

---

Команды администратора

Команда	Что делает
`/gate allow `	Одобряет ожидающего игрока и регистрирует его ключ
`/gate list `	Показывает все зарегистрированные ключи игрока с отпечатками
`/gate reset `	Удаляет все ключи игрока
`/gate reset `	Удаляет один ключ (например, потерянного устройства)

Автодополнение по Tab для /gate allow предлагает игроков, ожидающих одобрения. Требуется уровень оператора 3 на Fabric или разрешение mcgatekeeper.admin (по умолчанию выдаётся операторам) на Paper.

Управление ключами

Вы можете просматривать и управлять своими сохранёнными ключами через Mods → Gatekeeper → Manage Keys (требуется Mod Menu). Каждая запись показывает адрес сервера, с которым ключ использовался последний раз, а также короткие отпечатки как серверного, так и клиентского ключей.

Полную техническую документацию, модель безопасности и исходный код смотрите в репозитории на GitHub.