BlanketConditionalText

🔍 Обзор: Модификация BlanketConditionalText предоставляет владельцам серверов возможность отображать динамические сообщения, которые меняются в зависимости от статистики игроков, времени суток и других настраиваемых параметров. С помощью плейсхолдеров, определяемых в JSON-файлах, вы можете контролировать, что видят игроки на табло очков, в чате, голограммах и других местах — всё это на основе гибких правил!

Идеальное решение для информирования игроков, развлечения и отображения ключевой статистики и событий!

📜 Основные возможности:

• Создание плейсхолдеров с условиями для отображения конкретных сообщений на основе игровых значений
• Поддержка нескольких правил для каждого плейсхолдера с различными сообщениями
• Простая конфигурация через JSON с опциями для цвета текста, прав доступа и пользовательских плейсхолдеров

📂 Как это работает: Плейсхолдеры определяются в JSON-файлах, расположенных в папке config/blanketct/placeholders. Каждый плейсхолдер содержит:

• placeholderid — уникальный идентификатор для использования в игре
• Исходный плейсхолдер, который получает значения (например, %player:health% или %server:time H%)
• Пользовательские правила с условиями и сообщениями для показа при выполнении условий

📋 Объяснение условий: Условия — это основа того, как BlanketConditionalText отображает контекстно-зависимые сообщения. С помощью условий вы можете решить, какое сообщение показывать на основе значения плейсхолдера (например, здоровья игрока или времени сервера).

Каждое условие включает:

• Оператор: Определяет тип сравнения:
  • < (меньше)
  • > (больше)
  • = (равно)
  • != (не равно)
• Значение: Пороговое значение, с которым сравнивается значение плейсхолдера

Мод проверяет условия в том порядке, в котором они определены в JSON-конфигурации. Он начинает с верхней части списка, проверяет каждое условие и останавливается на первом совпадающем условии. Если ни одно условие не совпадает, отображается резервное сообщение (последнее правило без условия).

Пошаговый принцип работы условий

1. Получение значения плейсхолдера: Мод извлекает текущее значение плейсхолдера, например, здоровье игрока или время суток
2. Проверка каждого условия: Начиная сверху, он сравнивает значение плейсхолдера с условием каждого правила
3. Отображение первого совпадающего текста: Как только находится совпадающее условие, отображается соответствующий текст и дальнейшая проверка прекращается
4. Резервное сообщение: Если ни одно из условий не совпадает, мод показывает текст из правила с null в качестве условия (если оно существует)

Примеры:

1️⃣ Плейсхолдер статуса здоровья

• Показывает разные сообщения в зависимости от уровня здоровья игрока

{
"placeholderid": "health_status",
"placeholder": "%player:health%",
"rules": [
  { "condition": "<3", "text": "§cВы почти умерли!" },
  { "condition": "<6", "text": "§eВы ещё в порядке..." },
  { "condition": null, "text": "§aЗдоров как никогда!" }
]
}

• Использование: %blanketct:health_status%
• Отображение:
  • Вы почти умерли! (когда здоровье < 3)
  • Вы ещё в порядке... (когда 3 ≤ здоровье < 6)
  • Здоров как никогда! (когда здоровье ≥ 6)

2️⃣ Плейсхолдер времени суток

• Показывает сообщения в зависимости от времени сервера

{
"placeholderid": "time_of_day",
"placeholder": "%server:time H%",
"rules": [
  { "condition": "<12", "text": "§6Доброе утро!" },
  { "condition": "<18", "text": "§eДобрый день!" },
  { "condition": null, "text": "§9Добрый вечер!" }
]
}

• Использование: %blanketct:time_of_day%
• Отображение:
  • Доброе утро! (когда время < 12)
  • Добрый день! (когда 12 ≤ время < 18)
  • Добрый вечер! (когда время ≥ 18)

Команда перезагрузки:

• Используйте /bct reload для перезагрузки файлов конфигурации без перезапуска сервера (требуется разрешение bct.reload)

⚙️ Настраиваемость и расширяемость: Просто добавляйте новые JSON-файлы в папку конфигурации, чтобы расширить набор плейсхолдеров и правил.