Скачать CoolDowngazdev - Плагин на задержку команд - работает с командами CMI с Black-Minecraft.com | Black-Minecraft.com

Для версий

1.20.✘
1.21.✘

Java

Java 21

📌 CoolDowngazdev — Полное руководство

Мощная система управления кулдаунами команд для Minecraft

✨ О плагине

CoolDowngazdev — профессиональное решение для контроля задержек команд на вашем сервере. Плагин предоставляет гибкую настройку кулдаунов с учётом групп привилегий и индивидуальных прав доступа.

🎯 Ключевые преимущества:

⚡ Нулевая конфигурация для CMI — автоматическое распознавание всех CMI-команд (/rtp, /home, /warp и др.)
🎮 Поддержка алиасов — плагин корректно обрабатывает любые CMI-алиасы
📊 Интеграция с LuckPerms — создавайте группы прямо в конфиге, плагин автоматически их распознает
⏱️ Умное форматирование времени — вместо "3661 сек" пользователи видят "1 час и 1 минута"
🔧 Гибкость настройки — индивидуальные кулдауны для разных групп игроков
💾 Система сброса — возможность мгновенно сбросить кулдаун себе или другим игрокам

⚡ Уникальные возможности

🔥 Автоматическое распознавание CMI-команд

Забудьте о ручной настройке алиасов для каждой CMI-команды! Плагин автоматически распознаёт:

Прямые команды: /home, /warp, /rtp
CMI-префиксы: /cmi home, /cmi warp
Пользовательские алиасы из CMI

📌 Команды с аргументами

Используйте подчёркивание (_) для команд, которые требуют параметры:

Код:

heal_    # Работает: /heal nick, /heal Steve
          # НЕ работает: /heal (без аргументов)

spawn_   # Работает: /spawn nick
          # НЕ работает: /spawn

⚠️ Важно: Команда heal_ отличается от heal!
• heal — кулдаун только на /heal
• heal_ — кулдаун только на /heal <игрок>

✨ Форматированное время

Плагин преобразует секунды в читаемый формат:

Секунды	Отображение
45	45 секунд
125	2 минуты и 5 секунд
3661	1 час, 1 минута и 1 секунда
90061	1 день, 1 час, 1 минута и 1 секунда

Используйте плейсхолдер {formatted_time} в сообщениях для автоматического форматирования!

⚙️ Команды плагина

Перезагрузка конфигурации:

/cooldown reload
Перезагружает config.yml без перезапуска сервера

Право:cooldown.reload
По умолчанию: только OP

Сброс кулдаунов:

/cooldown reset <команда>
Сбрасывает ваш кулдаун для указанной команды
Пример: /cooldown reset tp
Право:cooldown.reset

/cooldown reset <игрок> <команда>
Сбрасывает кулдаун команды у другого игрока
Пример: /cooldown reset Steve tp
Право:cooldown.reset.others

/cooldown reset <игрок> all
Полностью очищает все кулдауны игрока
Пример: /cooldown reset Steve all
Право:cooldown.reset.others

🔑 Система прав

Право	Описание
cooldown.reload	Перезагрузка конфигурации
cooldown.bypass	Полный обход всех кулдаунов
cooldown.reset	Сброс собственных кулдаунов
cooldown.reset.others	Сброс кулдаунов других игроков

💡 Группы привилегий:

Плагин автоматически интегрируется с LuckPerms! Просто добавьте группы в config.yml:

YAML:

groups:
  vip: 30      # VIP-игроки ждут 30 секунд
  premium: 15  # Premium — 15 секунд
  admin: 0     # Админы без кулдауна

✨ Никаких дополнительных пермишенов настраивать не нужно!

📂 Структура конфигурации

Базовая команда:

YAML:

tp:
  default: 30              # Кулдаун для обычных игроков (секунды)
  groups:
    vip: 15                # Кулдаун для VIP-группы
    admin: 0               # Админы без кулдауна
  messages:
    time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

Команда с аргументами:

YAML:

heal_:                     # Подчёркивание = команда требует аргумент
  default: 60
  groups:
    vip: 30
    admin: 0
  messages:
    time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

Технические кулдауны для алиасов:

YAML:

# Для команд с пробелами создаём технические кулдауны
kitstartcooldown:
  default: 86400           # 24 часа
  groups:
    vip: 43200             # 12 часов для VIP
    admin: 0
  messages:
    time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

# Затем связываем через aliases:
aliases:
  "kit start": "kitstartcooldown"

Алиасы команд:

YAML:

