HailWall

HailWall — Whitelist модов

HailWall проверяет моды, установленные на клиенте игрока при входе, и кикает его, если у него есть запрещённые моды (или отсутствует обязательный). Это современная лёгкая версия классической идеи Mod Whitelist.

⚠️ Устанавливай и на сервер, и на каждый клиент. Чисто серверный мод не может прочитать полный список модов клиента — ванильный клиент его просто не отправляет. Так что, как и любой мод такого рода, HailWall нуждается в маленьком компаньоне на клиенте.

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

• Режим whitelist (по умолчанию) — блокирует всё, кроме разрешённых модов. Обязательные (minecraft, загрузчик, java, hailwall) разрешены всегда.
• Режим blacklist — разрешает всё, кроме конкретных модов (чит-клиенты, x-ray, …).
• Обязательные моды — кикает игроков, у которых отсутствует нужный мод.
• Обход для операторов — операторы сервера никогда не кикаются, даже с лишними модами (аналог переключателя usePermission).
• Режим перехода / мониторинга (enforce: false) — никого не кикает, но всё равно записывает моды всех игроков. Идеально для внедрения HailWall без disruption игроков, пока ты составляешь список.
• Журнал доступа — один файл JSON-Lines в день (хранится в config/, так что доступен даже на таких хостингах, как Aternos), где указано, кто зашёл и с какими модами. Старые файлы удаляются автоматически.
• Подписанное рукопожатие — HMAC + челлендж на каждое соединение, чтобы предотвратить тривиальную подмену пакетов.
• Нулевые накладные расходы на геймплей — всё происходит один раз, при входе; журнал пишется в отдельном потоке. Никаких затрат на каждый тик.

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

Во время рукопожатия при входе сервер запрашивает у клиента список модов. Клиент отвечает списком установленных верхнеуровневых модов (id + версия), подписанным HMAC. Сервер проверяет подпись, сравнивает список с твоим конфигом и либо пускает игрока, либо отключает его — всё до того, как он войдёт в мир.

📦 Установка

1. Установи правильную версию выбранного загрузчика модов (например, Fabric, Forge или NeoForge) и все необходимые API на сервер и на каждый клиент.
2. Положи hailwall-x.y.z.jar в папку mods/ сервера и каждого клиента.
3. Запусти сервер один раз, чтобы сгенерировался config/hailwall.json, отредактируй его и перезапусти.

🔧 Конфигурация — config/hailwall.json

{
  "mode": "whitelist",          // "whitelist" или "blacklist"
  "enforce": true,              // false = режим мониторинга (только лог, никого не кикает)
  "operatorsBypass": true,      // операторы никогда не кикаются
  "requireCompanionMod": true,  // кикать клиенты без HailWall
  "verifySignature": true,
  "logModLists": true,
  "enableAccessLog": true,
  "accessLogRetentionDays": 5,

  "whitelist": ["sodium", "iris", "modmenu"],          // ТВОИ разрешённые моды
  "blacklist": ["meteor-client", "wurst", "baritone"], // используется только в режиме blacklist
  "requiredMods": []
  // + полностью настраиваемые / переводимые сообщения при кике
}

Найти id любого мода можно в его mod.json (поле id). Проще: прочитай его прямо из журнала доступа или из logs/latest.log клиента, куда HailWall выводит полученный список модов.

🔒 Приватность и данные

• Клиент отправляет только id модов + версии верхнеуровневых модов — никаких путей к файлам, никакой системной информации, никаких личных данных.
• Эти данные используются для разрешения/запрета входа и записываются только в собственный журнал доступа сервера (по умолчанию хранится 5 дней). Они никуда больше не отправляются, и другие игроки их не видят.
• Открытый исходный код — ты можешь сам убедиться, что именно он делает.

🛡️ Честное примечание о безопасности

Как и любая клиентская проверка модов, HailWall не даёт абсолютной защиты: упорный пользователь всё равно сможет её обойти. HMAC + challenge останавливают обычный спуфинг, но не эксперта. Против обычных игроков работает отлично, и лучше всего использовать вместе с online-mode=true. Воспринимай это как один надёжный слой, а не как серебряную пулю.