PackPulse

PackPulseMod

PackPulseMod — это открытый клиентский апдейтер для приватных модпаков Minecraft.

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

PackPulseMod не привязан к какому-либо конкретному серверу. Вы размещаете свои файлы и manifest.json у себя, а затем указываете URL манифеста в конфиге клиента.

Возможности

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

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

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

1. Установите подходящую версию Fabric Loader или NeoForge.
2. Поместите соответствующий jar PackPulseMod в .minecraft/mods.
3. Запустите Minecraft один раз, чтобы создать конфиг.
4. Закройте Minecraft.
5. Откройте:

.minecraft/config/packpulse.json

6. Замените пример 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 опционален.

Манифест

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

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

После изменения файлов пака запустите тот же скрипт развёртывания снова.

Примечания

• Этот мод клиентский.
• Он предназначен для приватных паков, серверных паков и паков сообществ.
• Для публичных релизов тестируйте крайние версии каждого поддерживаемого диапазона 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-модов нужен перезапуск

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

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

1. Установи подходящий Fabric Loader или NeoForge.
2. Положи нужный jar PackPulseMod в .minecraft/mods.
3. Запусти Minecraft один раз, чтобы создался конфиг.
4. Закрой Minecraft.
5. Открой:

.minecraft/config/packpulse.json

6. Замени примерный 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.

Лицензия

MIT