aliases:
  # Команды с пробелами → технический кулдаун
  "kit start": "kitstartcooldown"
  "kit bonus": "kitbonuscooldown"
 
  # Сокращённые алиасы обычных команд
  "w": "weather"           # /w → /weather

💡 Зачем нужны алиасы?
Плагин не поддерживает команды с пробелами в основном блоке cooldowns. Поэтому для "kit start" создаём технический кулдаун и связываем через aliases.

🎨 Настройка сообщений

Доступные плейсхолдеры:

Плейсхолдер	Описание	Пример вывода
{formatted_time}	Читаемый формат времени	"1 час и 30 минут"
{cooldown_time}	Время в секундах	"90"
%command%	Название команды	"tp"
%player%	Имя игрока	"Steve"

Цветовые коды Minecraft:

Код:

§a - зелёный    §c - красный      §e - жёлтый
§6 - золотой     §b - голубой      §d - розовый
§f - белый       §7 - серый        §4 - тёмно-красный

Пример красивого сообщения:

YAML:

messages:
  time_left: "§6⏳ §eПодождите ещё §6{formatted_time} §eперед использованием этой команды!"

📋 Полный пример конфигурации

config.yml:

# ============================================================
#           CoolDowngazdev - Конфигурация плагина
# ============================================================
#
# Плагин для управления кулдаунами команд с поддержкой:
# • Гибкой настройки задержек для разных групп
# • Автоматического распознавания CMI-команд
# • Команд с аргументами (через подчёркивание)
# • Форматированного отображения времени
# • Алиасов для объединения команд
#
# ============================================================

cooldowns:
  # ============================================================
  # ОСНОВНЫЕ КОМАНДЫ
  # ============================================================
  # Формат:
  #   command_name:
  #     default: секунды (для игроков без группы)
  #     groups:
  #       group_name: секунды (кулдаун для группы из LuckPerms)
  #     messages:
  #       time_left: сообщение с плейсхолдером {formatted_time}
  # ============================================================

  # Пример 1: Обычная команда /tp
  tp:
    default: 30
    groups:
      vip: 15
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

  # Пример 2: Команда /home
  home:
    default: 60
    groups:
      vip: 30
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

  # ============================================================
  # КОМАНДЫ С АРГУМЕНТАМИ (с подчёркиванием _)
  # ============================================================
  # Используйте подчёркивание для команд с параметрами.
  # Например: heal_ работает с /heal player, но НЕ с /heal
  # ============================================================

  # Пример 3: Команда /heal с игроком (/heal nick)
  heal_:
    default: 90
    groups:
      vip: 60
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

  # Пример 4: Команда /spawn с игроком (/spawn nick)
  spawn_:
    default: 120
    groups:
      vip: 60
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

  # ============================================================
  # ТЕХНИЧЕСКИЕ КОМАНДЫ (для алиасов)
  # ============================================================
  # Используйте технические названия для команд с пробелами.
  # Команды типа "kit start" нельзя прописать напрямую,
  # поэтому создаём технические названия и связываем через aliases
  # ============================================================

  # Технический кулдаун для /kit start
  kitstartcooldown:
    default: 86400  # 24 часа
    groups:
      vip: 43200    # 12 часов
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

  # Технический кулдаун для /kit bonus
  kitbonuscooldown:
    default: 86400  # 24 часа
    groups:
      vip: 43200    # 12 часов
      admin: 0
    messages:
      time_left: "§6[●] §eЭта команда будет доступна через §6{formatted_time}"

# ============================================================
# АЛИАСЫ КОМАНД
# ============================================================
# Связывает команды с пробелами к техническим кулдаунам.
# Формат: "command arg": "technical_cooldown_name"
#
# ВАЖНО: Команды с пробелами (например "kit start") нельзя
# прописать в блоке cooldowns, поэтому используем алиасы!
# Каждая команда должна иметь свой уникальный технический кулдаун.
# ============================================================

aliases:
  # Пример 1: Команда /kit start → технический кулдаун kitstartcooldown
  "kit start": "kitstartcooldown"
 
  # Пример 2: Команда /kit bonus → технический кулдаун kitbonuscooldown
  "kit bonus": "kitbonuscooldown"
 
  # Пример 3: Сокращённый алиас для обычной команды
  "w": "weather"

# ============================================================
# НАСТРОЙКИ ПЛАГИНА
# ============================================================

