HeadBlocks - Охота за головами

Преврати свой сервер в площадку для захватывающей охоты за сокровищами

1.20 - 1.21+ | Готов к работе на нескольких серверах | Полностью переводимый | Бесплатный и с открытым исходным кодом

Что такое HeadBlocks?

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

Ставь головы где угодно, объединяй их в охоты (hunts), настраивай награды, таблицы лидеров - и наблюдай, как твои игроки с азартом исследуют мир.

Ключевые возможности

Система множественных охот

Создавай неограниченное количество независимых охот - у каждой свой набор голов, правила и прогресс. Можно одновременно запустить охоту на Хэллоуин, рождественский ивент и постоянный челлендж на исследование. Включай, отключай или архивируй охоты когда угодно.

Режимы охоты

• Free (Свободный) - кликай по головам в любом порядке. Классическая охота за сокровищами.
• Ordered (Упорядоченный) - игроки должны находить головы строго в заданной последовательности.
• Scheduled (По расписанию) - охота активируется только в определённый период. Идеально для сезонных ивентов.
• Timed (На время) - режим спидран! Игроки бегут на время от нажимной пластины. Отслеживаются лучшие результаты и показываются таблицы лидеров.

Мощная система наград

Награждай игроков за каждую найденную голову - сообщениями, командами или объявлениями в чат. Настраивай поэтапные цели (например, особая награда за 10, 50, 100 голов). Поддерживается проверка свободных слотов в инвентаре и случайное выполнение команд.

Система подсказок

Помоги игрокам находить головы поблизости с настраиваемыми подсказками:

• Звуковые подсказки - звук воспроизводится, когда игрок в радиусе головы
• Подсказки в action bar - показывают расстояние и направление с настраиваемой стрелкой
• Можно настроить дистанцию обнаружения, кулдаун и включать/отключать подсказки для каждой головы отдельно

Визуальные эффекты

• Голограммы над головами (текст "найдено/не найдено") - встроенные TextDisplay или продвинутый режим через PacketEvents
• Парящие частицы над ненайденными головами (настраиваемые цвета)
• При клике: фейерверки, частицы, звуки, заголовки, сообщения - всё настраивается
• Режим вращения - головы крутятся для лучшей видимости
• Форматирование текста: градиент, радуга, сплошные цвета

Прогресс и таблицы лидеров

• Отслеживание прогресса по каждой охоте и глобально
• Настраиваемые полоски прогресса
• Глобальные и внутриохотные таблицы лидеров (/hb top)
• Лучшие времена и рейтинги для охот на время
• Детальная статистика игроков: найденные головы, пропущенные, процент выполнения

Поддержка нескольких серверов и хранение данных

HeadBlocks готов к работе в сети серверов "из коробки":

• SQLite - без настроек, работает сразу
• MySQL / MariaDB - централизованная база с пулом соединений и SSL
• Redis - синхронизация данных игроков в реальном времени между серверами

Будь у тебя одиночный SMP или целая сеть серверов - HeadBlocks масштабируется без проблем.

Интеграции

• PlaceholderAPI - более 20 плейсхолдеров для скорбордов, голограмм, чата и т.д.
• HeadDatabase - доступ к тысячам текстур голов через hdb:<id>
• PacketEvents - продвинутые голограммы с плейсхолдерами и скрытие найденных голов на стороне клиента

