Ride On Head

Ride On Head — это легковесный плагин, который дает игрокам возможность садиться на головы друг друга, создавать вертикальные цепочки из игроков и настраивать индивидуальные разрешения.

Ride On Head предоставляет механику взаимодействия, позволяющую игрокам садиться на головы друг другу. Это открывает возможности для создания уникальных игровых ситуаций, таких как строительство живых башен из игроков.

🎯 Основные механики

Для взаимодействия с другими игроками используются следующие действия:

• Наезд: нажмите правой кнопкой мыши по игроку пустой рукой, чтобы сесть ему на голову.
• Спрыгивание: используйте клавишу Shift (присед), чтобы сбросить всех пассажиров.
• Stack-climb: игроки могут перепрыгивать на вершину любой цепочки из стоящих друг на друге игроков (параметр можно настроить в конфигурации).

⚙️ Функциональные возможности

Плагин включает ряд систем для удобного управления взаимодействием:

• Личный переключатель: команда /ride toggle позволяет игрокам мгновенно разрешать или запрещать посадку на себя.
• Система черного списка: команда /ride blacklist <player> добавляет или удаляет игрока из черного списка (работает даже с офлайн-игроками).
• Админ-панель: администраторы могут принудительно менять настройки других игроков, просматривать их черные списки и перезагружать плагин через /ride reload.
• Гибкое хранилище: плагин поддерживает NBT (только для онлайн-сессий), YAML-файлы или базу данных H2 с кэшированием Caffeine.
• Звуковые эффекты: в config.yml можно настроить кастомные звуки посадки и спрыгивания или отключить их (установив значение "none").
• Поддержка MiniMessage: все сообщения используют Adventure API для форматирования.
• Требование седла: если параметр require включен в конфигурации, посадка возможна только на игрока, который экипировал седло в слот шлема.

🌍 Локализация

Плагин автоматически определяет язык игрока на основе локали клиента. Если перевод существует, игрок видит сообщения на своем языке; в противном случае используется стандартный язык из конфигурации.

Встроенные переводы доступны для:

• Английского (en), русского (ru), украинского (uk), немецкого (de), французского (fr), испанского (es) и упрощенного китайского (zh).

Пользовательские переводы можно добавить, поместив .yml файл в папку plugins/RideOnHead/lang/. Если оставить ключ сообщения пустым в файле языка, сообщение не будет отображаться.

📋 Команды и права доступа

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

Подробные комментарии внутри файла config.yml сопровождают все настройки, включая параметры хранения данных, звуков, языка и поведения при прыжках по цепочкам игроков (stack-climb).