Hand Shaker

Hand Shaker - это не просто очередной мод, а целая система верификации для серверов Майнкрафт. Если ты админ или собираешь свою сборку модов, то наверняка сталкивался с проблемой: игроки подключаются с модами, которые ломают баланс или вызывают конфликты. Hand Shaker решает это раз и навсегда.

Проект работает на обеих сторонах - и на клиенте, и на сервере. Это важно. Без установки на обе стороны ничего не заработает.

Что такое Hand Shaker?

По сути, это система, которая проверяет список модов у игрока при подключении к серверу. Сервер сверяет его с настроенными правилами и либо пускает игрока, либо нет. Поддерживаются Fabric, Paper и NeoForge - то есть почти все популярные платформы.

Основные возможности

• Fabric/NeoForge клиент - отправляет список модов на сервер при входе
• Paper/Fabric/NeoForge сервер - проверяет список и применяет ограничения
• Кроссплатформенность - работает на Fabric, Paper и NeoForge
• Криптографическая защита - нельзя подделать или изменить Hand Shaker
• Гибкая настройка - для каждого мода можно задать: Required (обязателен), Allowed (разрешен) или Blacklisted (запрещен)

Ключевые фишки

Фича	Описание
Настройка каждого мода	Можно индивидуально указать, какие моды обязательны, разрешены или запрещены
Гибкие наказания	Настраиваемые сообщения при кике и возможность автоматического бана
База данных игроков	Хранит историю модов каждого игрока - можно посмотреть, кто чем играл
Просмотр модов игроков	Админы могут видеть списки модов других игроков
Проверка целостности	Криптографические подписи не дают подделать отчет о модах
Кастомные действия	Можно настроить свои команды при срабатывании триггеров

Сравнение платформ

Тут все не так однозначно. Лучше всего Hand Shaker работает на Paper (6.x+), где поддерживается почти все: проверка целостности, гибкие правила, база данных, GeyserMC/Floodgate для Bedrock-игроков, права доступа и Folia. На Fabric (6.x+) тоже неплохо, но нет поддержки GeyserMC и Folia. NeoForge (6.x+) пока отстает - нет GeyserMC, прав доступа и кликабельного текста в чате.

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

Установка простая:

1. Скачиваешь нужную версию для своей платформы
2. Для Fabric клиента - кидаешь JAR в папку mods/
3. Для Paper сервера - в plugins/
4. Для NeoForge клиента - тоже в mods/
5. Настраиваешь конфиг

Пример конфига

config: v4

# Поведение: "strict" - строгое (требует мод на клиенте) или "vanilla" (пускает и без мода)
behavior: strict

# Режим целостности: "signed" (подписанный) или "dev" (для своих сборок)
integrity-mode: signed

# Белый список: true = только разрешенные моды, false = все разрешены по умолчанию
whitelist: false

# Пускать Bedrock-игроков
allow-bedrock-players: false

# База данных игроков (история модов)
playerdb-enabled: false

# Включение/отключение списков модов без потери конфигурации
mods-required-enabled: true
mods-blacklisted-enabled: true
mods-whitelisted-enabled: true

# Сообщения при кике (можно использовать {mod} для названия мода)
messages:
  kick: "Вы используете запрещенный мод: {mod}. Удалите его, чтобы зайти на сервер."
  no-handshake: "Чтобы подключиться к этому серверу, скачайте мод Hand Shaker."
  missing-whitelist: "Вам не хватает обязательных модов: {mod}. Установите их."
  invalid-signature: "Неверная подпись клиента. Используйте официальный клиент Hand Shaker."
  ban: "Вы забанены за использование запрещенного мода: {mod}."
  bedrock: "Bedrock-игроки не допускаются на этот сервер."

Пример кастомных действий

actions:
  kick:
    commands:
      - "kick {player} {messages.kick}"
  ban:
    commands:
      - "ban {player} {messages.ban}"
    log: true
  log:
    missing: "{player} пытался зайти без обязательных модов: {mod}"
    blacklisted: "{player} пытался зайти с запрещенными модами: {mod}"
  test_action:
    commands:
      - "msg {player} Привет! Ты используешь {mod}!"
      - "give {player} minecraft:diamond 1"
      - "say Скажите привет {player}, который использует {mod}!"

Права доступа

Право	Описание	По умолчанию
handshaker.admin	Доступ к админским командам	Оператор
handshaker.bypass	Игнорирование ограничений по модам	Нет

Поддерживаемые версии Minecraft

Загрузчик	Версии	Статус	Версии	Статус
Fabric	1.21 - 1.21.10, 1.21.11	✅ Поддерживается	N/A	N/A
Paper	1.21+	✅ Поддерживается	N/A	N/A
NeoForge	1.21 - 1.21.10, 1.21.11	✅ Поддерживается	1.20.1	В планах

Важно знать

Если ты собираешь сервер для друзей или публичный проект - Hand Shaker реально выручает. Особенно когда игроки ставят читы под видом обычных модов или просто ломают совместимость. Настройка занимает минут 10, а потом система работает сама.

Единственный минус - нужно ставить на обе стороны. Но это логично, иначе проверка не имеет смысла.

Скачать Hand Shaker можно для Fabric, Paper или NeoForge под Minecraft 1.21+. Если используешь старые версии вроде 1.20.1 - придется подождать обновления.