MSU

Безопасный процесс проверка → staging → применение

MSU не заменяет работающие jar'ы модов, пока сервер Minecraft запущен.

Вместо этого используется трёхшаговый процесс:

1. Проверка — запрос к Modrinth и осмотр настроенного источника.
2. Staging — скачивание или подготовка файлов замены в .minecraft-server-updater/.
3. Применение — при следующем запуске wrapper'а файлы из staging устанавливаются до старта Fabric или Forge.

Так обновления остаются предсказуемыми и не трогают jar'ы, которые сервер использует прямо сейчас.

Проверки обновлений модов

MSU проверяет, есть ли у настроенных модов более новые совместимые сборки для той версии Minecraft, на которой сервер работает сейчас.

Поддерживаемые источники модов:

Записи в mod-list разрешаются только по прямому id/slug проекта Modrinth или по точному результату поиска — MSU не угадывает по неоднозначным именам.

Обслуживание сервера

MSU может проверять и готовить серверное обслуживание для текущей версии Minecraft.

• Fabric: Fabric Loader и fabric-server-launch.jar, когда включено. Fabric API для запущенной версии обрабатывается проверками/staging модов. Ванильный server.jar меняется только при смене версии Minecraft.
• Forge: последний Forge для запущенной версии Minecraft (shim, сгенерированный установщиком, run.bat / run.sh и libraries/…/win_args.txt или unix_args.txt). Ванильный jar лежит в `libraries/net/minecraft/server//, а не как корневой server.jar`.

Обновления Minecraft

Когда включён server-upgrade, MSU может проверять готовность к:

• Последнему релизу Minecraft
• Конкретной целевой версии Minecraft

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

• Jar сервера Minecraft (корневой server.jar на Fabric или библиотечный jar Forge для этой версии)
• Лаунчер / loader Fabric или вывод установщика Forge для целевой версии
• Fabric API для целевой версии на Fabric (показывается среди кандидатов обновления сервера, а не как обычное обновление из mod-list)
• Опциональный preflight модов для цели обновления, когда включён
• Совместимый с целью jar MSU, когда версия Minecraft меняется (файлы MSU для Fabric и Forge публикуются отдельно)

Самообновление

MSU может проверить, доступна ли на Modrinth более новая сборка MSU, и подготовить собственную замену к следующему перезапуску. При обновлении сервера до новой версии Minecraft может потребоваться подготовить вместе с ним совместимую с целевой версией сборку MSU. Используй файл Fabric на Fabric и файл Forge на Forge.

Совмещённая подготовка

/msu stage all может объединить безопасные выбранные цели в один план подготовки к перезапуску, позволяя применить обслуживание сервера, обновления модов, самообновления и совместимые обновления Minecraft за один перезапуск с одной резервной копией.

Если обновление сервера настроено, но небезопасно для подготовки, совмещённая подготовка останавливается на нём и не подготавливает другие цели, пока не будет решён вопрос с предварительной проверкой сервера.

MSU сообщает о безопасности отдельными строками, чтобы ты видел, разрешена ли подготовка и почему нет.

Строки о безопасности подготовки

Две версии Minecraft в одном check all

/msu check all может показать обе:

• check server — использует целевую версию обновления (например, 26.2), когда обновление включено
• check mods — использует запущенную версию (например, 26.1.2)

Это сделано намеренно, но легко понять неправильно. Пример:

• Раздел сервера: Fabric API [missing → 0.152.1+26.2] означает, что обновление сервера установит Fabric API для целевой версии — а не то, что твоя проверка модов нашла обычное обновление мода.
• На Forge раздел сервера указывает Minecraft / Forge (например, 26.2 / 65.1.3) вместо Fabric Loader / Fabric API.
• Раздел модов: 0 updates available означает, что ничего не нужно подготавливать на версии, которую ты запускаешь сейчас, даже если запланировано обновление.

Что блокирует stage all

Совмещённая подготовка соблюдает безопасность по порядку:

1. Если доступно обновление сервера, но Server safe to stage: false, stage all останавливается и не подготавливает моды или самообновление, пока не пройдёт предварительная проверка сервера.
2. Моды включаются, когда это безопасно для совмещённого плана — в том числе в некоторых случаях обновления, когда у модов нет обновлений на запущенной версии, но они всё ещё готовы к целевой.
3. Самообновление подготавливается только когда это безопасно и ещё не выполнено как часть обязательной замены MSU при обновлении сервера.

Используй /msu status после подготовки, чтобы увидеть совмещённый план до перезапуска.

MSU построен вокруг настроенного источника обновлений.

mod-list

Лучше всего подходит для серверов, где ты хочешь поддерживать в актуальном состоянии выбранный список проектов Modrinth.

Файл по умолчанию: .minecraft-server-updater/mod-list (один проект на строку; не массив JSON).

Пример:

fabric-api
lithium
c2me-fabric

На Forge перечисляй проекты Modrinth для загрузчика Forge так же (один slug, id или точное название на строку).

MSU находит эти проекты через Modrinth и проверяет совместимые сборки для запущенной версии Minecraft.

mods-folder

