Simple World Sync

🌍 Simple World Sync

Keep your Minecraft singleplayer worlds synchronized between your PC, Steam Deck, laptop, NAS, and other devices.

Simple World Sync is a client-side Fabric mod for Minecraft 1.21.1. It checks a synchronized world before launch, downloads a newer remote version when necessary, and uploads only changed files after you leave the world.

⚠️ Current storage support: Local Folder / NAS and Yandex Disk are available. Google Drive is currently in development.

---

✨ Features

🔄 Smart synchronization

• Automatic check before launch — download a newer remote version before entering the world.
• Automatic upload after exit — changes are uploaded after Save and Quit.
• Incremental transfers — only new, changed, and deleted files are processed.
• Clear progress — percentage, speed, ETA, current file, and change counters.
• Cloud world browser — view, download, and delete remote worlds.
• Write protection — lock files reduce the risk of simultaneous changes.
• English and Russian interface with Steam Deck friendly layouts.

☁️ Storage providers

• Local Folder / NAS: shared folders, mapped network drives, external drives, SMB/NFS, or Syncthing.
• Yandex Disk: authorization and synchronization through the official Yandex Disk API.
• Google Drive: 🚧 in development and currently unavailable.

---

⚙️ How it works

1. Choose a storage provider in the mod settings.
2. Open the Minecraft world settings and enable synchronization for the world.
3. Run the first synchronization to create the remote copy and manifest.
4. Before launch, the mod checks whether the remote world is newer.
5. After Save and Quit, the mod waits until the world is fully closed and uploads changes.
6. On another device, open Cloud Worlds and download the world.

📁 Local Folder / NAS

Choose a folder that is available to every device: a NAS share, mapped network drive, external drive, or a folder managed by Syncthing. Select Local Folder / NAS, choose the path, and press Use this storage. The mod automatically checks read and write access.

☁️ Yandex Disk

1. Select Yandex Disk in the storage settings.
2. Press Sign in to Yandex and complete authorization in the browser.
3. Return to Minecraft and press Use this storage.
4. Enable synchronization for the desired world.

Your world data is stored in your own Yandex Disk account. The mod never asks for your Yandex password.

☁️ Google Drive

🚧 In development. The option is shown as an unavailable placeholder and cannot currently be selected.

---

⚠️ Important

• Never open the same world on two devices at the same time.
• Wait for synchronization to finish before launching the world elsewhere.
• Make a manual backup before the first synchronization.
• Do not disconnect the NAS or internet connection during a transfer.
• The first upload of a large world may take some time.

📦 Requirements

• Minecraft 1.21.1
• Fabric Loader
• Fabric API
• Java 21

---

🇷🇺 Русский

Simple World Sync синхронизирует одиночные миры Minecraft между ПК, Steam Deck, ноутбуком, NAS и другими устройствами.

Это клиентский Fabric-мод для Minecraft 1.21.1. Он проверяет удалённую версию перед запуском мира, скачивает более свежие изменения и автоматически выгружает изменённые файлы после выхода.

⚠️ Поддерживаемые хранилища: локальная папка / NAS и Яндекс Диск. Google Drive пока находится в разработке.

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

• Проверка перед запуском и загрузка более свежей версии мира.
• Автовыгрузка после выхода через «Сохранить и выйти».
• Инкрементальная синхронизация только новых, изменённых и удалённых файлов.
• Подробный прогресс: процент, скорость, оставшееся время и текущий файл.
• Облачные миры: просмотр, скачивание и удаление удалённых копий.
• Защита lock-файлом от одновременной записи.
• Русский и английский интерфейс, адаптированный для Steam Deck.

⚙️ Начало работы

1. Выберите хранилище в настройках мода.
2. Откройте настройки нужного мира.
3. Нажмите Включить синхронизацию мира.
4. Выполните первую синхронизацию.
5. На другом устройстве откройте Облачные миры и скачайте мир.

📁 NAS / локальная папка

Укажите общую папку NAS, сетевой диск, внешний накопитель или папку Syncthing. Нажмите Использовать это хранилище — мод сам проверит чтение и запись.

☁️ Яндекс Диск

Выберите Яндекс Диск, нажмите Войти в Яндекс, подтвердите доступ в браузере и затем нажмите Использовать это хранилище. Миры сохраняются только в вашем аккаунте Яндекс Диска.

☁️ Google Drive

🚧 В разработке. Сейчас этот вариант отображается как недоступная заглушка.

⚠️ Важно

• Не открывайте один мир на двух устройствах одновременно.
• Дождитесь окончания синхронизации перед запуском мира на другом устройстве.
• Перед первой синхронизацией сделайте резервную копию.
• Не отключайте NAS или интернет во время передачи файлов.

---

💬 Feedback / Обратная связь

Bug reports, ideas, and feature requests:
github.com/Grovymon/simple-world-sync