VelocityUtilsPlus (Велосити ютилс плюс)

Плагин для серверов Майнкрафт с прокси Velocity распределяет игроков между лобби, ведёт игровую статистику и помогает модерировать сеть серверов. Он умеет направлять игроков с привилегией на выделенные лобби и серверы испытаний, а также не отправляет игроков на отключённые серверы.

Возможности

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

Команды

• /lobby — перейти в сбалансированное лобби.
• /creator — перейти в лобби для игроков с привилегией.
• /invite <player> — пригласить игрока на текущий сервер.
• /accept — принять приглашение.
• /gban <player> <reason> — выдать глобальный бан.
• /gunban <player> — снять глобальный бан.
• /banlist [page] — открыть список активных банов.
• /stats [player] — посмотреть игровую статистику; без аргумента показывает собственную.
• /leaderboard [limit], /lb, /top — открыть таблицу лидеров; лимит не превышает 50.
• /vup — информация и управление плагином.

Права

Права на команды задаются в разделе [permissions] файла plugins/velocityutilsplus/config.toml. По умолчанию используются:

• vup.premium — /creator;
• vup.admin — /gban, /gunban, /vup;
• vup.moderator — /banlist и просмотр статистики другого игрока через /stats <player>.

Доступ к /lobby, /invite, /accept, собственной статистике и таблице лидеров по умолчанию открыт всем. Пустое значение права в конфиге также открывает команду всем игрокам.

Настройка

В plugins/velocityutilsplus/config.toml в разделе [lobbies] укажите имена обычных лобби в regular_lobbies, а в premium_lobby и premium_challenge — серверы для игроков с привилегией. Имена должны полностью совпадать с именами серверов в velocity.toml, включая регистр букв.

Для статистики и банов через базу данных включите database.enabled, выберите mysql или mariadb и заполните адрес, имя базы, логин и пароль. Плагин создаёт нужные таблицы при первом запуске с включённой базой. Функции учёта времени, статистики и банов включаются в [database.features] ключами playtime_tracking, statistics_tracking и database_bans.

Требования

Нужны прокси Velocity, Java 17 или выше. Возможности, использующие базу данных, требуют MySQL или MariaDB.