World Syncer is an advanced, automated Fabric mod for Minecraft 1.21.4 that seamlessly backs up and synchronizes your single-player world saves with your GitHub repositories. Play on your PC at home, leave the world, and instantly pick up exactly where you left off on your laptop or Steam Deck!
World Syncer es un mod avanzado y automatizado de Fabric para Minecraft 1.21.4 que realiza copias de seguridad y sincroniza tus mundos de un solo jugador con tus repositorios de GitHub. ¡Juega en tu PC de escritorio, sal del mundo y continúa exactamente donde lo dejaste en tu laptop o Steam Deck al instante!
- ⚡ Automated Backup (Auto-Push): Automatically stages, commits with timestamps, and pushes your world saves to GitHub whenever you leave a world. No manual copy-pasting or zip archiving required!
- 🔄 Instant Sync (Auto-Pull): Automatically checks for updates and pulls the latest save file from GitHub when you open the "Select World" screen. Play on multiple devices with 100% confidence!
- 🛠️ Auto-Provisioning: If a repository doesn't exist on your GitHub for a synced world, the mod will automatically call the GitHub API and provision a secure private repository for it on-the-fly!
- ⚙️ In-Game Configuration: Fully managed configuration screens integrated into ModMenu and powered by Cloth Config. Toggle sync for specific worlds and paste your API tokens securely.
- 🔒 Smart Exclusions (.gitignore): Automatically filters out temporary lock files (
session.lock), local log files (logs/), crash reports, and backup files (level.dat_old) to save cloud space and prevent merge conflicts.
Make sure you have the following installed in your mods folder:
- Fabric Loader (for Minecraft 1.21.4)
- Fabric API
- Cloth Config API
- ModMenu (highly recommended for config access!)
To allow the mod to securely connect and upload worlds to your GitHub account:
- Go to GitHub Settings > Developer Settings > Personal access tokens > Tokens (classic).
- Click Generate new token -> Generate new token (classic).
- Give it a description (e.g.
World Syncer Mod). - Check the
reposcope (this permits the mod to create repositories and push/pull your saves). - Generate and copy the token (starts with
ghp_).
- Launch Minecraft and click on the Mods button on the main menu.
- Find World Syncer and click the gear/configure icon.
- Paste your GitHub Personal Access Token (PAT) in the token field.
- Load your single-player world list, select a world, and toggle backing up ON in the configuration screen!
The mod automatically configures an internal .gitignore for your world folders to ignore the following:
session.lock(lock files preventing simultaneous world openings)logs/&crash-reports/(bulky local diagnostics)*.tmp& temporary archiveslevel.dat_old& player backup data (*.dat_old)
Created with ❤️ by elmatike. Feel free to fork, open issues, or contribute! Creado con ❤️ por elmatike. ¡Siéntete libre de clonarlo, reportar fallos o contribuir!