Лучше всего подходит для серверов, которые держат справочную папку с проверенными jar-файлами.

Папка по умолчанию: .minecraft-server-updater/mods-folder.

MSU читает эталонные jar-файлы, по возможности определяет проекты Modrinth и управляет обновлениями из этого набора.

mrpack

Лучше всего подходит для серверов на основе модпака Modrinth.

MSU может управлять проектами из файла .mrpack или по URL модпака Modrinth.

advanced.mrpackMode управляет поведением:

MSU спроектирован так, чтобы избегать рискованной замены на живую.

Он не подменяет запущенные jar-файлы на ходу

Сервер продолжает использовать текущие загруженные файлы до перезапуска.

Подготовленные обновления хранятся отдельно

Загрузки и файлы для замены сначала готовятся в staging-области MSU.

Обёртка применяет обновления до запуска

Когда сервер запускается через обёртку, MSU применяет подготовленный план до старта Fabric или Forge. Без --wrap (Fabric) или --wrap-forge (Forge) вы всё ещё можете проверять и готовить, но при перезапуске ничего не применится.

Поддержка отката

Когда подготовленный план применяется, MSU может записать метаданные резервной копии. Если проверка запуска не проходит, поддержка отката помогает восстановить предыдущие рабочие файлы.

Неизвестные/кастомные jar-файлы обрабатываются осторожно

Неизвестные jar-файлы могут быть показаны и удержаны согласно политике по локальному имени файла, но MSU не считает их управляемыми через Modrinth или проверенными на совместимость, если их не удаётся распознать.

Предварительная проверка обновления сервера

Когда включено, MSU проверяет, что управляемые моды (и необходимые зависимости) выглядят совместимыми с целевой версией Minecraft, прежде чем разрешить подготовку обновления сервера. На Fabric Fabric API для целевой версии обрабатывается как часть пути обновления сервера, когда это необходимо.

Деструктивное удаление неуправляемых модов

Когда включено для источников mod-list или mrpack, подготовка может показать неуправляемые .jar-файлы, которые будут удалены при применении. Применение блокируется, пока advanced.allowRemoveUnmanagedMods не станет true и на активном подготовленном плане не будет выполнена команда /msu stage confirm-destructive true.

Восстановление после запуска и карантин

После неудачного запуска автоматизация и ручная подготовка блокируются до /msu boot clear-failure. Если недействительный подготовленный план помещён в карантин во время применения, подтвердите его через /msu quarantine acknowledge перед следующей подготовкой.

Корень команд по умолчанию:

/msu

Все команды /msu требуют прав оператора/администратора.

Дерево команд

/msu
├── status
├── reload
├── check
│   ├── mods | server | self | all
├── stage
│   ├── mods | server | self | all
│   ├── confirm-destructive true | false
│   └── cancel
├── rollback [backupId]
├── boot
│   ├── clear-failure
│   └── force-retry
│       ├── current
│       └── <fingerprintId>
├── quarantine
│   ├── acknowledge
│   └── delete confirm
└── config
    ├── reset [param]
    └── set
        ├── source <type> [path]
        ├── automation <mode> [targets]
        ├── interval <minutes>
        ├── debug <on|off>
        ├── server-maintenance <on|off>
        ├── server-upgrade <token>
        ├── mrpack-mode <exact|tracking>
        ├── release-channel <channel> [mod]
        ├── held <on|off> <mod>
        └── required <on|off> <mod>

Краткая справка

Долгие проверки могут писать в лог сервера; в RCON вы можете увидеть уведомление в фоне — полный вывод смотрите в logs/latest.log.

MSU умеет запускать фоновые проверки по таймеру.

Режимы автоматизации:

Цели автоматизации:

Пример:

/msu config set automation stage server mods self
/msu config set interval 360

Используйте install только если сервер запускается через обёртку (--wrap или --wrap-forge) и вы готовы к тому, что MSU остановит сервер для установки при перезапуске.

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

1. Положите подходящий jar MSU в mods/. Fabric: `minecraft-server-updater+fabric-.jar. Forge: minecraft-server-updater+forge-.jar`. Не смешивайте оба jar на одном сервере. Текущие имена не содержат версию Minecraft; список поддерживаемых версий игры смотрите в файле на Modrinth.
2. Настройте источник обновлений.
3. Запустите проверку.
4. Подготовьте доступные обновления.
5. Запускайте из корня сервера с обёрткой для вашего загрузчика (замените стандартный run.bat / run.sh на Forge).

Обёртка для Fabric

Запускайте из каталога, где лежит fabric-server-launch.jar. Эти скрипты выбирают первый mods/minecraft-server-updater+fabric-*.jar (или mods/minecraft-server-updater.jar).

start.bat (Windows):

@echo off

REM set ram requirements here:
set MC_XMX=2G
set MC_XMS=2G

cd /d "%~dp0"
for %%F in ("mods\minecraft-server-updater+fabric-*.jar" "mods\minecraft-server-updater.jar") do (
  java -jar "%%F" --wrap -- java -Xmx%MC_XMX% -Xms%MC_XMS% -jar fabric-server-launch.jar --nogui
  goto :after
)
echo No Minecraft Server Updater jar found in mods\
pause
exit /b 1
:after

