Update Beacon

UpdateBeacon

Серверный мод для Minecraft, который автоматически проверяет обновления установленных модов на Modrinth и CurseForge, затем уведомляет ваших операторов — и может скачать и применить обновления за вас. Установка на клиент не требуется.

Возможности

Обнаружение обновлений

• Проверяет каждый установленный мод на Modrinth и CurseForge (CurseForge включается добавлением бесплатного API-ключа).
• Сопоставление по хешу — сравнивает SHA-512 каждого установленного jar-файла с записями файлов Modrinth (и отпечатками CurseForge), исключая ложные срабатывания из-за особенностей строк версий (например, 1.4.147 против 1.4.147+v240613).
• Вложенные и встроенные субмоды пропускаются автоматически.
• Каналы обновлений для каждого мода — отслеживайте release, beta или alpha независимо для каждого мода.
• Закрепления — заморозьте мод на текущей версии, чтобы отключить уведомления об обновлениях, пока не снимете закрепление.

Уведомления

• Консоль — записывает доступные обновления при каждой проверке.
• Игровой чат — цветной вывод с кликабельными ссылками для скачивания, отправляется подходящим операторам.
• Вход игрока — операторы видят ожидающие обновления при входе.
• Вебхуки — отправка на любое количество адресов одновременно (см. ниже).

Скачивание и применение

• Скачивайте ожидающие обновления в промежуточную область с проверкой хеша по ожидаемому хешу источника.
• Применяйте подготовленные jar-файлы при следующей остановке сервера или запустите отсчёт применения по таймеру, который перезапустит сервер за вас.
• Заменённые jar-файлы сначала резервируются, поэтому любое обновление можно откатить.

Обслуживание

• Проверка целостности — сверяйте установленные jar-файлы с опубликованными хешами.
• Горячая перезагрузка — перечитайте конфиг без перезапуска.
• Опциональные проверки по расписанию на повторяющемся таймере.

Команды

Все команды находятся под /updatebeacon и требуют уровень разрешений 2 (op).

Вебхуки

Добавьте один блок [[webhooks]] на каждый адрес, каждый со своим URL и форматом:

[[webhooks]]
url = "https://discord.com/api/webhooks/..."
format = "discord_embed"

[[webhooks]]
url = "https://your-endpoint.com/hook"
format = "generic_json"

Поддерживаемые форматы:

• discord_embed — расширенный embed для вебхуков Discord
• generic_json — простой JSON-запрос для пользовательских интеграций

Установка

Поместите jar-файл мода, соответствующий вашей версии Minecraft и загрузчику, в папку mods/ вашего сервера, затем запустите сервер один раз для создания конфига. Требования:

• Поддерживаемая версия Minecraft (см. таблицу выше)
• Fabric Loader с Fabric API или NeoForge
• Бесплатный API-ключ CurseForge (опционально — нужен только для проверки обновлений на CurseForge)

Конфигурация

Создаётся в config/updatebeacon.toml при первом запуске:

[general]
enabled = true
check_on_startup = true
check_interval_minutes = 0   # 0 = отключено; любое положительное значение = минуты между проверками

[ignore]
mod_ids = []                 # ID модов для пропуска, например ["mymod", "anothermod"]
quiet_when_no_updates = true # отключить все уведомления, когда всё актуально

[console]
enabled = true

[chat]
enabled = true
ops_only = true              # уведомлять только операторов сервера
permission_level = 2         # минимальный уровень разрешений для получения уведомлений

# Добавьте один блок [[webhooks]] на каждый адрес. Поддерживаемые форматы: discord_embed, generic_json
# [[webhooks]]
# url = ""
# format = "discord_embed"

[downloads]
auto_download = false        # автоматически скачивать обновления после каждой проверки
auto_apply = false           # заменять подготовленные jar-файлы в mods/ при остановке сервера
backup = true                # хранить заменённые jar-файлы в .updatebeacon/backup/
allowed_mod_ids = []         # пусто = все моды подходят; не пусто = белый список
apply_countdown_seconds = 300 # длительность отсчёта по умолчанию для /updatebeacon apply

[curseforge]
# Получите бесплатный API-ключ на https://console.curseforge.com/
api_key = ""                 # оставьте пустым для проверки только Modrinth

# Канал обновлений для каждого мода: "release", "beta" или "alpha"
[mod_policy]
# lithium = "beta"

# Закрепите мод, чтобы предотвратить уведомления об обновлениях. Используйте /updatebeacon pin <modid>
[mod_pins]

Подготовленные загрузки и резервные копии хранятся в .updatebeacon/staged/ и .updatebeacon/backup/.

Примечания

По умолчанию моды сопоставляются через Modrinth; проверки CurseForge включаются после того, как вы зададите curseforge.api_key. Моды, не опубликованные ни на одной из платформ, молча пропускаются.