PackPulse

模组

· 作者 Kamilchik

开源 Fabric 模组更新器,在玩家启动前从远程清单同步模组、配置文件、资源包和光影包。

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

最新 1.0.2 · 1.21.11 · NeoForge

一键开服(送7天)

PackPulseMod

PackPulseMod 是一个面向私有 Minecraft 整合包的开源客户端更新工具。

它专为服务器管理员和小社区设计,旨在让玩家在无需使用独立启动器的情况下保持整合包文件夹的同步。

PackPulseMod 不绑定任何特定服务器。你自行托管文件并配置 manifest.json,然后在客户端配置中设置清单 URL。

功能特性

  • 在 Minecraft 启动时同步缺失或已更改的文件
  • 使用 SHA-256 哈希值进行文件校验
  • 支持 mods、config、resourcepacks、shaderpacks、额外的顶层模组文件夹以及可选的 options.txt
  • 下载前显示确认界面
  • 允许玩家选择要下载的文件
  • 包含可滚动的文件列表
  • 显示清理后的模组/文件名,去除 .jar、.zip、.txt 等后缀
  • 提供“全部下载”按钮
  • 支持 HTTP 和 HTTPS 协议的清单 URL
  • 支持通过清单中的 delete 列表显式移除文件
  • 可选择移除那些不再存在于清单中的陈旧文件
  • 当更新的 .jar 模组需要重启时,会显示重启提示界面

支持的版本

加载器 Minecraft 版本
Fabric 1.20.1 - 1.20.6
Fabric 1.21 - 1.21.11
NeoForge 1.20.5 - 1.20.6
NeoForge 1.21 - 1.21.11

客户端设置

  1. 安装正确版本的 Fabric Loader 或 NeoForge。
  2. 将对应的 PackPulseMod jar 文件放入 .minecraft/mods 目录。
  3. 启动一次 Minecraft 以生成配置文件。
  4. 关闭 Minecraft。
  5. 打开:
.minecraft/config/packpulse.json
  1. 将示例 manifestUrl 替换为你自己的 URL:
{
  "manifestUrl": "https://your-domain.example/packpulse/manifest.json",
  "removeFilesMissingFromManifest": false,
  "updateOnStartup": true,
  "showProgressWindow": true,
  "autoRestartAfterModUpdates": false,
  "restartExecutable": ""
}

默认 URL 仅作为占位符。你必须自行托管自己的清单文件。

服务端整合包结构

将整合包文件按以下结构放置在你的服务器上:

server-pack/
  mods/
  config/
  defaultconfigs/
  kubejs/
  resourcepacks/
  shaderpacks/
  options.txt

options.txt 为可选文件。

清单 (Manifest)

PackPulseMod 期望一个 JSON 格式的清单文件,其中包含文件路径、下载 URL、SHA-256 哈希值,以及用于从客户端移除文件的可选 delete 列表。

仓库中包含可以自动生成和部署此清单的脚本。当之前发布的文件从服务器整合包中消失时,生成器会将其添加到 delete 列表中,从而安全地移除旧的重命名模组。

示例脚本工作流:

sudo mkdir -p /opt/packpulse/scripts /opt/packpulse/server-pack
cd /opt/packpulse

curl -fsSL -o scripts/generate_manifest.py https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/generate_manifest.py
curl -fsSL -o scripts/deploy_http_ip.sh https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/deploy_http_ip.sh
curl -fsSL -o scripts/deploy_https_letsencrypt.sh https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/deploy_https_letsencrypt.sh
chmod +x scripts/deploy_http_ip.sh scripts/deploy_https_letsencrypt.sh

通过 IP 使用 HTTP:

sudo ./scripts/deploy_http_ip.sh --server-ip YOUR_SERVER_IP

通过域名和 Let's Encrypt 使用 HTTPS:

sudo ./scripts/deploy_https_letsencrypt.sh --domain files.example.com --email you@example.com

更改你的整合包文件后,再次运行相同的部署脚本即可。

注意事项

  • 本模组为客户端侧模组。
  • 适用于私有整合包、服务器整合包和社区整合包。
  • 对于公开发布的资源,请测试每个受支持的 Minecraft 版本范围的边缘版本。

Русский

PackPulseMod - это open-source клиентский мод для автоматического обновления приватных Minecraft-сборок.

Он подходит для владельцев серверов и небольших сообществ, которым нужно синхронизировать папки сборки у игроков без отдельного лаунчера.

PackPulseMod не привязан к конкретному серверу. Ты размещаешь свои файлы и manifest.json, а затем указываешь ссылку на manifest в конфиге клиента.

Возможности

  • Синхронизация отсутствующих или измененных файлов при запуске Minecraft
  • Проверка файлов по SHA-256
  • Поддержка mods, config, resourcepacks, shaderpacks, дополнительных папок модов и опционального options.txt
  • Экран подтверждения перед скачиванием
  • Выбор, какие файлы скачивать
  • Список файлов со скроллом
  • Красивые названия файлов без .jar, .zip, .txt и других расширений
  • Кнопка Скачать всё
  • Поддержка HTTP и HTTPS ссылок на manifest
  • Явное удаление файлов через список delete в manifest
  • Опциональное удаление устаревших файлов, которых больше нет в manifest
  • Экран перезапуска, если после обновления .jar-модов нужен перезапуск

Поддерживаемые Сборки

Лоадер Версии Minecraft
Fabric 1.20.1 - 1.20.6
Fabric 1.21 - 1.21.11
NeoForge 1.20.5 - 1.20.6
NeoForge 1.21 - 1.21.11

Настройка Клиента

  1. Установи подходящий Fabric Loader или NeoForge.
  2. Положи нужный jar PackPulseMod в .minecraft/mods.
  3. Запусти Minecraft один раз, чтобы создался конфиг.
  4. Закрой Minecraft.
  5. Открой:
.minecraft/config/packpulse.json
  1. Замени примерный manifestUrl на свою ссылку:
{
  "manifestUrl": "https://your-domain.example/packpulse/manifest.json",
  "removeFilesMissingFromManifest": false,
  "updateOnStartup": true,
  "showProgressWindow": true,
  "autoRestartAfterModUpdates": false,
  "restartExecutable": ""
}

Стандартная ссылка является только примером. Нужно разместить свой manifest.

Структура Серверной Сборки

Файлы сборки на сервере должны лежать так:

server-pack/
  mods/
  config/
  defaultconfigs/
  kubejs/
  resourcepacks/
  shaderpacks/
  options.txt

options.txt необязателен.

Manifest

PackPulseMod ожидает JSON manifest с путями файлов, ссылками для скачивания, SHA-256 хэшами и опциональным списком delete для удаления файлов у клиентов.

在仓库中,有一些脚本可以自动生成 manifest 文件并将文件部署到服务器上。如果之前发布的文件从服务器构建包中消失,生成器会将其添加到 delete 列表中,以确保旧的重命名模组被安全删除。

示例:

sudo mkdir -p /opt/packpulse/scripts /opt/packpulse/server-pack
cd /opt/packpulse

curl -fsSL -o scripts/generate_manifest.py https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/generate_manifest.py
curl -fsSL -o scripts/deploy_http_ip.sh https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/deploy_http_ip.sh
curl -fsSL -o scripts/deploy_https_letsencrypt.sh https://raw.githubusercontent.com/Kamilhik/PackPulseMod/main/scripts/deploy_https_letsencrypt.sh
chmod +x scripts/deploy_http_ip.sh scripts/deploy_https_letsencrypt.sh

通过 IP 使用 HTTP:

sudo ./scripts/deploy_http_ip.sh --server-ip YOUR_SERVER_IP

通过域名和 Let's Encrypt 使用 HTTPS:

sudo ./scripts/deploy_https_letsencrypt.sh --domain files.example.com --email you@example.com

修改完构建包的文件后,只需再次运行相同的部署脚本即可。

注意事项

  • 该模组仅作用于客户端。
  • 适用于私有整合包、服务器整合包以及小型社区的整合包。
  • 在公开发布前,建议测试每个支持的 Minecraft 版本范围内的最新版本。

许可证

MIT

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源