start.sh (Linux):

#!/usr/bin/env sh

# set ram requirements here
MC_XMX="${MC_XMX:-2G}"
MC_XMS="${MC_XMS:-2G}"

cd "$(dirname "$0")" || exit 1
for jar in mods/minecraft-server-updater+fabric-*.jar mods/minecraft-server-updater.jar; do
  if [ -f "$jar" ]; then
    exec java -jar "$jar" --wrap -- java -Xmx"$MC_XMX" -Xms"$MC_XMS" -jar fabric-server-launch.jar --nogui
  fi
done
echo "No Minecraft Server Updater jar found in mods/"
exit 1

В Linux: chmod +x start.sh, затем ./start.sh.

Обёртка для Forge

Forge не использует --wrap -- java -jar …. --wrap-forge находит установленную координату в `libraries/net/minecraftforge/forge/-/и запускает так же, как стандартныйrun.bat`:

java @user_jvm_args.txt @libraries/net/minecraftforge/forge/<mc>-<forge>/win_args.txt --nogui

Пропишите RAM и другие флаги JVM в user_jvm_args.txt. Дополнительные аргументы после --wrap-forge (обычно --nogui) — это программные аргументы Minecraft. Не запускайте java -jar forge-*-shim.jar сами; оставшиеся jar установщика/шима в корне сервера — не то, что запускает обёртка.

start.bat (Windows):

@echo off
cd /d "%~dp0"
for %%F in ("mods\minecraft-server-updater+forge-*.jar" "mods\minecraft-server-updater.jar") do (
  java -jar "%%F" --wrap-forge --nogui
  goto :after
)
echo No Minecraft Server Updater jar found in mods\
pause
exit /b 1
:after

start.sh (Linux):

#!/usr/bin/env sh
cd "$(dirname "$0")" || exit 1
for jar in mods/minecraft-server-updater+forge-*.jar mods/minecraft-server-updater.jar; do
  if [ -f "$jar" ]; then
    exec java -jar "$jar" --wrap-forge --nogui
  fi
done
echo "No Minecraft Server Updater jar found in mods/"
exit 1

После обновления Forge Minecraft/Forge обёртка находит новый win_args.txt / unix_args.txt при следующем запуске, так что запуск не остаётся привязанным к прежним координатам.

Пример ручного обновления

/msu check mods
/msu stage mods
/msu status

Затем перезапустите через обёртку (start.bat, ./start.sh или строку java -jar mods/minecraft-server-updater+…jar … выше).

Пример обновления Minecraft

/msu config set server-upgrade latest
/msu check server
/msu stage all
/msu status

Прочитайте Server safe to stage перед подготовкой — если там false, устраните указанную причину (часто это публикация/установка совместимой с целевой версией сборки MSU на Modrinth) перед stage all.

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

config/minecraft-server-updater.json

Пример структуры:

{
  "debug": false,
  "mods": {
    "sourceType": "mod-list",
    "sourcePath": ".minecraft-server-updater/mod-list",
    "releaseChannel": "any"
  },
  "server": {
    "maintenance": true,
    "upgrade": "off"
  },
  "selfUpdate": {
    "enabled": true
  },
  "automation": {
    "mode": "disabled",
    "intervalMinutes": 360,
    "targets": []
  },
  "advanced": {
    "unknownModPolicy": "error",
    "modUpgradePolicy": "warn",
    "readinessMode": "all",
    "mrpackMode": "exact",
    "preflightBeforeServerUpgrade": true
  }
}

Частые команды конфигурации:

/msu config set source mod-list
/msu config set source mods-folder
/msu config set source mrpack modpack.mrpack
/msu config set server-maintenance on
/msu config set server-upgrade latest
/msu config set automation stage server mods self
/msu config set mrpack-mode exact
/msu config set debug on

Если режим автоматизации — check, stage или install, но targets пуст, автоматизация работает вхолостую, пока вы не добавите цели.

MSU поддерживает стилизованный вывод для своих строк серверного лога.

Продвинутая конфигурация:

"betterFabricConsoleFormatting": "auto"

Доступные значения:

Если Better Fabric Console установлен отдельно на Fabric, MSU избегает двойного рендеринга и позволяет BFC обрабатывать форматирование Minecraft. Forge использует встроенный конвертер MSU. Обёрнутые серверы сохраняют цвет, когда обёртка задаёт -Dterminal.ansi=true.

MSU намеренно консервативен.

Он не:

• Заменяет работающие jar-файлы, пока сервер запущен
• Считает неизвестные/кастомные jar-файлы проектами под управлением Modrinth
• Применяет подготовленные обновления без обёртки (--wrap или --wrap-forge)
• Волшебным образом проверяет совместимость для файлов не с Modrinth
• Использует нечёткий поиск Modrinth для определения настроенных названий проектов
• Смешивает «рутинные обновления модов на текущей версии» с «подготовкой обновления сервера» в одной проверке — читайте разделы сервера и модов отдельно
• Запускает Fabric MSU jar на Forge или Forge MSU jar на Fabric