SyncCurseCraft

Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.

Project overview

# SyncCurseCraft **Your players' mods folder, always matching the server's. No extra ports, no web server, no launcher.** You add a mod to your server. Your friends connect and get kicked for a mismatch, so you paste a download link in the chat, and someone installs the wrong version anyway. SyncCurseCraft removes that whole conversation: the server publishes its mod list, the client compares it against `/mods/`, and one button fixes the difference. *** ## Why it works where other tools don't Everything travels over the **normal Minecraft port**. There is no second HTTP server and no second port to open. That matters if you rent a server. Hosts like BisectHosting, Aternos or Shockbyte give you port 25565 and nothing else, which rules out every sync tool that expects to serve files over HTTP. SyncCurseCraft rides along with the Server List Ping — the same response your client already reads to show the MOTD and the player count. Your players see the mod list **before connecting**, without joining and without a login. The `.jar` files themselves come straight from the Moddrinth or CurseForge CDNs. Your server never uploads a single mod file, so a 400 MB pack costs it no bandwidth at all. *** ## For players 1. Start the game. There is a **Sync mods** button at the top left of the main menu and the server list. A green dot means the server's list changed. 2. Type the server address, press **Check server**. 3. Pick your profile: * **Low PC** — only the mods the server requires. * **High PC** — the required mods plus the client-side extras: shaders, minimap, ambient sound, whatever your admin put there. 4. **Sync now**, then **Quit to apply**. 5. Open the game again. Done. You always see the full list of what will be installed and what will be removed _before_ anything happens, and the list scrolls if it is long. ## For admins The server creates `config/synccursecraft/packs/` with two folders: ``` LowPC/ required mods, every player gets them HighPC/ the full High PC profile; anything here and not in LowPC becomes an optional client-side mod ``` Drop your `.jar` files in and restart, or run `/scc generate`. Each file is identified on CurseForge by fingerprint, and the manifest is written for you with mod id, hash, size and download URL. **Your files are never moved or deleted** — those folders are yours. ``` /scc generate rebuild the manifest from the pack folders /scc reload reload the manifest without restarting /scc status show what is being announced, plus any warnings ``` It also validates the pack for you. If a mod needs a dependency you forgot, the console says so at generation time instead of your players finding out by crashing. *** ## What it will never touch This is the rule the whole mod is built around, and it is not negotiable: **Only `.jar` files inside `/mods/`, and only the ones it installed itself.** Your `config/` folder, `options.txt`, keybinds, shader packs, resource packs, saves and any mod you installed yourself are all left completely alone. There is exactly one exception, and it is shown on screen before it happens: if you have a _different version_ of a mod the server requires, that one is removed — the game will not start with two versions of the same mod loaded. ## Security * Downloads are restricted to a **hard-coded allowlist**: Moddrinth or `.forgecdn.net` and No other host is reachable, whatever a manifest claims. * Every file is verified by **SHA-1 and byte size** before it is installed. A mismatch and it is discarded, leaving nothing behind. * File names are validated against path traversal. * Downloads land in a staging folder and are only moved into `/mods/` on the next restart, so a half-finished sync can never leave you with a broken game. * Your CurseForge API key stays on the server. It is deliberately **not** stored in a NeoForge server config, because those get synced to every client that connects. ## Performance Every download, hash and disk write runs off the render thread. The game does not freeze while it syncs. *** ## Installation **Client** — both jars in `.minecraft/mods`: | File |What it is | | -------------------------------------- |---------------------- | | synccursecraft-<version>.jar |the mod | | synccursecraft-bootstrap-<version>.jar |the early boot service | You need **both**. They ship separately because NeoForge will not let one jar be an early boot service and a mod at the same time — with the service inside the main jar, the mod does not load at all. If you install through the CurseForge app the second one comes along automatically as a dependency. Without the bootstrap jar the mod still runs, but it can only _add_ mods, never update or remove ones already loaded. The sync screen warns you if it is missing. **Server** — only `synccursecraft- .jar` in the server's `mods` folder. ## Requirements Minecraft 1.21.1 · NeoForge 21.1.x · Java 21 No other mods required. No external libraries, nothing shaded in. *** ## Known limits Some mods need another mod without declaring it anywhere — not in their metadata, not in the Moddrinth API. **Iris and Sodium** are the known case: if your pack uses Iris, add Sodium to your pack folders by hand. No autom

FreeMinecraftMods decision guide

This mod is most relevant to players looking for utility on neoforge. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.

The source record was updated on Aug 5, 2026. Check the changelog and file page to see whether that update applies to the version and loader you plan to use.

What to verify before choosing a file

• Confirm that the file is published by the credited creator on the linked official source.
• Match the Minecraft version exactly instead of relying only on a broad category label.
• Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
• Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
• Back up worlds and configuration files before testing the project in a long-term save or public server.

Compatibility at a glance

Minecraft versions in this snapshot: 1.21.1

Loaders and platforms: neoforge

Before you install

Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.

Source, licensing, and corrections

FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.

How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information