KeyAllZ - автоматическая раздача наград

KeyAllZ - это плагин для серверов Minecraft, который автоматизирует раздачу наград игрокам через заданные промежутки времени. Отличный способ мотивировать игроков заходить на сервер регулярно, получать бонусы за активность. Плагин особенно полезен для серверов с донатом, голосованиями, ивентами. Он решает проблему ручной раздачи наград и позволяет настроить гибкие таймеры, команды, звуки и эффекты.

Особенности

• Создание нескольких типов KeyAll: ключи за голосование, донатерские ключи, награды за ивенты или любые другие кастомные награды
• Запуск таймеров, которые выполняют команды для всех онлайн-игроков
• Фиксированные или случайные интервалы для стабильных или динамических наград
• Выполнение команд от имени игрока или глобально из консоли
• Полностью настраиваемые сообщения в чате, action bar, заголовки, звуки и частицы
• Встроенные повторяющиеся напоминания для игроков
• Интеграция с PlaceholderAPI - живые плейсхолдеры обратного отсчёта
• Опциональная поддержка Redis для синхронизации таймеров на нескольких серверах
• Оптимизирован и легковесен - минимальное влияние на производительность даже на больших сетях

Установка

1. Скачайте KeyAllZ.jar (версия 3.x.x)
2. Поместите jar-файл в папку /plugins
3. Перезапустите сервер
4. Отредактируйте config.yml под свои нужды
5. Выполните /keyallz reload для применения изменений

Redis (опционально, для нескольких серверов)

KeyAllZ может синхронизировать таймеры между серверами через Redis. Когда эта функция включена:

• Таймеры синхронизируются по всей сети
• Игроки не могут получить награду несколько раз, переключаясь между серверами
• Каждый сервер обрабатывает только своих онлайн-игроков без дублирования
• Таймеры автоматически восстанавливаются после перезапусков или сбоев

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

redis:
  enabled: false
  host: "localhost"
  port: 6379
  password: ""
  database: 0
  # Префикс ключей для Redis. Измените, если используете Redis с другими плагинами.
  key-prefix: "keyallz"
  # Уникальный ID сервера в кластере. Оставьте пустым для авто-генерации.
  server-id: ""

Установите enabled: true и настройте подключение к Redis. Все серверы должны использовать:

• Одно и то же подключение Redis
• Одни и те же названия определений KeyAll

Награды могут различаться на разных серверах.

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

keyalls:
  example:
    title: "<green>Вы получили награду KeyAll!"
    actionbar: "<yellow>Наслаждайтесь бесплатным ключом!"
    chat: "<gray>[KeyAll] <aqua>Поздравляем %player%, вы получили награду!"
    sound: "minecraft:entity.player.levelup"
    sound-volume: 1.0
    sound-pitch: 1.0

    player-commands:
      - "warp crates"
      - "say I just got a key!"

    console-commands:
      - "PLAYER: crate key give %player% test 1"

    permission: "keyall.receive.example"

    reminders:
      enabled: true
      interval: 600
      message: "<yellow>Не забудьте забрать награду KeyAll! Осталось: %remaining-time%"

Плейсхолдеры PlaceholderAPI

• %keyallz_timer_<name>% - полное оставшееся время (например: 1d 2h 10m 5s)
• %keyallz_days_<name>% - оставшиеся дни
• %keyallz_hours_<name>% - оставшиеся часы
• %keyallz_minutes_<name>% - оставшиеся минуты
• %keyallz_secs_<name>% или %keyallz_seconds_<name>% - оставшиеся секунды
• %keyallz_time_short_<name>% - время в формате HH:mm:ss
• %keyallz_remaining_<name>% - сокращённое оставшееся время, например 10m 30s

Для работы плейсхолдеров требуется установить PlaceholderAPI.

Команды

• /keyallz start <definition> <seconds> [loop] - запускает таймер и опционально включает зацикливание
• /keyallz stop <definition> - останавливает работающий таймер
• /keyallz loop <definition> <true|false> - включает или выключает зацикливание
• /keyallz remind <definition> <intervalSeconds> - устанавливает интервал повторяющихся напоминаний
• /keyallz list - показывает все активные таймеры с оставшимся временем
• /keyallz reload - перезагружает конфигурацию и останавливает все таймеры

Примеры использования

• /keyallz start votekey 300 true - запускает таймер votekey на 5 минут и зацикливает его
• /keyallz stop votekey - останавливает таймер votekey
• /keyallz loop donorkey false - отключает зацикливание для donorkey
• /keyallz remind example 30 - отправляет напоминания каждые 30 секунд
• /keyallz list - показывает все активные таймеры
• /keyallz reload - перезагружает конфигурацию плагина

Важно знать

• Консольные команды с префиксом PLAYER: выполняются индивидуально для каждого онлайн-игрока
• Команды игрока и консольные команды выполняются, когда таймер завершается
• Зацикленные таймеры автоматически перезапускаются после завершения
• Напоминания уведомляют игроков с заданным интервалом
• Используйте /keyallz list для мониторинга работающих таймеров

Разрешения

• keyallz.admin - даёт доступ ко всем командам KeyAllZ