DailyStreak — это инновационный плагин для PaperMC, который добавляет систему ежедневных достижений и "огонька" на твой сервер. Вдохновленный популярной функцией TikTok, этот плагин мотивирует игроков заходить на сервер каждый день и создает ощущение прогресса и достижений.

• 🔥 Система "Огонька" — отслеживание ежедневной активности
• 📊 Таблица лидеров — соревнование среди игроков
• 🎁 Награды за серии — поощрение верности игроков
• 💾 Персистентные данные — сохранение прогресса между сеансами
• ⚙️ Полная конфигурация — настрой под свой сервер
• 🌍 Русская локализация — полная поддержка русского языка
• 📈 Статистика и аналитика — отслеживание прогресса игроков
• 🎨 Красивый интерфейс — визуальное отображение "огонька"

• Java: 11 или выше
• PaperMC: Latest версия рекомендуется
• Права администратора на сервере

1. Скачай последнюю версию плагина (.jar файл)
2. Положи файл в папку plugins/ твоего сервера
3. Перезагрузи сервер командой /reload или перезапусти его
4. Плагин готов к работе!

# Перезагрузка конфигурации
/reload

/streak                    # Показать свой огонек и статистику
/streak <ник>              # Показать огонек другого игрока
/streak top                # Топ-10 игроков по "огоньку"
/streak help               # Справка по командам

Примеры:

/streak                    # Показать мой огонек
/streak PlayerName         # Показать огонек игрока PlayerName
/streak top                # Показать лидеров сервера

Плагин автоматически отслеживает:

• ✅ Вход игрока на сервер (каждый день)
• ✅ Время активности в игре
• ✅ Сохранение серии "огонька"
• ✅ Обнуление серии при пропуске дня

После первого запуска плагина в папке plugins/DailyStreak/ будет создан файл config.yml.

# Основные настройки
settings:
  # Включить плагин
  enabled: true
  
  # Часовой пояс сервера (UTC, UTC+1, UTC+3 и т.д.)
  timezone: "UTC+3"
  
  # Время сброса "огонька" каждый день (часы:минуты)
  reset-time: "00:00"
  
  # Требуемое время онлайна для сохранения серии (в минутах)
  min-playtime: 10

# Награды за серии
rewards:
  # Награда за 7-дневную серию
  7-day: 100
  # Награда за 30-дневную серию
  30-day: 500
  # Награда за 365-дневную серию
  365-day: 5000

# Сообщения (кастомизация)
messages:
  prefix: "&8[&f⭐ DailyStreak&8]"
  
  # Поздравление при входе
  welcome: "&aДобро пожаловать! Твой огонек: &f{streak}🔥"
  
  # Сообщение при пропуске дня
  streak-lost: "&cТы потерял свой огонек! Начни заново с дня 1"
  
  # Сообщение при получении награды
  reward-earned: "&6🎁 Ты получил награду за &f{days}&6 дневную серию!"

# База данных
database:
  # Тип: SQLite, MySQL, PostgreSQL
  type: "SQLite"
  
  # MySQL/PostgreSQL (если используется)
  host: "localhost"
  port: 3306
  name: "minecraft"
  user: "root"
  password: "password"

Отредактируй файл под свои нужды и используй /streak reload для применения изменений.

dailystreak.use              # Базовое использование команды /streak
dailystreak.view-others      # Просмотр огонька других игроков
dailystreak.view-top         # Просмотр таблицы лидеров
dailystreak.admin            # Администраторские команды
dailystreak.reload           # Перезагрузить конфигурацию
dailystreak.reset            # Сбросить огонек игрока

/lp user <username> permission set dailystreak.use true
/lp user <username> permission set dailystreak.view-others true
/lp user <username> permission set dailystreak.view-top true

1. День 1 🔥 — Игрок заходит в первый раз
2. День 2 🔥🔥 — Игрок заходит в следующий день
3. День 3 🔥🔥🔥 — И так далее...
4. Пропуск дня ❌ — Огонек обнуляется, начинаем с 1 🔥

• 7 дней подряд → Получи награду (стандартно 100 монет/очков)
• 30 дней подряд → Большая награда (500 монет/очков)
• 365 дней подряд → Легендарная награда (5000 монет/очков)

Награды настраиваются в конфиге

/streak reset <player>       # Сбросить огонек игрока
/streak set <player> <дни>   # Установить огонек игроку
/streak reload               # Перезагрузить конфиг
/streak stats <player>       # Показать полную статистику игрока

1. Проверь, что файлы сохраняются в папке plugins/DailyStreak/
2. Убедись, что база данных работает корректно
3. Проверь права доступа к папке плагина

• Проверь разрешения (dailystreak.use)
• Убедись, что плагин включен в config.yml (enabled: true)
• Перезагрузи плагин: /reload

• Проверь, что установлены значения наград в config.yml
• Убедись, что система экономики установлена (Vault + EssentialsEco)
• Проверь логи плагина на ошибки

Проект использует Semantic Versioning:

• MAJOR — несовместимые изменения
• MINOR — новые функции, совместимые с предыдущими версиями
• PATCH — исправления ошибок

Мы приветствуем любые улучшения! Если хочешь помочь:

1. Форк репозитория
2. Создай ветку для твоей функции (git checkout -b feature/AmazingFeature)
3. Закоммитай изменения (git commit -m 'Add some AmazingFeature')
4. Запуши ветку (git push origin feature/AmazingFeature)
5. Открой Pull Request

Подробнее см. CONTRIBUTING.md

Проект распространяется под лицензией MIT. Подробнее см. файл LICENSE.

Ключевые моменты:

• ✅ Можешь использовать в коммерческих целях
• ✅ Можешь модифицировать
• ✅ Можешь распространять
• ❌ Обязателен указание авторства и лицензии

Mukller
GitHub: @Mukller

Если у тебя возникли вопросы или ты нашел баг:

1. Проверь Issues — может быть уже есть решение
2. Создай новую Issue с подробным описанием
3. Укажи версию плагина и PaperMC

При создании Issue укажи:

Версия плагина: X.X.X
Версия PaperMC: X.X.X
Java версия: 11/17/21
Описание проблемы: ...

• PaperMC Документация
• Bukkit API
• SpigotMC (скачивание плагинов)
• Vault (для экономики)

• ⚡ Легкий и быстрый — не нагружает сервер
• 🔐 Безопасный — защита от читерства и манипуляций
• 📱 Мобильно-ориентированный — вдохновлен современными трендами
• 🎯 Геймификация — мотивирует игроков возвращаться