🎁 PresentsHunt - Охота за подарками

Плагин для Minecraft серверов на Paper 1.21+, который добавляет увлекательную охоту за подарками с разными тематическими режимами. Игроки ищут спрятанные головы-подарки по всему миру и получают награды за их сбор.

✨ Возможности

• 🎄 Тематические режимы: Рождество, Хэллоуин, Пасха и кастомный режим
• 🏆 Система достижений: Игроки собирают подарки для получения наград
• 📊 Leaderboard: Рейтинг игроков с интеграцией PlaceholderAPI
• 🎯 Административные инструменты: Легкое управление и очистка подарков (без необходимости запоминать точное место)
• 🔊 Эффекты: Частицы и звуки при взаимодействии с подарками
• 📝 Конфигурируемые сообщения: Поддержка MiniMessage формата
• 🔧 API интеграция: Поддержка PlaceholderAPI для интеграции с другими плагинами

📥 Установка

Требования

• Minecraft сервер на Paper/Purpur 1.21+
• Java 21 или выше

Шаги установки

1. Скачайте последнюю версию плагина с Releases
2. Поместите файл PresentsHunt.jar в папку plugins/
3. Перезапустите сервер
4. Настройте конфигурационный файл plugins/PresentsHunt/config.yml и примените изменения командой /presentshunt reload
5. Используйте команду /presentshunt give чтобы получить голову-подарок

⚙️ Конфигурация

Основные настройки в config.yml:

# Выбор Режима (HALLOWEEN, CHRISTMAS, EASTER, CUSTOM)
presentsMode: CHRISTMAS

# Сколько подарков надо найти для получения награды
totalPresents: 30

# Команды для каждого найденного подарка и когда игрок находит все
# В этих командах вы можете использовать переменные %player%, %found% и %total%.
commands:
  foundCommands: [ ]
  rewardCommands:
    - "give %player% diamond 10"

leaderboard:
  maxPlayersCount: 100 # Сколько игроков будет храниться в таблице лидеров для отображения позиции в топе

# Музыка при взаимодействии с головой
sounds:
  found: "block.pumpkin.carve"
  alreadyFound: "entity.zombie.ambient"
  complete: "entity.firework_rocket.blast"

# Эффекты при взаимодействии с головой
particles:
  found: "SWEEP_ATTACK"
  alreadyFound: "SQUID_INK"

Текстуры голов

Доступны предустановленные текстуры для каждого режима:

• CHRISTMAS: Новогодний подарок
• HALLOWEEN: Тыква на Хэллоуин
• EASTER: Пасхальное яйцо
• CUSTOM: Кастомная голова (настройте свою текстуру)

🎮 Использование

Для игроков

1. Найдите спрятанные головы-подарки в мире
2. Нажмите ПКМ по голове, чтобы собрать её
3. Собирайте подарки для получения наград
4. Используйте /presentshunt stats для просмотра статистики

Для администраторов

/presentshunt give - Получить голову-подарок
/presentshunt stats - Показать статистику плагина
/presentshunt reload - Перезагрузить конфигурацию
/presentshunt locate [радиус] - Найти подарки в радиусе
/presentshunt cleanup [радиус] - Удалить подарки в радиусе
/presentshunt resetplayer <игрок> - Сбросить данные игрока
/presentshunt resetall - Сбросить данные всех игроков

Размещение подарков

1. Получите голову командой /presentshunt give
2. Установите голову в любом месте мира
3. Голова автоматически помечается как подарок для сбора

📊 PlaceholderAPI

Плагин поддерживает PlaceholderAPI со следующими плейсхолдерами:

%presentshunt_found% - Количество найденных подарков
%presentshunt_total% - Общее количество подарков
%presentshunt_mode% - Текущий режим охоты
%presentshunt_completed% - Количество игроков, завершивших охоту
%presentshunt_players% - Количество игроков с данными
%presentshunt_position% - Позиция в рейтинге
%presentshunt_status% - Статус выполнения (Завершено/В процессе/Не начато)
%presentshunt_top_1_status% - Статус игрока на 1 месте
%presentshunt_top_2_status% - Статус игрока на 2 месте
... и так до 10 места

🔧 Разрешения

presentshunt.use - Использование подарков (по умолчанию: true)
presentshunt.admin - Административные команды (по умолчанию: op)

🐛 Баги и предложения

Нашли баг или есть предложение по улучшению? Создайте Issue на GitHub.

🤝 Вклад в разработку

Хотите помочь с развитием плагина?

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

📄 Лицензия

Этот проект лицензирован под MIT License - смотрите файл LICENSE для деталей.