%headblocks_current%              - Найдено голов (всего)
%headblocks_left%                 - Осталось голов (всего)
%headblocks_max%                  - Всего голов
%headblocks_hunt_<id>_found%      - Найдено в охоте
%headblocks_hunt_<id>_total%      - Всего в охоте
%headblocks_hunt_<id>_left%       - Осталось в охоте
%headblocks_hunt_<id>_progress%   - Прогресс % в охоте
%headblocks_hunt_<id>_name%       - Название охоты
%headblocks_hunt_<id>_state%      - Состояние охоты
%headblocks_hunt_<id>_besttime%   - Лучшее время (для охот на время)
%headblocks_hasHead_<uuid|name>%  - Проверка, нашёл ли игрок конкретную голову
%headblocks_order_previous%       - Предыдущая голова в упорядоченной охоте
%headblocks_order_current%        - Текущая целевая голова
%headblocks_order_next%           - Следующая голова в последовательности
%headblocks_leaderboard_<pos>_name%   - Имя игрока в таблице лидеров
%headblocks_leaderboard_<pos>_value%  - Очки в таблице лидеров
%headblocks_leaderboard_position%     - Собственное место игрока

Команды

/hb give <игрок> <*|число>       - Выдать блоки голов
/hb remove [uuid]                  - Удалить голову
/hb removeall [--confirm]          - Удалить все головы
/hb move                           - Переместить голову на новое место
/hb rename <имя>                  - Переименовать голову
/hb list [охота] [страница]        - Список всех голов
/hb info [uuid]                    - Подробная информация о голове
/hb reset <игрок> [--head <id>]   - Сбросить прогресс игрока
/hb resetall [--head <id>]         - Сбросить прогресс всех игроков
/hb hunt create <имя>             - Создать охоту
/hb hunt delete <имя>             - Удалить охоту
/hb hunt enable/disable <имя>     - Включить/выключить охоту
/hb hunt list                      - Список всех охот
/hb hunt info <имя>               - Детали охоты
/hb hunt select <имя>             - Выбрать активную охоту для размещения
/hb hunt assign <критерий> <охота>  - Назначить головы охоте
/hb hunt transfer <uuid> <охота>    - Переместить голову между охотами
/hb hunt reset <имя> <игрок>     - Сбросить прогресс в охоте
/hb options rewards [head]         - Настроить награды (GUI)
/hb options hint                   - Настроить подсказки (GUI)
/hb debug resync <database|locations>  - Пересинхронизировать данные
/hb export database                    - Экспортировать данные в SQL

/hb progress [игрок]              - Посмотреть прогресс
/hb top [число]                   - Глобальная таблица лидеров
/hb hunt top <имя>                - Таблица лидеров охоты
/hb hunt progress <игрок> [охота]  - Прогресс в конкретной охоте
/hb stats <игрок> [охота] [страница]   - Детальная статистика

Права (Permissions)

headblocks.admin              - Доступ ко всем админским командам
headblocks.use                - Взаимодействие с головами (по умолчанию: true)
headblocks.commands.progress  - Использовать /hb progress (по умолчанию: true)
headblocks.commands.top       - Использовать /hb top (по умолчанию: true)

Для разработчиков

HeadBlocks предоставляет события, которые можно слушать из своих плагинов:

• HeadClickEvent - когда игрок кликает по голове
• HeadCreatedEvent - когда голова размещена
• HeadDeletedEvent - когда голова удалена
• HuntCreateEvent - отменяемое, при создании охоты
• HuntDeleteEvent - при удалении охоты
• HuntStateChangeEvent - при включении/выключении охоты

Языки

Полностью переводимый - каждое сообщение можно изменить. В комплекте идёт английский и французский. Переводы от сообщества приветствуются.

Быстрый старт

1. Кинь HeadBlocks.jar в папку /plugins
2. Перезапусти сервер
3. Используй /hb hunt create myFirstHunt чтобы создать охоту и выбрать её
4. Зажми Shift + ПКМ с головой в руке, чтобы разместить её в мире
5. Настрой награды, подсказки и поведение под себя
6. Отпусти игроков исследовать!

Если ты собираешь сервер с ивентами - HeadBlocks практически must-have. Он решает проблему однообразия: вместо скучных квестов у тебя будет живая охота, где игроки сами исследуют мир, соревнуются и получают реальные награды. На слабом железе плагин работает нормально, а на мощных серверах с Redis вообще летает. Короче, если хочешь, чтобы игроки не заскучали - ставь HeadBlocks.