MC-Data-Bridge

MC-Data-Bridge — высокопроизводительный плагин для синхронизации данных игроков в сетях Minecraft с использованием распределенных блокировок и атомарного сохранения.

MC-Data-Bridge — это гибридный плагин для платформ PaperMC (и форков, таких как Purpur), Folia, Spigot, Bukkit, а также прокси-серверов BungeeCord (включая Waterfall) и Velocity. Он обеспечивает автоматическую синхронизацию данных игроков между связанными серверами, используя систему распределенных блокировок, атомарное сохранение транзакций и систему уведомлений на основе событий.

Основные возможности синхронизации

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

• Здоровье, уровень голода, насыщение и истощение
• Опыт и прогресс достижений
• Инвентарь, броня и эффекты зелий
• Эндер-сундуки и рецепты
• Ванильная статистика
• Метаданные Persistent Data Container (PDC)
• Статус полета и выбранного игрового режима
• Сопровождающие питомцы
• Кросс-серверные карты и профили инвентаря для разных режимов

Технологические особенности и безопасность

Для обеспечения целостности данных и предотвращения эксплойтов плагин использует ряд продвинутых механизмов:

• Защита от дублирования предметов: автоматически закрывает открытые инвентари и отменяет взаимодействия с контейнерами во время блокировок при передаче.
• Распределенные блокировки (Distributed Lock Fencing): использование счетчиков lock_version защищает от записи устаревших данных при задержках сети или паузах сборщика мусора (GC).
• Атомарное сохранение: объединяет обновления компонентов (инвентари, статистика, метаданные, карты) и освобождение блокировок в одну транзакцию базы данных.
• Проверка целостности: вычисление хешей SHA-256 для компонентов состояния игрока с использованием соли security.seed перед загрузкой.
• Отслеживание личности: хранение last_known_name и хеша identity_hash (Keyed HMAC-SHA256) для обнаружения кражи личности или манипуляций с БД.
• Поддержка многопоточности Folia: использование региональных планировщиков (GlobalRegionScheduler, EntityScheduler) для обеспечения потокобезопасности.

Инструменты администратора

Администраторы могут взаимодействовать с данными игроков через специальные инструменты и мониторинг:

Интерактивный инспектор инвентаря и эндер-сундуков (invsee / endersee) позволяет просматривать данные офлайн-игроков или игроков на других серверах в реальном времени. По умолчанию включен безопасный режим просмотра, но администраторы могут использовать флаг --edit или правую кнопку мыши для интерактивного редактирования с автоматическим сохранением в БД.

Мониторинг производительности: встроенный HTTP-сервер экспортирует метрики синхронизации (задержки, коэффициенты попадания в кэш, статус пула HikariCP) для использования в дашбордах Grafana через Prometheus.

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

Настройка и режимы идентификации

Плагин поддерживает различные схемы идентификации игроков и гибкое управление синхронизацией:

• Режимы идентификации: переключение между строгим соблюдением UUID (PREMIUM) и гибким смещением идентичности (HYBRID).
• Автоматическая миграция: данные игроков автоматически переносятся с офлайн-UUID на премиум-UUID при проверке через FastLogin (PreLogin) или AuthMe (Login, включая 2FA).
• Гранулярный контроль: возможность включать/выключать синхронизацию конкретных типов данных или исключать определенные серверы и миры в config.yml.

Для работы в многосерверной сети требуется настройка MySQL или MariaDB. В конфигурации на каждом бэкенд-сервере необходимо указать уникальный server-id (например, server-id: "survival-1") и секретный ключ в security.seed.