NLauncher Server Sync

模组

· 作者 Nyfaria

NLaunchers 服务器实例的服务端 API。

0 本站下载 0 关注 更新于 8 个月前

最新 1.1.0 · 1.20.1 · Forge

一键开服(送7天)

NLauncher Server Sync

自动将整合包同步给所有玩家——无需外部托管,无需手动下载。

NLauncher Server Sync 是一个仅服务端模组,与 NLauncher Minecraft 启动器配合使用。在服务器上安装它,玩家在游戏启动时将自动接收所有的模组和配置更新。


工作原理

  1. 服务器管理员在服务器上安装此模组
  2. 玩家在 NLauncher 中添加服务器地址(“添加服务器实例”)
  3. NLauncher 连接到模组内置的同步 API,预览服务器信息并创建匹配的实例
  4. 每次玩家启动游戏时,NLauncher 都会检查更新并自动同步模组/配置

无需 FTP。无需 Dropbox 链接。无需“嘿大家,重新下载整合包”。只需更新你的服务器,玩家即可保持同步。


功能

自动模组与配置同步

模组会扫描服务器 mods/ 文件夹中配置的配置文件,构建包含 SHA-256 哈希值的清单,并通过轻量级内置 HTTP 服务器提供给玩家。玩家仅下载发生更改的内容。

Minecraft 账户授权

如果开启了白名单,只有被加入白名单的玩家才能同步。 如果关闭了白名单,只有未被服务器封禁的玩家才能同步。 认证使用玩家的 Minecraft UUID —— 无需额外的账户或令牌。

客户端模组策略

控制玩家可以使用哪些额外模组:

策略 行为
开放 (Open) 玩家可以添加任何他们想要的客户端模组
白名单 (Allowlist) 玩家可以添加符合你批准模式的模组(例如 journeymap-*、sodium-*)
严格 (Strict) 仅允许服务器模组 —— 额外模组会在同步时被移除

⚙️ 完全可配置

所有设置均位于 config/nlauncher-sync.toml 中:

  • 服务器显示名称:在启动器中向玩家显示
  • 同步端口(默认 25580)
  • 配置文件模式 —— 精确选择要推送的配置(支持通配符)
  • 排除模组 —— 跳过不需要同步的服务端专属模组
  • 客户端模组策略与白名单

? 服务器命令

  • /nlsync reload —— 重新扫描模组和配置并重建清单(例如,在添加新模组后)
  • /nlsync status —— 显示同步服务器状态、模组数量、配置数量及策略

快速开始

对于服务器管理员

  1. 将模组 JAR 文件放入服务器的 mods/ 文件夹
  2. 启动服务器 —— 将生成默认的 config/nlauncher-sync.toml
  3. 编辑配置文件以设置服务器名称、配置同步模式和客户端模组策略
  4. 在防火墙/托管面板中开放端口 25580(或你配置的端口)
  5. 告诉玩家在 NLauncher 中添加你的服务器 —— 完成!

对于玩家

  1. 打开 NLauncher 并转到 添加服务器实例 (Add Server Instance)
  2. 输入服务器地址(例如 play.example.com)
  3. 如果服务器使用非标准端口,请设置 加入端口 (Join Port)(默认 25565)和 同步端口 (Sync Port)(默认 25580)
  4. 点击 连接 (Connect) —— NLauncher 将预览服务器信息(名称、版本、模组数量)
  5. 确认以创建实例 —— 模组和配置将自动下载
  6. 启动并游玩!每次后续启动都会在启动游戏前同步任何更新

示例配置

[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 的认证适用于此用例。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源