NexusSync

⚡ NexusSync

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

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

• 🔄 Авто-синхронизация модов: Сверяет локальные моды клиента с манифестом сервера и автоматически скачивает недостающие или устаревшие моды напрямую с Modrinth CDN, CurseForge, Google Drive или по прямым ссылкам.
• 📦 Поддержка опциональных модов: Позволяет владельцам серверов указывать клиентские опциональные моды (например, оптимизацию, визуальные эффекты, мини-карты). Галочки по умолчанию сняты, так что игроки скачивают только то, что выберут сами.
• 🧹 Автоматическая очистка: Безопасно находит и удаляет старые или удалённые версии модов на клиенте, предотвращая крэши из-за дубликатов.
• 🛡️ Серверный блэклист: Администраторы сервера могут настроить запрещённые чит-моды и ресурспаки в blacklist.json. Правила передаются напрямую с сервера для защиты его целостности.
• ⚡ Без сторонних лаунчеров: Всё работает прямо в стандартном Minecraft без сторонних обновлятелей модпаков или настроек лаунчера.
• 🔄 Перезагрузка на лету: Команда /nexussync reload на сервере позволяет мгновенно пересканировать моды, обновить манифест и обновить MOTD без перезапуска сервера.

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

Для игроков

1. Добавьте сервер в список серверов для игры по сети.
2. Нажмите Присоединиться или кнопку Синхронизация рядом с сервером.
3. Если моды нужно обновить, проверьте экран подтверждения и нажмите Скачать и перезапустить.
4. После завершения игра будет полностью обновлена и готова к игре!

Для администраторов серверов

1. Установите NexusSync в папку mods вашего сервера.
2. Запустите сервер. NexusSync автоматически просканирует ваши моды, определит ссылки для скачивания через API Modrinth/CurseForge и создаст mods/nexussync/config.json.
3. (Необязательно) Отредактируйте config.json, чтобы настроить опциональные моды, серверные моды или собственные ссылки для скачивания.
4. Выполните /nexussync reload в игре или в консоли сервера, чтобы применить изменения мгновенно.

⚙️ Конфигурация и команды

• mods/nexussync/config.json — Конфиг манифеста сервера, разделяющий обязательные, опциональные и серверные моды.
• mods/nexussync/blacklist.json — Серверный античит-блэклист для блокировки запрещённых модов и X-Ray ресурспаков.
• /nexussync reload (уровень прав 2) — Пересканирует моды сервера, обновляет манифест, перезагружает блэклист и динамически обновляет статус сервера.

🔒 Сеть и конфиденциальность

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

• Обращается к API Modrinth (api.modrinth.com) для определения достоверных ссылок для скачивания по хэшу SHA-1.
• Обращается к ссылкам CurseForge / прямым URL / Google Drive, явно указанным в config.json администратора сервера.
• Не собирает, не отслеживает и не передаёт никакие личные данные игроков или телеметрию.

📋 Требования

• Minecraft: 1.21.1
• Загрузчик модов: NeoForge (21.1.x+)
• Java: Java 21