settings:
  # Проверять права доступа к командам
  check_permission: true
 
  # Право на обход всех кулдаунов
  bypass_permission: "cooldown.bypass"
 
  # Настройки перезагрузки
  reload:
    permission: "cooldown.reload"
 
  # ============================================================
  # ФОРМАТИРОВАНИЕ ВРЕМЕНИ
  # ============================================================
  # Преобразует секунды в читаемый формат:
  # Пример: 90061 сек → "1 день, 1 час, 1 минута и 1 секунда"
  # Используйте плейсхолдер {formatted_time} в сообщениях
  # ============================================================
  formatted_time:
    enabled: true
 
  # ============================================================
  # НАСТРОЙКИ СБРОСА КУЛДАУНОВ
  # ============================================================
  # Команды:
  # • /cooldown reset <command> - сброс своего кулдауна
  # • /cooldown reset <player> <command> - сброс кулдауна игрока
  # • /cooldown reset <player> all - сброс всех кулдаунов игрока
  #
  # Для команд с подчёркиванием (heal_) используйте основное имя (heal)
  # ============================================================
  reset:
    own_reset_message: "&aКулдаун для команды /%command% был сброшен!"
    other_reset_message: "&aКулдаун для команды /%command% игрока %player% был сброшен!"
    all_reset_message: "&aВсе кулдауны игрока %player% были сброшены!"
    no_cooldown_message: "&cУ игрока %player% нет активного кулдауна для команды /%command%!"
    no_permission_message: "&cУ вас нет прав для сброса кулдаунов!"

# ============================================================
# СИСТЕМНЫЕ СООБЩЕНИЯ
# ============================================================

messages:
  reload_no_permission: "§cУ вас нет прав для перезагрузки конфигурации."
  reload_success: "§aКонфигурация кулдаунов успешно перезагружена!"

# ============================================================
# ПЛЕЙСХОЛДЕРЫ
# ============================================================
# • {formatted_time} - время в формате "X дней, Y часов, Z минут"
# • {cooldown_time} - время в секундах
# • %command% - название команды
# • %player% - имя игрока
# ============================================================

# ============================================================
# ПРАВА ДОСТУПА
# ============================================================
# • cooldown.reload - перезагрузка конфига
# • cooldown.bypass - обход всех кулдаунов
# • cooldown.reset - сброс своих кулдаунов
# • cooldown.reset.others - сброс кулдаунов других игроков
# ============================================================

# ============================================================
# ГРУППЫ
# ============================================================
# Все группы (vip, admin, owner и т.д.) берутся из LuckPerms!
# Просто укажите название группы в секции groups - плагин
# автоматически её распознает. Дополнительные пермишены не нужны.
# ============================================================

💡 Полезные советы

1. Оптимизация кулдаунов

Не ставьте слишком большие значения для базовых команд (/home, /spawn)
Для административных команд используйте 0 в группе админов
Дайте VIP-игрокам уменьшенные, но не нулевые кулдауны

2. Работа с группами

Группы берутся напрямую из LuckPerms — просто укажите их название
Игрок получает кулдаун своей основной группы
Если группы нет в конфиге — применяется default

3. Команды с подчёркиванием

Используйте для разделения /heal и /heal <игрок>
Можно настроить разные кулдауны: heal (60 сек) и heal_ (120 сек)
При сбросе указывайте имя без подчёркивания

4. Алиасы

Обязательны для команд с пробелами ("kit start", "eco give")
Каждая команда должна иметь уникальный технический кулдаун
Используйте понятные технические названия (kitstartcooldown вместо random123)

🐛 Решение проблем

Кулдаун не работает для команды:

Проверьте, написано ли название команды точно как в игре (без /)
Для CMI-команд используйте базовое название (home, а не cmi home)
Для команд с аргументами добавьте подчёркивание (heal_)

Группа игрока не применяется:

Убедитесь, что группа существует в LuckPerms
Проверьте написание группы в конфиге (регистр важен!)
Используйте /lp user <ник> info для проверки группы игрока

Алиасы не работают:

Проверьте, создан ли технический кулдаун в блоке cooldowns
Убедитесь в правильности написания технического названия
Используйте /cooldown reload после изменений

📌 Важные примечания

✅ Полная совместимость с CMI, EssentialsX и другими плагинами
✅ Минимальная нагрузка на сервер — оптимизированный код
⚠️ Требуется LuckPerms для работы системы групп
⚠️ Команды с пробелами работают только через алиасы, за исключением команд с аргументами по типу heal_

💬 Поддержка и связь

Возникли вопросы? Нужна помощь с настройкой?

Платформа	Контакт
💬 Telegram	@KingRussiaMen
💬 Discord	it_developer

⚡ Быстрый отклик • Профессиональная помощь • Индивидуальная настройка ⚡

✨ Плагин активно развивается и совершенствуется! ✨
Простой в настройке • Мощный в использовании • Надёжный в работе

⭐ Идеальное решение для серверов любого масштаба ⭐