ModSync

Minecraft Modpack Auto-Updater for private servers - Keep your mods in sync effortlessly!

Features

• One-Click Updates - Download and install modpacks instantly
• Auto-Detection - Automatically finds your Minecraft mods folder
• Multiple Sources - Support for Google Drive links or local zip files
• Cross-Platform - Works on Windows, macOS, and Linux
• Safe - Validates files and prevents data loss
• Fast - Efficient extraction with progress tracking

Download

Get the latest version from the Releases page:

• Windows: ModSync.exe (portable, no installation required)
• macOS: ModSync.dmg (drag to Applications)

Or download from GitHub Actions artifacts.

Usage

Google Drive Method

1. Launch ModSync
2. Paste your Google Drive share link
3. Click "Update from Google Drive"
4. Wait for download and installation to complete

Local File Method

1. Download your modpack zip file
2. Launch ModSync
3. Switch to "Local File" tab
4. Drag and drop your zip file or click to browse
5. Click "Update from Local File"

Supported Paths

• Windows: %APPDATA%\.minecraft\mods
• macOS: ~/Library/Application Support/minecraft/mods
• Linux: ~/.minecraft/mods

Can't find your mods folder? Use the "Browse" button to select it manually.

Development

Prerequisites

• Node.js 20+
• npm

Setup

git clone https://github.com/DizzyMii/modsync.git
cd modsync
npm install

Run Development Build

npm run dev

Build for Production

npm run build:win    # Windows
npm run build:mac    # macOS (requires macOS)
npm run build        # Both platforms

CI/CD

This project uses GitHub Actions to automatically build for both Windows and macOS on every push. Builds are available as artifacts in the Actions tab.

Security

• ✅ Validates ZIP file integrity before extraction
• ✅ Prevents zip-slip attacks
• ✅ Checks file locks before deletion
• ✅ No telemetry or data collection

Troubleshooting

Error	Solution
Minecraft folder not found	Ensure Minecraft is installed or use manual selection
Cannot update while Minecraft is running	Close Minecraft completely before updating
Google Drive download failed	Try the Local File method or check link permissions
macOS "App can't be opened"	Right-click → Open → Open anyway, or run xattr -cr /Applications/ModSync.app

License

MIT