Перейти к содержанию

⏳ ArkBossCooldown

ArkBossCooldown вводит общий для всего сервера кулдаун между стартами боссов. Арены боссов открываются созданием предмета-трибьюта, и ничто не мешает группе создать несколько подряд — телепорты накапливаются, и игроки прибывают на арену уже мёртвыми. Этот плагин заставляет сервер отказывать в старте босса, пока не истечёт кулдаун от предыдущего.

Он намеренно небольшой: один кулдаун, одно сообщение, один список предметов трибьюта.

Что он делает

  • Один кулдаун на весь сервер. Первый крафт трибьюта босса запускает его; каждый следующий крафт трибьюта отклоняется, пока он не истечёт. Это не привязано к игроку или племени — если одна группа запускает босса, ждут все.
  • Отклонённый крафт ничего не стоит. Предмет трибьюта не расходуется, и телепорт не происходит, так что игрок, попавший на кулдаун, может просто попробовать снова, когда он пройдёт.
  • Сообщает игроку причину. Настраиваемое сообщение в чате, уведомлении или широковещательное показывает оставшееся время. Его также можно отключить, чтобы отказывать молча.
  • Работает на любой карте и с модами. Предметы трибьюта, запускающие кулдаун, — это просто список путей чертежей в конфигурации, так что вы можете добавить модовые арены или убрать боссов, которые не хотите ограничивать.
  • Больше ничего. Предметы, не входящие в ваш список, крафтятся совершенно обычным образом.

ℹ️ Это дебаунс, а не блокировка боссов. BossStartCooldown по умолчанию равен 5 секундам — достаточно долго, чтобы поглотить всплеск спам-кликов, и достаточно коротко, чтобы этого никто не заметил. Если вам нужно настоящее ограничение «один босс в час», установите гораздо большее значение и сначала прочитайте примечание о перезапусках и перезагрузках.

Требования

Требование Примечания
ArkApi 3.51 или новее Плагин не загрузится на более старых версиях API.
MySQL / MariaDB Плагин подключается при запуске, поэтому требуются корректные учётные данные — но сам ArkBossCooldown ничего там не хранит. См. Общую конфигурацию.
Лицензионный ключ Bytemart Ничего не активируется, пока ключ не пройдёт аутентификацию.
Исходящий HTTPS Требуется для лицензирования.

Установка

  1. Убедитесь, что на вашем сервере установлен ArkApi 3.51+.
  2. Настройте базу данных MySQL/MariaDB — см. Общую конфигурацию. База данных должна уже существовать.
  3. Скачайте ArkBossCooldown.zip с вашей панели управления Bytemart.
  4. Остановите сервер (сначала выполните saveworld) или выгрузите любую предыдущую версию командой plugins.unload ArkBossCooldown.
  5. Распакуйте архив в папку ArkBossCooldown внутри ShooterGame/Binaries/Win64/ArkApi/Plugins/.
  6. Откройте config.json и заполните ваш LicenseKey и учётные данные Database. Значения по умолчанию для всего остального пригодны для использования как есть — см. Конфигурация.
  7. Запустите сервер и убедитесь, что при запуске нет ошибок.
  8. Создайте трибьют босса дважды подряд, чтобы проверить, что вторая попытка отклоняется и появляется сообщение.

💡 Играете на карте или моде, которых нет в списке по умолчанию? Включите TestMode, создайте трибьют один раз и скопируйте путь чертежа, выведенный в консоль, в Bosses. Затем снова выключите TestMode.

Обновление

  • Вручную: plugins.unload ArkBossCooldown, замените файлы, затем plugins.load ArkBossCooldown.
  • Автоматически (горячая перезагрузка): переименуйте новый ArkBossCooldown.dll в ArkBossCooldown.dll.arkapi и поместите его в папку плагина — ArkApi загрузит новую версию и автоматически выгрузит старую.

ArkBossCooldown восстанавливает свою конфигурацию при загрузке: отсутствующие ключи добавляются со значениями по умолчанию, а оригинал сначала сохраняется в config.json.bak. Несоответствие типа (строка там, где должно быть число) вместо этого прерывает загрузку с ошибкой, называющей ключ.

Команды

Доступ к консоли и RCON по определению является доступом администратора, поэтому они не требуют дополнительных прав.

Команда Каналы Описание
ArkBossCooldown.help [page] Console, RCON Постраничный список всех зарегистрированных команд.
ArkBossCooldown.reload Console, RCON Перечитать config.json без перезапуска сервера.

ArkBossCooldown.reload пересобирает список боссов, длительность кулдауна, TestMode и настройки сообщения с диска. Он не сбрасывает уже идущий кулдаун — перезагрузка не даёт бесплатного старта босса. Чтобы сбросить кулдаун, выгрузите и снова загрузите плагин. Он также не запускает повторно проход восстановления конфигурации, поэтому проверяйте ваш JSON перед перезагрузкой.

Устранение неполадок

  • Кулдаун никогда не срабатывает — вероятно, трибьют, который вы создаёте, не входит в список Bosses. Включите TestMode, создайте его и прочитайте путь из консоли.
  • Плагин не загружается, код ошибки 1114 — синтаксическая ошибка JSON в config.json. Проверьте его через JSONLint. Длинный массив Bosses облегчает пропуск случайной запятой.
  • «License key is missing» — LicenseKey всё ещё содержит значение-заглушку.
  • Сообщение не появляется — проверьте, что CooldownMessage.Enabled установлено в true, и учтите, что Scale применяется только к каналу Notification.
  • Во всех остальных случаях — установите LogToFile в true и воспроизведите проблему; плагин пишет собственный ротируемый журнал ArkBossCooldown.log рядом с config.json. Затем спросите в Discord Bytemart.

Дальнейшие шаги: