MineBackup

⚠️ Важно: это дополнение!

Обратите внимание: этот мод — дополнительный компонент для десктопного приложения MineBackup или FolderRewind и не работает самостоятельно. Сначала нужно скачать и запустить основное приложение, чтобы мод заработал.

Кроме того, для корректного межпроцессного взаимодействия на компьютере должен быть установлен сервер KnotLink. https://github.com/KnotLink-Protocol/KnotLinkService/releases

✅ Поддержка выделенных серверов

MineBackup теперь поддерживает горячее восстановление на выделенных серверах, а не только в одиночной игре/LAN. Когда вы запускаете /mb restore на выделенном сервере, мод безопасно сохраняет мир, передаёт управление встроенному sidecar для перезапуска и перезапускает сервер через ваш собственный стартовый скрипт после завершения восстановления. Подробности настройки см. в разделе Восстановление на выделенном сервере ниже.

Если вы используете сервер Spigot/Paper, воспользуйтесь MineBackupPlugin, который обеспечивает тот же процесс восстановления для семейства Bukkit.

➡️ Скачать НЕОБХОДИМОЕ десктопное приложение MineBackup можно здесь

Пользователям Windows мы рекомендуем FolderRewind с плагином MineRewind вместо отдельного десктопного приложения MineBackup.

Что это такое?

Этот лёгкий мод — мост между десктопным приложением MineBackup (или FolderRewind) и самим Minecraft. Он позволяет управлять сохранениями, запускать восстановление и следить за статусом резервных копий, не выходя из игры.

✨ Этот мод предоставляет:

• Богатые внутриигровые команды: используйте серию команд /mb для управления сохранениями мира прямо из чата — создание резервных копий, восстановление, просмотр истории и планирование автоматических бэкапов.
• Интерактивный браузер резервных копий: /mb list backups current листает резервные копии текущего мира прямо в чате, показывая метки времени и комментарии (автоматически разбираемые из стандартных имён файлов бэкапов) с кликабельной кнопкой [Restore] рядом с каждой записью.
• Отсчёт безопасности перед восстановлением: прежде чем восстановление действительно начнётся, MineBackup может отсчитать настраиваемое количество секунд. Используйте /mb stop для отмены или /mb confirm, чтобы пропустить отсчёт и восстановить немедленно.
• Полная поддержка выделенных серверов: создание резервных копий, восстановление и просмотр работают на выделенном сервере так же, как и в одиночной игре, координируясь через встроенный sidecar для перезапуска (см. ниже).
• Уведомления о резервных копиях в реальном времени: получайте сообщения от основного приложения прямо в игровом чате — началось ли создание бэкапа, завершилось успешно или с ошибкой.
• Бесшовная поддержка живого резервного копирования: когда основному приложению нужно выполнить «живое резервное копирование» (то есть во время работы игры), этот мод автоматически запускает в фоне безопасное полное сохранение мира (эквивалент /save-all), гарантируя, что бэкап всегда захватывает последний прогресс.
• Восстановление по запросу из FolderRewind: если вы выбираете резервную копию через собственный интерфейс FolderRewind, он может напрямую сигнализировать этому моду запустить тот же процесс горячего восстановления в игре, так что оба способа управления остаются синхронизированными.

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

🚀 Руководство по установке

1. Скачайте основное приложение: Убедитесь, что вы скачали десктопное приложение MineBackup/FolderRewind по ссылке выше и что оно корректно запускается на вашей системе.
2. Скачайте плагин MineRewind: Если вы используете FolderRewind, настоятельно рекомендуется установить плагин MineRewind и создать конфигурацию типа Minecraft Saves вместо Default. Скачать плагин можно на GitHub Releases.
3. Скачайте и установите сервер KnotLink: Для межпроцессного взаимодействия установите сервер KnotLink на свой компьютер. Скачать его можно на GitHub Releases.
4. Включите службу KnotLink в основном приложении: В MineBackup она включена по умолчанию, а в FolderRewind — отключена. Если вы используете FolderRewind, включите её вручную в настройках.
5. Скачайте этот мод: Возьмите файл minebackup-x.x.x.jar, подходящий по версии вашему загрузчику и версии Minecraft, со страницы Releases или с другой площадки распространения модов.
6. Установите мод: Для одиночной игры или LAN положите скачанный .jar в папку mods клиента Minecraft. Для выделенных серверов установите его в папку mods сервера; установка на клиенте необязательна.
7. Запускайте одновременно: Запустите игру или сервер Minecraft. Чтобы мод работал, десктопное приложение MineBackup/FolderRewind должно быть запущено в фоне во время игры.
8. (Только для выделенных серверов) Убедитесь, что присутствует стартовый скрипт, чтобы восстановления могли автоматически перезапускать сервер — см. Восстановление на выделенном сервере.

