VelocityScoreboardAPI

Плагин VelocityScoreboardAPI для Minecraft 1.21.11

VelocityScoreboardAPI — это плагин-посредник для прокси серверов Velocity, который предоставляет стандартизированный API для работы с табло игроков (scoreboard) и командами (teams). Он устраняет необходимость в прямом взаимодействии с внутренними API Velocity, предоставляя разработчикам стабильный интерфейс для создания плагинов, меняющих отображение информации у игроков. Плагин не добавляет игровых функций самостоятельно, а служит фундаментом для других расширений.

Архитектура табло: прокси и бэкенд

Плагин реализует концепцию двойного табло для каждого игрока. Первая часть — это бэкенд-табло (backend scoreboard), которое является только для чтения и автоматически отражает команды и объективы, поступающие от серверов бэкенда. Вторая часть — табло прокси (proxy scoreboard), которое полностью редактируемо через API. Объективы и команды на табло прокси имеют приоритет над данными бэкенда, что позволяет плагинам безопасно изменять отображение информации, не нарушая целостности данных, приходящих от игровых серверов. Каждый игрок имеет собственную инстанцию табло прокси.

Событийная система и обновления

Для синхронизации данных плагин предоставляет систему событий. События генерируются при регистрации или удалении объектива, создании или удалении команды, а также при добавлении или удалении игрока из команды. Эти события можно отключить в конфигурации. Кроме того, все методы обновления свойств поддерживают интерфейс Consumer. Это позволяет выполнять множественные изменения за один пакет данных вместо отправки отдельного пакета на каждое изменение, что значительно снижает нагрузку на сеть и сервер.

Работа с текстом и совместимость версий

Для гибкой настройки отображения текста плагин использует собственный класс TextHolder. Он позволяет явно определять значения для устаревшего формата текста (legacy) и современного формата компонентов (modern). Если одно из значений не указано, оно автоматически рассчитывается в зависимости от версии клиента. Это избавляет разработчиков от необходимости проверять версию клиента вручную для каждого текста.

Производительность и защита от ошибок

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

Конфигурация и требования

Файл конфигурации config.yml генерируется автоматически при первом запуске. Основные настройки включают возможность отправки событий табло (call_scoreboard_events) и логику предупреждений о некорректных пакетах (print_invalid_downstream_packet_warnings). Для работы плагина требуется версия Java 21 и прокси Velocity версии 3.5.0 build 604 или новее.

Связанные материалы

• BetterStructures — похожий плагин
• CommandPanels — похожий плагин

Автор: alexdev03 · Автор: NEZNAMY · Лицензия: Apache-2.0