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 |
客户端设置
- 安装正确版本的 Fabric Loader 或 NeoForge。
- 将对应的 PackPulseMod jar 文件放入
.minecraft/mods 目录。
- 启动一次 Minecraft 以生成配置文件。
- 关闭 Minecraft。
- 打开:
.minecraft/config/packpulse.json
- 将示例
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 |
Настройка Клиента
- Установи подходящий Fabric Loader или NeoForge.
- Положи нужный jar PackPulseMod в
.minecraft/mods.
- Запусти Minecraft один раз, чтобы создался конфиг.
- Закрой Minecraft.
- Открой:
.minecraft/config/packpulse.json
- Замени примерный
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
PackPulseMod
PackPulseMod is an open-source client-side updater for private Minecraft modpacks.
It is designed for server owners and small communities who want players to keep their pack folders in sync without shipping a full launcher.
PackPulseMod is not tied to any specific server. You host your own files and manifest.json, then set the manifest URL in the client config.
Features
- Syncs missing or changed files on Minecraft startup
- Uses SHA-256 hashes for file checks
- Supports
mods, config, resourcepacks, shaderpacks, extra top-level mod folders, and optional options.txt
- Shows a confirmation screen before downloading
- Lets players choose which files to download
- Includes a scrollable file list
- Shows clean mod/file names without
.jar, .zip, .txt, etc.
- Has a
Download all button
- Supports HTTP and HTTPS manifest URLs
- Supports explicit file removal through the manifest
delete list
- Can optionally remove stale files that are no longer in the manifest
- Shows a restart screen when updated
.jar mods require a restart
Supported Builds
| Loader |
Minecraft versions |
| 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 |
Client Setup
- Install the correct Fabric Loader or NeoForge version.
- Put the matching PackPulseMod jar into
.minecraft/mods.
- Start Minecraft once to create the config.
- Close Minecraft.
- Open:
.minecraft/config/packpulse.json
- Replace the example
manifestUrl with your own URL:
{
"manifestUrl": "https://your-domain.example/packpulse/manifest.json",
"removeFilesMissingFromManifest": false,
"updateOnStartup": true,
"showProgressWindow": true,
"autoRestartAfterModUpdates": false,
"restartExecutable": ""
}
The default URL is only a placeholder. You must host your own manifest.
Server Pack Layout
Put pack files on your server like this:
server-pack/
mods/
config/
defaultconfigs/
kubejs/
resourcepacks/
shaderpacks/
options.txt
options.txt is optional.
Manifest
PackPulseMod expects a JSON manifest with file paths, download URLs, SHA-256 hashes, and an optional delete list for files that should be removed from clients.
The repository includes scripts that can generate and deploy this manifest automatically. When a previously published file disappears from the server pack, the generator adds it to delete, so old renamed mods can be removed safely.
Example script workflow:
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
HTTP by IP:
sudo ./scripts/deploy_http_ip.sh --server-ip YOUR_SERVER_IP
HTTPS with domain and Let's Encrypt:
sudo ./scripts/deploy_https_letsencrypt.sh --domain files.example.com --email you@example.com
After changing your pack files, run the same deploy script again.
Notes
- This mod is client-side.
- It is meant for private packs, server packs, and community packs.
- For public releases, test the edge versions of each supported Minecraft range.
Русский
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 |
Настройка Клиента
- Установи подходящий Fabric Loader или NeoForge.
- Положи нужный jar PackPulseMod в
.minecraft/mods.
- Запусти Minecraft один раз, чтобы создался конфиг.
- Закрой Minecraft.
- Открой:
.minecraft/config/packpulse.json
- Замени примерный
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
HTTP по IP:
sudo ./scripts/deploy_http_ip.sh --server-ip YOUR_SERVER_IP
HTTPS через домен и Let's Encrypt:
sudo ./scripts/deploy_https_letsencrypt.sh --domain files.example.com --email you@example.com
После изменения файлов сборки просто запусти тот же deploy-скрипт снова.
Примечания
- Мод работает на стороне клиента.
- Подходит для приватных сборок, серверных сборок и сборок небольших сообществ.
- Перед публичным релизом лучше проверить крайние версии каждого поддерживаемого диапазона Minecraft.
License
MIT
评论 0
登录后参与评分
还没有评论,来抢沙发吧