📖 Справочник команд

Все команды требуют прав оператора/модератора на мультиплеере и выделенных серверах. В одиночном мире или мире, открытом по LAN, их может использовать только владелец мира — выдача OP не нужна. Большинство аргументов поддерживают автодополнение по Tab (ID конфигураций, папки, имена файлов резервных копий).

💡 Пример использования

Резервное копирование и восстановление мира, в котором вы сейчас играете:

1. Создайте резервную копию текущего мира

   • Введите /mb backup Перед боем с Ender Dragon

     В чате появится: [MineBackup] Backup task started... (Через мгновение) [MineBackup] Backup successful! Saved as [Full][2026-07-30_12-33-00]world [Перед боем с Ender Dragon].7z

2. Просмотрите и восстановите из этой резервной копии

   • Введите /mb list backups current, чтобы увидеть разбитый на страницы кликабельный список недавних резервных копий — или введите /mb restore сразу, чтобы восстановить последнюю.
   • Если настроен отсчёт до восстановления, используйте /mb confirm, чтобы восстановить немедленно, или /mb stop, чтобы отменить.

Управление другим миром (тем, который сейчас не запущен) через настройки десктопного приложения:

1. Найдите конфигурацию и папку

   • Введите /mb list configs, чтобы увидеть ваши профили конфигураций.
   • Введите /mb list folders <config_id>, чтобы увидеть папки в этом профиле.

2. Создайте резервную копию или восстановите эту папку

   • `/mb target backup <config_id> [comment]`
   • `/mb target restore <config_id> ""` (заключайте имена файлов с пробелами в кавычки; недоступно на выделенных серверах)

🛠️ Восстановление на выделенном сервере

Резервное копирование и просмотр работают на выделенных серверах точно так же. Однако восстановление требует остановки и перезапуска процесса Minecraft — MineBackup автоматизирует это с помощью встроенного restart sidecar:

1. При /mb restore сервер сохраняет все миры и передаёт владение процессом небольшому помощнику (sidecar), после чего безопасно завершает работу.
2. Sidecar ждёт завершения основной JVM и освобождения файлов мира, после чего позволяет FolderRewind/MineBackup выполнить восстановление.
3. Как только десктопное приложение сообщает об однозначном успехе, ошибке или отмене, sidecar запускает ваш настроенный стартовый скрипт ровно один раз и завершается.

Вам нужен стартовый скрипт в рабочей директории сервера. MineBackup ищет один из файлов start.bat, start.cmd, run.bat, run.cmd (Windows) или start.sh, run.sh (Linux/macOS); должен существовать ровно один, либо задайте явный путь через настройку dedicatedRestore.restartScript в config/minebackup.properties. Поскольку процесс сервера перезапускается, игроки отключаются во время восстановления и должны подключиться вручную, когда новый экземпляр сервера снова заработает.

Если вы используете панель или обёртку, которая автоматически перезапускает сервер в момент его завершения, отключите это поведение (или укажите её на скрипт, которым MineBackup тоже не управляет) — немедленный авто-перезапуск может помешать восстановлению и запустить сервер до того, как файлы мира будут готовы. Установите dedicatedRestore.mode=DISABLED, чтобы полностью отключить восстановление на выделенном сервере.

❓ Часто задаваемые вопросы

• В: Когда я использую команду, в чате пишет "Command failed", "No response" или похожую ошибку.

  • О: Пожалуйста, проверьте, что десктопное приложение MineBackup/FolderRewind запущено в фоне на вашем компьютере. Все функции этого мода зависят от сетевого взаимодействия с основным приложением.

• В: Можно ли использовать этот мод сам по себе?

  • О: Нет. Это "мост", и без основного приложения он ничего не может.

• В: Я восстановил на своём выделенном сервере, а сервер не запустился автоматически.

  • О: Проверьте, что в рабочей директории сервера есть стартовый скрипт (см. Восстановление на выделенном сервере). Если сам скрипт перезапуска не сработал, исправьте скрипт и запустите сервер вручную — MineBackup не будет молча повторять попытку.

📄 Лицензия

Этот проект распространяется под MIT License. Подробности смотрите в основном репозитории проекта.