VToolbox (Ви тулбокс)

Плагин для серверов Майнкрафт на прокси Velocity, который объединяет управление плагинами, диагностику подключений и правила допуска игроков по версии клиента. Также он умеет раздавать ресурс-паки с компьютера прокси и рассчитывать их SHA-1-хеши.

Возможности

• Загружает, выгружает и перезагружает JAR-файлы плагинов из папки plugins/ без перезапуска прокси.
• Показывает зависимости, зарегистрированные ресурсы и возможные риски выгрузки плагина.
• Не позволяет выгрузить плагин, от которого зависит другой загруженный плагин, и сообщает об очистке слушателей, задач, команд, каналов сообщений, исполнителей и загрузчиков классов.
• Группирует игроков по домену и порту, через которые они вошли, с количеством игроков, пингом и IP-адресами для диагностики.
• Задаёт для каждого сервера диапазоны, белые и чёрные списки версий клиентов без ViaVersion.
• Раздаёт локальные ZIP-архивы ресурс-паков по HTTP, создаёт ссылки и SHA-1-хеши для каждого файла.
• Имеет сообщения на китайском и английском языках с форматированием MiniMessage.

Команды

Основная команда — /vtoolbox, также доступна короткая форма /vtb.

• /vtoolbox help — показать справку.
• /vtoolbox info — сведения о плагине, прокси, Java, правилах версий серверов и раздаче паков.
• /vtoolbox packs — ссылки и SHA-1-хеши раздаваемых паков.
• /vtoolbox vhosts — игроки, сгруппированные по домену и порту входа.
• /vtoolbox reload — перечитать язык, конфиг, правила версий и настройки раздачи паков.
• /vtoolbox plugin list — список загруженных плагинов.
• /vtoolbox plugin inspect plugin-id — сведения, зависимости, ресурсы и риски выгрузки указанного плагина.
• /vtoolbox plugin load file.jar — загрузить JAR из plugins/.
• /vtoolbox plugin unload plugin-id — выгрузить плагин.
• /vtoolbox plugin reload plugin-id — перезагрузить плагин.

Права

velocitytoolbox.admin даёт полный доступ. Для раздельной выдачи прав сначала нужен velocitytoolbox.command, затем право нужной команды:

• velocitytoolbox.command.info
• velocitytoolbox.command.packs
• velocitytoolbox.command.vhosts
• velocitytoolbox.command.reload
• velocitytoolbox.command.plugin
• velocitytoolbox.command.plugin.list
• velocitytoolbox.command.plugin.inspect
• velocitytoolbox.command.plugin.load
• velocitytoolbox.command.plugin.unload
• velocitytoolbox.command.plugin.reload

Например, для просмотра сведений о плагинах нужны velocitytoolbox.command, velocitytoolbox.command.plugin и velocitytoolbox.command.plugin.inspect.

Настройка

Правила версий настраиваются в разделе server-versions файла config.yml; изменения применяются командой /vtoolbox reload.

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

pack-host:
  enabled: false
  bind: 0.0.0.0
  port: 8765
  public-url: ""
  packs-directory: packs

Поместите ZIP-архивы в plugins/VelocityToolbox/packs/, включите enabled: true и выполните /vtoolbox reload. В public-url укажите адрес, доступный игрокам из интернета. Плагин раздаёт и описывает файлы, но не назначает их игрокам: для этого подходит VelocityResourcepacks. Прокси не настраивает правила файрвола, проброс портов, DNS и HTTPS.

Выгрузку сторонних плагинов стоит предварительно проверять: Velocity не предоставляет публичного интерфейса для безопасной загрузки и выгрузки. Плагины прав, пакетов, соединений или с большим объёмом данных в памяти лучше обновлять с полным перезапуском прокси.

Требования

Нужны прокси Velocity и Java. Зависимости не требуются; для назначения раздаваемых паков игрокам и использования созданного списка паков нужен VelocityResourcepacks.