Whack Me (Вак ми)

Плагин для серверов Майнкрафт с мини-игрой на скорость для одного игрока. Участник за ограниченное время бьёт появляющиеся блоки: зелёные приносят очки и увеличивают серию, а красные отнимают очко и сбрасывают серию.

Возможности

• Блоки поднимаются, задерживаются на высоте и опускаются в заданных точках арены; число одновременно видимых блоков и скорость их движения настраиваются отдельно для каждой арены.
• Для зелёных, красных и уже ударенных серых блоков можно назначить обычные блоки, головы игроков или предметы с собственными данными.
• Во время раунда выводятся таймер, очки, серия и точность через таблицу счёта, босс-бар и строку действий.
• После игры игрок видит итоговые очки, личный рекорд, лучшую серию, количество верных и ошибочных ударов, точность и результат идеального прохождения.
• Плагин ведёт личные рекорды, рекорды арен, число сыгранных игр, идеальных прохождений и все удары. Встроенные таблицы лидеров сортируют игроков по очкам, сериям, идеальным играм и общему числу ударов.
• Инвентарь, броня, эффекты, голод и прочее состояние игрока сохраняются перед раундом и восстанавливаются после него.
• Арена защищается от изменения блоков, урона, использования предметов, лишних команд и помех в чате.
• За вход, выход, завершение игры и удар по блокам можно выполнять команды от имени консоли или игрока с подстановками игрока, арены, очков, серии и типа блока.
• Данные хранятся в локальных файлах или MySQL.

Команды

Игрокам доступны:

• /wm join <arena> — войти на свободную зарегистрированную арену.
• /wm leave — покинуть текущую игру.
• /wm stats [player] — открыть статистику свою или указанного игрока.

Управление аренами:

• /wm create <arena_id> — создать арену.
• /wm delete <arena_id> [--confirm] [--cancel] — удалить арену с подтверждением.
• /wm list — показать список арен.
• /wm edit <arena_id> — открыть внутриигровое меню настройки арены.

Администратору также доступны /wm reload, /wm stop [arena] и /wm kick <player>. Полная команда плагина — /whackme или /wm.

Права

• whackme.arena.* — полный доступ к созданию и настройке арен.
• whackme.arena.create, whackme.arena.delete, whackme.arena.list, whackme.arena.edit — отдельные права для соответствующих действий с ареной.
• whackme.command.help — справка по командам.
• whackme.admin.reload — перезагрузка настроек.
• whackme.admin.stop — принудительная остановка игры.
• whackme.admin.kick — исключение игрока из игры.
• whackme.sign.break — разрушение табличек входа на арену.
• whackme.cooldown.bypass — обход задержки перед повторной игрой.
• whackme.commandblock.bypass — использование неограниченных команд во время игры.
• whackme.debug — доступ к отладочным командам при включённом debug: true в config.yml.

Настройка

Арена создаётся через /wm create <arena_id>, а затем настраивается в меню /wm edit <arena_id>. Для регистрации нужны стартовая и конечная точки, а также хотя бы одна точка появления блоков.

Точки появления можно получить автоматически, окружив стартовую позицию восемью рамками портала в энд, или расставить вручную в режиме редактирования. Чем больше одновременно активных блоков, тем выше нагрузка на игрока и обзор арены.

В меню арены задаются:

• минимальное и максимальное число активных блоков;
• шаг и предельная скорость вертикального движения;
• время ожидания блока на верхней точке;
• период проверки появления новых блоков;
• асинхронное движение блоков;
• внешний вид зелёных, красных и серых состояний;
• таблица счёта и босс-бар для конкретной арены;
• музыка, рекорд арены и табличка входа.

Игрок может войти командой /wm join <arena_id> либо нажатием правой кнопкой мыши по зарегистрированной табличке. Каждая арена принимает только одного игрока одновременно.

Для вывода статистики в других плагинах используются плейсхолдеры PlaceholderAPI, например %wm_local_score%, %wm_record_score%, %wm_games_played% и %wm_arena:<arena_id>:score%. Таблицы лидеров доступны через шаблон %wm_leaderboard:<statistic>:<position>:<name|uuid|value>%.

Требования

Для музыки на арене нужен NoteBlockAPI; файлы песен формата .nbs размещаются в /plugins/WhackMe/musics/. Для плейсхолдеров требуется PlaceholderAPI. MySQL используется как альтернативное хранилище статистики.