NLauncher Server Sync
自动将整合包同步给所有玩家——无需外部托管,无需手动下载。
NLauncher Server Sync 是一个仅服务端模组,与 NLauncher Minecraft 启动器配合使用。在服务器上安装它,玩家在游戏启动时将自动接收所有的模组和配置更新。
工作原理
- 服务器管理员在服务器上安装此模组
- 玩家在 NLauncher 中添加服务器地址(“添加服务器实例”)
- NLauncher 连接到模组内置的同步 API,预览服务器信息并创建匹配的实例
- 每次玩家启动游戏时,NLauncher 都会检查更新并自动同步模组/配置
无需 FTP。无需 Dropbox 链接。无需“嘿大家,重新下载整合包”。只需更新你的服务器,玩家即可保持同步。
功能
自动模组与配置同步
模组会扫描服务器 mods/ 文件夹中配置的配置文件,构建包含 SHA-256 哈希值的清单,并通过轻量级内置 HTTP 服务器提供给玩家。玩家仅下载发生更改的内容。
Minecraft 账户授权
如果开启了白名单,只有被加入白名单的玩家才能同步。 如果关闭了白名单,只有未被服务器封禁的玩家才能同步。 认证使用玩家的 Minecraft UUID —— 无需额外的账户或令牌。
客户端模组策略
控制玩家可以使用哪些额外模组:
| 策略 | 行为 |
|---|---|
| 开放 (Open) | 玩家可以添加任何他们想要的客户端模组 |
| 白名单 (Allowlist) | 玩家可以添加符合你批准模式的模组(例如 journeymap-*、sodium-*) |
| 严格 (Strict) | 仅允许服务器模组 —— 额外模组会在同步时被移除 |
⚙️ 完全可配置
所有设置均位于 config/nlauncher-sync.toml 中:
- 服务器显示名称:在启动器中向玩家显示
- 同步端口(默认
25580) - 配置文件模式 —— 精确选择要推送的配置(支持通配符)
- 排除模组 —— 跳过不需要同步的服务端专属模组
- 客户端模组策略与白名单
? 服务器命令
/nlsync reload—— 重新扫描模组和配置并重建清单(例如,在添加新模组后)/nlsync status—— 显示同步服务器状态、模组数量、配置数量及策略
快速开始
对于服务器管理员
- 将模组 JAR 文件放入服务器的
mods/文件夹 - 启动服务器 —— 将生成默认的
config/nlauncher-sync.toml - 编辑配置文件以设置服务器名称、配置同步模式和客户端模组策略
- 在防火墙/托管面板中开放端口
25580(或你配置的端口) - 告诉玩家在 NLauncher 中添加你的服务器 —— 完成!
对于玩家
- 打开 NLauncher 并转到 添加服务器实例 (Add Server Instance)
- 输入服务器地址(例如
play.example.com) - 如果服务器使用非标准端口,请设置 加入端口 (Join Port)(默认
25565)和 同步端口 (Sync Port)(默认25580) - 点击 连接 (Connect) —— NLauncher 将预览服务器信息(名称、版本、模组数量)
- 确认以创建实例 —— 模组和配置将自动下载
- 启动并游玩!每次后续启动都会在启动游戏前同步任何更新
示例配置
[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-*"
]
要求
- Minecraft 1.16.5+(目前仅支持 1.20.1 和 1.21.11,但计划支持 1.16.5+)
- 加载器: NeoForge, Forge, Fabric 或 Quilt
- NLauncher v0.5.0+(玩家端)
- 端口
25580(或配置的端口)必须对玩家可访问
常见问题
这个模组会在客户端做什么吗? 不会。这是一个仅服务端模组。玩家不需要安装它 —— 他们使用 NLauncher,后者会自动处理同步。
我需要在某处托管文件吗? 不需要。模组直接从你的服务器提供文件。无需外部托管、CDN 或第三方服务。
如果同步服务器无法访问会发生什么? NLauncher 会警告玩家,但仍允许他们使用上次同步的内容启动。没有人会被锁在外面。
玩家仍然可以添加客户端模组(如小地图或光影)吗?
可以!将客户端模组策略设置为 open 或 allowlist,即可让玩家在服务端整合包之外添加批准的客户端模组。
它会同步资源包或光影包吗? 不会。Minecraft 已经原生处理服务器资源包,而光影包属于个人偏好。
这安全吗? 该模组仅向被加入白名单或之前已加入过你服务器的玩家提供服务,并通过 Minecraft UUID 进行验证。整合包文件并非敏感数据,因此基于 UUID 的认证适用于此用例。
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
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
下载 NLauncher Server Sync
更新日志
1.0.0
- 首次发布
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个基于构建器的 Minecraft 配置库!
模组
? 使用命令保存和加载玩家或他人的背包/套装。
模组
一款轻量级模组,允许服务器管理员对抗透视作弊者。
模组
恢复所有账户的游戏聊天访问权限
模组
通过图形界面控制模组加载。适用于需要可选功能的整合包和服务器,也适合不想手动操作文件而希望直接管理模组的极客用户。
模组
实体tick优化
评论 0
登录后参与评分
还没有评论,来抢沙发吧