Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minecraft ModSync 🚀

A lightweight, pure Java synchronization tool designed to keep Minecraft modpacks up to date across a group of players. It automatically mirrors the server's mod directory on the client's side, deleting extra mods and downloading missing or outdated ones.

Features

  • Zero Dependencies: Runs natively on pure Java. No external libraries are required.
  • Secure by Design: Built-in protection against directory traversal attacks (uses strict memory mapping).
  • Apt-like Progress Bar: Cool Linux-style terminal progress bar during downloads.
  • Fast Hash Checking: Uses efficient MD5 chunking to verify file integrity instantly.

🖥️ Server Setup (For the Host)

  1. Create a folder for your update server and place the ModSyncServer.jar inside it.
  2. In the same folder, create a configuration file named modsync.conf with the following content:
PORT=12345
MOD_DIR=C:/path/to/your/server/mods
  1. Open your terminal in that folder and run the server:
java -jar ModSyncServer.jar

🎮 Client Setup (For Players)

  1. Create a folder anywhere on your computer and place the ModSync.jar inside it.
  2. In the same folder, create a configuration file named modsync.conf with the following content:
SERVER_IP=SERVER_IP_HERE
PORT=12345
MOD_DIR=C:/Users/YOUR_USER/AppData/Roaming/.minecraft/mods

(Make sure to replace SERVER_IP_HERE with the host's IP address and fix the path to your .minecraft/mods folder if needed).

  1. Run the sync tool via the terminal:
java -jar ModSync.jar
  1. Once the progress bar reaches 100%, you are ready to open Minecraft and play!

About

A lightweight, pure Java synchronization tool to seamlessly update and mirror Minecraft modpacks between servers and clients.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages