NLauncher Server Sync
No reviews yet
Server Side API for NLaunchers Server Instances.
Forge is a popular mod loader for versions 1.1+ of Minecraft.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Quilt is a fork of the Fabric mod loader. Many Fabric mods are compatible with Quilt and vice versa.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
NLauncher Server Sync
Automatically sync your modpack to every player — no external hosting, no manual downloads.
NLauncher Server Sync is a server-side only mod that pairs with the NLauncher Minecraft launcher. Install it on your server and your players will automatically receive every mod and config update the moment they launch the game.
How It Works
- Server owner installs this mod on the server
- Players add the server address in NLauncher ("Add Server Instance")
- NLauncher connects to the mod's built-in sync API, previews the server info, and creates a matching instance
- Every time a player launches, NLauncher checks for updates and syncs mods/configs automatically
No FTP. No Dropbox links. No "hey everyone, re-download the pack." Just update your server and players stay in sync.
Features
Automatic Mod & Config Syncing
The mod scans your server's mods/ folder and configured config files, builds a manifest with SHA-256 hashes, and serves it to players via a lightweight built-in HTTP server. Players only download what's changed.
Minecraft Account Authorization
If the whitelist is on, only players who are whitelisted can sync. If off, only players not banned on the server can sync. Auth uses the player's Minecraft UUID — no extra accounts or tokens needed.
Client Mod Policies
Control what extra mods your players can use:
| Policy | Behavior |
|---|---|
| Open | Players can add any client-side mods they want |
| Allowlist | Players can add mods that match your approved patterns (e.g., journeymap-*, sodium-*) |
| Strict | Only server mods allowed — extras get removed on sync |
⚙️ Fully Configurable
All settings are in config/nlauncher-sync.toml:
- Server display name shown to players in the launcher
- Sync port (default
25580) - Config file patterns — choose exactly which configs to push (supports globs)
- Excluded mods — skip server-only mods from syncing
- Client mod policy & allowlist
🔧 Server Commands
/nlsync reload— Re-scan mods and configs and rebuild the manifest (e.g., after adding a new mod)/nlsync status— Show sync server status, mod count, config count, and policy
Quick Start
For Server Owners
- Drop the mod JAR into your server's
mods/folder - Start the server — a default
config/nlauncher-sync.tomlwill be generated - Edit the config to set your server name, config sync patterns, and client mod policy
- Open port
25580(or your configured port) in your firewall / hosting panel - Tell your players to add your server in NLauncher — done!
For Players
- Open NLauncher and go to Add Server Instance
- Enter the server address (e.g.,
play.example.com) - Set the Join Port (default
25565) and Sync Port (default25580) if your server uses non-standard ports - Click Connect — NLauncher will preview the server info (name, version, mod count)
- Confirm to create the instance — mods and configs are downloaded automatically
- Launch and play! Every future launch will sync any updates before starting the game
Example Config
[server]
name = "My Awesome Server"
port = 25580
[sync]
configs = [
"config/jei-common.toml",
"config/create/*.toml",
"config/sophisticatedbackpacks-common.toml"
]
exclude_mods = [
"nlauncher_sync-*.jar"
]
[client_mods]
policy = "allowlist"
allowed = [
"journeymap-*",
"xaeros-minimap-*",
"xaeros-worldmap-*",
"optifine-*",
"sodium-*",
"iris-*"
]Requirements
- Minecraft 1.16.5+(Currently only 1.20.1 and 1.21.11 supported, but 1.16.5+ is planned)
- Mod Loader: NeoForge, Forge, Fabric, or Quilt
- NLauncher v0.5.0+ on the player's side
- Port
25580(or configured port) must be accessible to players
FAQ
Does this mod do anything on the client? No. This is a server-side only mod. Players don't install it — they use NLauncher, which handles syncing automatically.
Do I need to host files somewhere? No. The mod serves files directly from your server. No external hosting, CDN, or third-party services required.
What happens if the sync server is unreachable? NLauncher will warn the player but still allow them to launch with whatever they last synced. No one gets locked out.
Can players still add client-side mods like minimaps or shaders?
Yes! Set your client mod policy to open or allowlist to let players add approved client-side mods alongside the server pack.
Does it sync resource packs or shader packs? No. Minecraft already handles server resource packs natively, and shader packs are personal preference.
Is this secure? The mod only serves files to players who are whitelisted or have joined your server before, verified by Minecraft UUID. Modpack files are not sensitive data, so UUID-based auth is appropriate for this use case.
NLauncher Server Sync
Automatically sync your modpack to every player — no external hosting, no manual downloads.
NLauncher Server Sync is a server-side only mod that pairs with the NLauncher Minecraft launcher. Install it on your server and your players will automatically receive every mod and config update the moment they launch the game.
How It Works
- Server owner installs this mod on the server
- Players add the server address in NLauncher ("Add Server Instance")
- NLauncher connects to the mod's built-in sync API, previews the server info, and creates a matching instance
- Every time a player launches, NLauncher checks for updates and syncs mods/configs automatically
No FTP. No Dropbox links. No "hey everyone, re-download the pack." Just update your server and players stay in sync.
Features
Automatic Mod & Config Syncing
The mod scans your server's mods/ folder and configured config files, builds a manifest with SHA-256 hashes, and serves it to players via a lightweight built-in HTTP server. Players only download what's changed.
Minecraft Account Authorization
If the whitelist is on, only players who are whitelisted can sync. If off, only players not banned on the server can sync. Auth uses the player's Minecraft UUID — no extra accounts or tokens needed.
Client Mod Policies
Control what extra mods your players can use:
| Policy | Behavior |
|---|---|
| Open | Players can add any client-side mods they want |
| Allowlist | Players can add mods that match your approved patterns (e.g., journeymap-*, sodium-*) |
| Strict | Only server mods allowed — extras get removed on sync |
⚙️ Fully Configurable
All settings are in config/nlauncher-sync.toml:
- Server display name shown to players in the launcher
- Sync port (default
25580) - Config file patterns — choose exactly which configs to push (supports globs)
- Excluded mods — skip server-only mods from syncing
- Client mod policy & allowlist
🔧 Server Commands
/nlsync reload— Re-scan mods and configs and rebuild the manifest (e.g., after adding a new mod)/nlsync status— Show sync server status, mod count, config count, and policy
Quick Start
For Server Owners
- Drop the mod JAR into your server's
mods/folder - Start the server — a default
config/nlauncher-sync.tomlwill be generated - Edit the config to set your server name, config sync patterns, and client mod policy
- Open port
25580(or your configured port) in your firewall / hosting panel - Tell your players to add your server in NLauncher — done!
For Players
- Open NLauncher and go to Add Server Instance
- Enter the server address (e.g.,
play.example.com) - Set the Join Port (default
25565) and Sync Port (default25580) if your server uses non-standard ports - Click Connect — NLauncher will preview the server info (name, version, mod count)
- Confirm to create the instance — mods and configs are downloaded automatically
- Launch and play! Every future launch will sync any updates before starting the game
Example Config
[server]
name = "My Awesome Server"
port = 25580
[sync]
configs = [
"config/jei-common.toml",
"config/create/*.toml",
"config/sophisticatedbackpacks-common.toml"
]
exclude_mods = [
"nlauncher_sync-*.jar"
]
[client_mods]
policy = "allowlist"
allowed = [
"journeymap-*",
"xaeros-minimap-*",
"xaeros-worldmap-*",
"optifine-*",
"sodium-*",
"iris-*"
]
Requirements
- Minecraft 1.16.5+(Currently only 1.20.1 and 1.21.11 supported, but 1.16.5+ is planned)
- Mod Loader: NeoForge, Forge, Fabric, or Quilt
- NLauncher v0.5.0+ on the player's side
- Port
25580(or configured port) must be accessible to players
FAQ
Does this mod do anything on the client? No. This is a server-side only mod. Players don't install it — they use NLauncher, which handles syncing automatically.
Do I need to host files somewhere? No. The mod serves files directly from your server. No external hosting, CDN, or third-party services required.
What happens if the sync server is unreachable? NLauncher will warn the player but still allow them to launch with whatever they last synced. No one gets locked out.
Can players still add client-side mods like minimaps or shaders?
Yes! Set your client mod policy to open or allowlist to let players add approved client-side mods alongside the server pack.
Does it sync resource packs or shader packs? No. Minecraft already handles server resource packs natively, and shader packs are personal preference.
Is this secure? The mod only serves files to players who are whitelisted or have joined your server before, verified by Minecraft UUID. Modpack files are not sensitive data, so UUID-based auth is appropriate for this use case.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources