Calendar | Ежедневные награды

Плагин для серверов Minecraft Paper 1.21.8, который автоматически выдает награды игрокам за количество дней входа на сервер в течение месяца. Идеально подходит для повышения ежедневной активности игроков!

📖 Описание

Calendar — это система наград за ежедневные входы, которая работает автоматически. Игрокам не нужно ничего открывать или кликать — награды выдаются сразу при входе на сервер. Плагин отслеживает количество уникальных входов каждого игрока в течение месяца и выдает соответствующие награды.

Ключевые особенности:

• Автовыдача: Награды выдаются мгновенно при входе в игру
• Гибкая настройка: Настройте любые награды за любое количество входов
• Автоматический сброс: Прогресс всех игроков автоматически сбрасывается в начале каждого месяца
• Простой интерфейс: Игроки могут посмотреть свой прогресс и доступные награды через меню

⚙️ Команды

Для всех игроков:

• /calendar — Открывает меню для просмотра календаря наград и своего прогресса

Для администраторов (требуется право calendar.admin):

• /calendar reload — Перезагружает конфигурацию плагина (config.yml, меню, награды)
• /calendar resetall — Сбрасывает количество входов у всех игроков вручную

🔧 Настройка прав (Permissions)

Право	Описание	Кому выдавать
calendar.admin	Дает доступ к административным командам (reload, resetall)	Администраторам

Примечание: Команда /calendar доступна всем игрокам по умолчанию без необходимости выдачи прав.

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

config.yml

prefix: '&#FF0055&lЕжедневный вход &7» '

help:
  - ' '
  - '&#FF0055&lЕжедневный вход &7» '
  - ' &7- &f/calendar reload &7| &#FF0055Перезагрузить плагин'
  - ' '

error:
  too-early: '&#FF3333Вы ещё не можете получить этот подарок!'
  already-claimed: '&#FF3333Вы уже получили этот подарок!'
  requirements-fail: '&#FF3333Вы не можете получить этот подарок!'

reload:
  success: '&#33FF33Плагин успешно перезагружен!'
  failed: '&#FF3333Не удалось перезагрузить плагин! Ошибка в файле &f%file%&#FF3333, проверьте консоль или используйте yaml-валидатор, чтобы исправить ошибки!'

rewards.yml

В этом файле настраиваются награды за определенные дни входа (название и колечество наград может быть любым)

weekday-rewards:
  days:
    - 1-5
    - 8-12
    - 15-19
  commands:
    - give %player% cookie 8
    - give %player% experience_bottle 10
    - money give %player% 500
  message: '&#33AAFFВы получили награду за день %day%!'

saturday-rewards:
  days:
    - 6
    - 13
    - 20
  items:
    - material: DIAMOND
      name: '&#33AAFFАлмаз за вход'
      amount: 3
    - material: ENCHANTED_GOLDEN_APPLE
      name: '&#FFD700Зачарованное золотое яблоко'
      amount: 1
  commands:
    - money give %player% 750
  message: '&#FFAA00Вы получили награду за день %day%!'

sunday-rewards:
  days:
    - 7
    - 14
  items:
    - material: DIAMOND
      name: '&#33AAFFАлмаз за вход'
      amount: 5
  commands:
    - money give %player% 1000
  message: '&#FF00FFВы получили награду за день %day%!'

special-reward:
  days:
    - 21
  items:
    - material: NETHERITE_SCRAP
      name: '&#555555Обломок незерита'
      amount: 2
  commands:
    - give %player% enchanted_book[stored_enchantments={protection:5,sharpness:5,unbreaking:3}] 1
    - money give %player% 50
  message: '&#FFD700&lВы получили супер награду за вход 21 день подряд!'

menu.yml

В этом файле настраивается внешний вид интерфейса календаря. (названия и колечество внутри presents может быть любым)

title: '&0&lКалендарь'
# графический интерфейс может содержать от 1 до 6 строк
rows: 6

# ----- Предметы -----

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: ''
  slot:
    - 0-53

close:
  slot: 49
  material: BARRIER
  name: '&#FF0000&lЗакрыть'
  lore:
    - ''
    - '&#FF0000Нажмите здесь чтобы закрыть!'

presents:
  weekday:
    slot:
      - 1-5
      - 10-14
      - 19-23
    # К каким дням привязан пункт меню
    days:
      - 1-5
      - 8-12
      - 15-19
    # показывается, когда подарок может быть получен
    item-claimable:
      material: PLAYER_HEAD
      texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjJiN2I5ZTA3YzM1MGJjZDY2MmJjZjNmMTYyNGE1OGU5NjVhNzZlYTAxOTE2ZGQzM2M0NzViZDFmYzg2OTQ3YiJ9fX0=
      name: '&#00FF00&lДень %day%'
      lore:
        - ''
        - ' &7- &fЗабирай свой подарок!'
        - '(10 пузырьков опыта, 500 монет, 8 печенек)'
        - ''
        - '&#00FF00Нажмите здесь чтобы получить'
    # показывается, когда подарок уже получен
    item-claimed:
      material: GREEN_STAINED_GLASS
      name: '&#00AA00&lДень %day%'
      lore:
        - ''
        - ' &7- &fВы уже получили этот подарок!'
        - '(10 пузырьков опыта, 500 монет, 8 печенек)'
        - ''
        - '&#00AA00Уже получен'
    # показывается, когда подарок не может быть получен
    item-unclaimable:
      material: YELLOW_STAINED_GLASS
      name: '&#FF3333&lДень %day%'
      lore:
        - ''
        - ' &7- &fПодарок можно открыть в: &#FF9999%time%&f!'
        - '(10 пузырьков опыта, 500 монет, 8 печенек)'
        - ''
        - '&#FF3333Возвращайтесь позже'

Как настроить награды:

В файле rewards.yml в награде укажите дни входа и награды, которые будут выданы при достижении этого количества.

Доступны два формата наград:

1. Выдача через команды

2. Выдача предметов

Важные заметки:

• Используйте плейсхолдер %player% вместо ника игрока в командах
• Поддерживаются любые команды, которые понимает ваш сервер (включая команды от других плагинов)
• Можно использовать оба формата одновременно для разных дней

🖼️ Скриншоты

Интерфейс плагина, где игроки видят свои полученные и будущие награды.

📥 Установка

1. Скачайте последний релиз из раздела Releases
2. Поместите файл .jar в папку plugins вашего сервера
3. Перезагрузите или запустите сервер (/reload или полная перезагрузка)
4. Настройте плагин под свои нужды, отредактировав файлы в папке plugins/Calendar/:
   • config.yml - для настроек сообщений
   • rewards.yml - для настроек наград
   • menu.yml - для настроек интерфейса
5. Используйте /calendar reload для применения изменений

🤝 Поддержка и Баги

Если вы нашли ошибку или у вас есть предложение по улучшению плагина, создайте Issue на странице проекта GitHub.

📜 Лицензия

Этот проект лицензирован под MIT License.