Sync Client Server (SCS)

Sync Client Server (SCS)

Sync Client Server (SCS) — мод, который синхронизирует клиентские моды и конфиги с модпаком, предоставляемым сервером, уменьшая несовпадения версий и ручное управление модами.

С помощью одной кнопки обновления прямо в игре, в списке серверов, игроки могут скачать нужные серверу моды и конфиги просто и надёжно.

📸 Превью

🎯 Цель

SCS упрощает администрирование сервера и улучшает опыт игроков, делая обновления модпака понятными, предсказуемыми и удобными, без сторонних лаунчеров и ручного управления файлами.

✨ Что умеет SCS

• Кнопка обновления прямо в игре, в списке серверов
• Экран подтверждения со сводкой обновления и опцией Очистить кэш
• Синхронизация по modId, чтобы избежать дублирующихся или устаревших модов
• Опциональная синхронизация /config вместе с /mods
• Опциональный режим зеркала для /mods и /config
• Принудительное удаление сервером определённых клиентских модов
• Изолированный кэш для каждого сервера
• Встроенный лёгкий файловый сервер для раздачи mods.zip и config.zip

⚠️ Важно:

• Обновления модов требуют перезапуска игры, чтобы вступить в силу
• Обновления конфигов НЕ требуют перезапуска и применяются сразу

🎮 Использование на клиенте (просто и автоматически)

Клиентский процесс намеренно минимален.

1️⃣ Добавьте сервер

• Добавьте сервер как обычно в меню Сетевая игра
• Поле Download URL заполняется автоматически по адресу и порту сервера
• При необходимости можно указать вручную

Пример:

http://myserver.com:25566

2️⃣ Обновите клиент

1. Выберите сервер в списке
2. Нажмите Обновить
3. Проверьте сводку и подтвердите

Вот и всё.
Перезапускайте игру, только если обновлялись моды.

🧹 Очистка кэша

Используйте Очистить кэш на экране подтверждения, если:

• Загрузка не удалась
• Клиент рассинхронизировался
• Содержимое ZIP изменилось, но обновление не запускается
• Возникли другие неожиданные проблемы

Кэш изолирован для каждого сервера, и его можно безопасно очищать.

🖥️ Использование на сервере (руководство администратора)

1️⃣ Установка и запуск

• Установите SCS на сервер
• Запустите сервер один раз, чтобы сгенерировался файл конфигурации

2️⃣ Общая конфигурация

Файл конфигурации:

config/scs-common.toml

Значения по умолчанию:

fileServerPort = 25566
updateConfig = true
mirrorMods = false
mirrorConfig = false

Пояснение:

• fileServerPort
  Порт, используемый встроенным файловым сервером (по умолчанию: 25566)
• updateConfig
  Включает обновление клиентских конфигов (включено по умолчанию)
• mirrorMods / mirrorConfig
  Отключены по умолчанию. При включении клиентские папки приводятся в точное соответствие с ZIP-файлами

Поскольку updateConfig включён по умолчанию, администраторы серверов могут рассылать клиентам новые изменения конфигурации, например включать или отключать опции зеркала.

3️⃣ Создание пакетов обновления

Вариант A: через игровые команды

На сервере выполните:

/scs save-mods
/scs save-config

Это создаст:

• mods.zip
• config.zip

Вариант B: ручное создание ZIP (продвинутый / рекомендуется для контроля)

Администраторы могут вручную создавать или редактировать:

• mods.zip
• config.zip

Это позволяет:

• Отправлять только определённые моды или конфиги
• Полностью контролировать содержимое обновления

Оба способа полностью поддерживаются.

4️⃣ Удаление клиентских модов (принудительно сервером)

Чтобы принудительно удалить определённые клиентские моды:

1. Создайте файл с именем:

modsToRemoveFromTheClient.json

2. Поместите его внутрь mods.zip
3. Перечислите имена .jar-файлов для удаления

[
  "examplemod1.jar",
  "examplemod2.jar"
]

Эти моды будут удалены с клиента во время обновления.

5️⃣ Встроенный файловый сервер

Когда сервер запущен, SCS автоматически раздаёт:

• mods.zip
• config.zip

На:

<server-ip>:fileServerPort

По умолчанию:

<server-ip>:25566

Внешний веб-сервер не требуется.

📦 Использование в модпаке

Можете смело включать этот мод в свой модпак — указание авторства приветствуется, но не обязательно.

❤️ Благодарности и примечание о форке

Этот проект — форк мода MMMMM от Place-Boy.
Оригинальный проект: https://www.curseforge.com/minecraft/mc-mods/mmmmm

Все заслуги за оригинальную концепцию и основу принадлежат оригинальному автору.