⚡ NexusSync
NexusSync 是一款轻量级、零配置的 NeoForge 客户端-服务器模组同步模组。它允许玩家无缝连接至模组化服务器,通过自动下载、更新或移除必选和可选模组,并配合服务器端的黑名单保护机制实现这一目标。
✨ 功能特性
- ? 自动模组同步: 自动比较本地客户端模组与服务器的清单文件,直接从 Modrinth CDN、CurseForge、Google Drive 或自定义链接下载缺失或过时的模组。
- ? 支持可选模组: 允许服务器管理员指定仅客户端使用的可选模组(例如性能优化、视觉效果、小地图等)。复选框默认处于未选中状态,因此玩家只会下载他们选择的模组。
- ? 自动清理: 安全检测并移除客户端中旧版或被删除的模组版本,防止因模组重复导致的崩溃。
- ?️ 服务器管理黑名单: 服务器管理员可以在
blacklist.json 中配置禁止的作弊模组和资源包。规则会直接从服务器流式传输到客户端,以保护服务器的完整性。
- ⚡ 无需外部启动器配置: 在标准 Minecraft 内即可直接使用,无需第三方整合包更新器或启动器配置。
- ? 热重载支持: 在服务器上执行
/nexussync reload 命令,即可立即重新扫描模组、更新清单并刷新 MOTD(服务器状态信息),而无需重启服务器。
? 工作原理
对于玩家
- 将服务器添加到你的多人游戏服务器列表中。
- 点击 Join(加入)或服务器条目旁边的 Sync(同步)按钮。
- 如果需要更新模组,请查看确认屏幕并点击 Download & Restart(下载并重启)。
- 完成后,你的游戏将完全更新完毕并准备好游玩!
对于服务器管理员
- 将 NexusSync 安装到服务器的
mods 文件夹中。
- 启动服务器。NexusSync 将自动扫描你的模组,通过 Modrinth/CurseForge API 解析下载链接,并生成
mods/nexussync/config.json。
- (可选) 编辑
config.json 以配置可选模组、仅服务器端模组或自定义下载 URL。
- 在游戏中或通过服务器控制台运行
/nexussync reload 以即时应用更改。
⚙️ 配置与命令
mods/nexussync/config.json — 服务器清单配置文件,用于区分必选、可选和仅服务器端模组。
mods/nexussync/blacklist.json — 服务器端反作弊黑名单,用于阻止被禁用的模组和 X-Ray 资源包。
/nexussync reload (权限等级 2)— 重新扫描服务器模组,更新清单,重新加载黑名单,并动态更新服务器状态。
? 网络与隐私披露
NexusSync 仅出于模组同步目的执行网络请求:
- 查询 Modrinth API (
api.modrinth.com) 以通过 SHA-1 哈希值解析权威的下载链接。
- 查询服务器管理员在
config.json 中明确提供的 CurseForge / 直接 URL / Google Drive 链接。
- 不收集、跟踪或传输任何个人玩家数据或遥测数据。
? 要求
- Minecraft:
1.21.1
- 加载器:
NeoForge (21.1.x+)
- Java:
Java 21
?? Описание на русском языке (Russian Description)
⚡ NexusSync
NexusSync — это лёгкий мод для NeoForge, который обеспечивает полную автоматическую синхронизацию модов между клиентом и сервером. Игроки могут заходить на сервер без ручной сборки модпака: мод сам скачает недостающие моды, обновит устаревшие и удалит лишние файлы.
✨ Основные возможности:
- ? Авто-синхронизация модов: Сверяет хэш-суммы (SHA-1) файлов и автоматически скачивает нужные моды с Modrinth, Google Диска, CurseForge или прямых ссылок.
- ? Поддержка опциональных модов: Сервер может предлагать визуальные или оптимизационные моды, выбор которых остаётся за игроком (по умолчанию галочки сняты).
- ? Очистка устаревших версий: Автоматически удаляет старые файлы модов при обновлении, предотвращая крэши из-за дубликатов.
- ?️ Серверный блэклист: Администратор сервера может централизованно блокировать чит-моды и X-Ray ресурспаки через
blacklist.json.
- ⚡ Без сторонних лаунчеров: Всё работает прямо в клиенте Minecraft.
- ? Перезагрузка на лету: Команда
/nexussync reload позволяет обновлять список модов без перезапуска сервера.
⚡ NexusSync
NexusSync is a lightweight, zero-setup client-server mod synchronization mod for NeoForge. It enables players to connect to modded servers seamlessly by automatically downloading, updating, or removing mandatory and optional mods with server-side blacklist protection.
✨ Features
- ? Automatic Mod Synchronization: Automatically compares local client mods with the server manifest and downloads missing or outdated mods directly from Modrinth CDN, CurseForge, Google Drive, or custom links.
- ? Optional Mods Support: Allows server owners to specify client-side optional mods (e.g., performance, visual effects, mini-maps). Checkboxes default to unchecked so players only download what they choose.
- ? Automatic Cleanup: Safely detects and removes old or deleted mod versions on the client to prevent mod duplicate crashes.
- ?️ Server-Managed Blacklist: Server admins can configure forbidden cheat mods and resource packs in
blacklist.json. Rules are streamed directly from the server to protect server integrity.
- ⚡ Zero External Launcher Setup: Works right inside standard Minecraft without needing third-party modpack updaters or launcher configurations.
- ? Hot-Reload Support: Use
/nexussync reload on the server to immediately re-scan mods, update the manifest, and refresh the MOTD without restarting the server.
? How It Works
For Players
- Add the server to your multiplayer server list.
- Click Join or the Sync button next to the server entry.
- If mods need updating, review the confirmation screen and click Download & Restart.
- Once completed, your game will be completely up to date and ready to play!
For Server Administrators
- Install NexusSync into your server's
mods folder.
- Start the server. NexusSync will automatically scan your mods, resolve download links via Modrinth/CurseForge APIs, and generate
mods/nexussync/config.json.
- (Optional) Edit
config.json to configure optional mods, server-only mods, or custom download URLs.
- Run
/nexussync reload in-game or in the server console to apply changes instantly.
⚙️ Configuration & Commands
mods/nexussync/config.json — Server manifest config separating mandatory, optional, and server-only mods.
mods/nexussync/blacklist.json — Server-side anticheat blacklist for blocking banned mods and x-ray packs.
/nexussync reload (Permission Level 2) — Re-scans server mods, updates manifest, reloads blacklist, and updates server status dynamically.
? Network & Privacy Disclosure
NexusSync performs network requests exclusively for mod synchronization purposes:
- Queries the Modrinth API (
api.modrinth.com) to resolve authoritative download links by SHA-1 hash.
- Queries CurseForge / Direct URLs / Google Drive links explicitly provided in the server administrator's
config.json.
- Does not collect, track, or transmit any personal player data or telemetry.
? Requirements
- Minecraft:
1.21.1
- Mod Loader:
NeoForge (21.1.x+)
- Java:
Java 21
?? Описание на русском языке (Russian Description)
⚡ NexusSync
NexusSync — это лёгкий мод для NeoForge, который обеспечивает полную автоматическую синхронизацию модов между клиентом и сервером. Игроки могут заходить на сервер без ручной сборки модпака: мод сам скачает недостающие моды, обновит устаревшие и удалит лишние файлы.
✨ Основные возможности:
- ? Авто-синхронизация модов: Сверяет хэш-суммы (SHA-1) файлов и автоматически скачивает нужные моды с Modrinth, Google Диска, CurseForge или прямых ссылок.
- ? Поддержка опциональных модов: Сервер может предлагать визуальные или оптимизационные моды, выбор которых остаётся за игроком (по умолчанию галочки сняты).
- ? Очистка устаревших версий: Автоматически удаляет старые файлы модов при обновлении, предотвращая крэши из-за дубликатов.
- ?️ Серверный блэклист: Администратор сервера может централизованно блокировать чит-моды и X-Ray ресурспаки через
blacklist.json.
- ⚡ Без сторонних лаунчеров: Всё работает прямо в клиенте Minecraft.
- ? Перезагрузка на лету: Команда
/nexussync reload позволяет обновлять список модов без перезапуска сервера.
评论 0
登录后参与评分
还没有评论,来抢沙发吧