Helgring XF Release Builder
✦ Утилита для пересборки hashes.json и правильной упаковки релизов XenForo ✦
Утилита создана для удобной работы с релизами аддонов XenForo. Она помогает автоматически пересобирать hashes.json, корректно анализировать структуру файлов и при необходимости сразу собирать правильный ZIP-архив для последующей установки.
Инструмент особенно полезен после ручных изменений в плагинах, когда XenForo начинает показывать в ACP уведомления вида «Неожиданное содержание» или сообщает, что файлы отличаются от оригинальных.
Вместо ручной правки служебных файлов утилита сама анализирует релиз, пересчитывает хэши и подготавливает корректный результат для дальнейшей работы.
Возможности
Автоматическая пересборка hashes.json
Утилита сама пересчитывает хэши файлов и обновляетhashes.jsonпод текущее состояние релиза.
Проверка структуры релиза
Сканируется вся папкаupload, а не толькоsrc/addons. Благодаря этому корректно учитываются и внешние файлы релиза:js,stylesи другие дополнительные пути.
Подробный анализ изменений
Утилита показывает, какие файлы добавлены, какие записи больше не нужны, какие файлы были изменены и что осталось без изменений.
Резервная копия перед перезаписью
Перед изменениемhashes.jsonможно автоматически создать.bak-копию исходного файла.
Правильная упаковка ZIP-архива
После пересборки можно сразу собрать готовый архив с правильной структуройupload/...для установки на форум.
Удобный пошаговый интерфейс
Скрипт работает в интерактивном режиме: показывает найденные аддоны, позволяет выбрать нужный, выводит итоговый отчёт и даёт возможность сразу начать новый цикл без закрытия окна.
Логирование действий
Во время работы утилита сохраняет лог, благодаря чему всегда можно проверить, что именно было найдено, пересобрано и упаковано.
Чистая подготовка релиза
Инструмент помогает привести релиз в аккуратное состояние перед переносом на основной форум или перед публикацией обновлённой версии.
Что делает утилита- Принимает путь до папки
upload - Находит аддоны в
src/addons/*/* - Определяет структуру релиза и связанные внешние файлы
- Пересобирает
hashes.jsonпо реальным файлам - При желании сразу собирает ZIP-архив
- Выводит итоговый отчёт по изменениям
Для кого подойдёт- Администраторам XenForo, которые вручную правят файлы установленных аддонов
- Разработчикам и модификаторам, которые собирают собственные версии плагинов под XenForo
- Тем, кто хочет быстро получать чистый ZIP-релиз после локальных изменений
- Тем, кто хочет избавиться от ручной правки hashes.json и сделать этот процесс удобным и безопасным
Основные преимущества- Без ручной правки hashes.json — всё делается автоматически
- Без путаницы со структурой релиза — утилита сама проверяет содержимое папки
upload - Без лишних действий — после пересборки можно сразу получить готовый архив
- С понятным интерфейсом — пошаговая работа через CMD с итоговым отчётом
- С удобной подготовкой перед установкой — релиз можно сразу переносить на форум после обработки
Что входит в комплект- Основной Python-скрипт для пересборки
hashes.json - Лог-файл для контроля работы
- Возможность собрать готовый ZIP-архив с правильной структурой
ПримечаниеУтилита предназначена для работы с локально подготовленным релизом аддона. Для корректного результата желательно, чтобы в папке
upload находились файлы одного конкретного релиза, без лишних сторонних материалов.Инструмент ориентирован на практическую работу с аддонами XenForo и может быть особенно полезен тем, кто регулярно адаптирует, исправляет или дорабатывает плагины под собственный форум.
Helgring XF Release Builder — удобный инструмент для тех, кто хочет привести релиз XenForo-аддона в порядок быстро, правильно и без ручной рутины.
![[Helgring] Thread Status Tools](/data/resource_icons/0/12.jpg?1775797550){kind=icon}
