🧩 PlayerDataSync

PlayerDataSync - это плагин для Minecraft, который решает извечную проблему владельцев серверов: синхронизацию данных игроков между разными серверами в сети. Если у вас есть несколько серверов - выживание, лобби, креатив, SkyBlock или мини-игры - этот плагин сделает так, что прогресс игроков будет автоматически переноситься между ними. Никаких ручных переносов файлов, никаких дублированных инвентарей, никакой потерянной статистики.

Обзор

PlayerDataSync хранит все данные игроков в одной общей базе данных. Когда игрок переходит с одного сервера на другой, его инвентарь, опыт, здоровье и другие параметры подгружаются автоматически. С включенным Redis изменения распространяются между серверами мгновенно - ваша сеть ведет себя как единый мир.

Что синхронизируется

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

Категория	Что включает
Предметы	Инвентарь, Эндер-сундук, выбранный слот хотбара
Прогресс	Опыт, уровни, достижения, статистика
Жизненные показатели	Здоровье, поглощение, голод, насыщение, истощение, воздух, огонь, заморозка, стрелы в теле
Состояние	Режим игры, полет, скорость ходьбы и полета, дистанция падения, время и погода игрока
Дополнительно	Атрибуты, Persistent Data Container, баланс Vault
Опционально	Локация (отключена по умолчанию - см. ниже)

О синхронизации локации

Синхронизация локации телепортирует игрока на сохраненную позицию при входе. Она отключена по умолчанию (sync.location: false), потому что имеет смысл только если на целевом сервере есть мир с тем же названием. Если такого мира нет, восстановление пропускается с предупреждением в логе, чтобы не телепортировать игрока в неправильное место.

Больше, чем просто синхронизация

• Redis live sync - мгновенное распространение изменений между серверами
• AES шифрование - защита профилей вашим ключом
• Автоматические бэкапы - сжатые снапшоты перед перезаписью данных
• Миграция хранилища - переход между MySQL, MariaDB, PostgreSQL и MongoDB одной командой
• Импорт из старой версии - перенос профилей из оригинального PlayerDataSync
• Импорт/экспорт - перемещение отдельных профилей игроков
• Discord вебхуки - уведомления об успешной или неудачной синхронизации
• Автосохранение - периодические сохранения для защиты от крашей
• Исключения - пропуск определенных миров или типов предметов
• Метрики bStats и FastStats
• Developer API - события и хуки для ваших плагинов

Зачем это нужно?

Если вы когда-нибудь запускали сеть серверов без синхронизации данных, вы знаете, к чему это приводит:

• Потерянные инвентари
• Дублирование предметов
• Пропавший опыт
• Несогласованный прогресс

PlayerDataSync устраняет эти проблемы автоматически. Игроки просто переходят между серверами, а их данные всегда с ними.

Преимущества

• Один общий профиль игрока на всю сеть
• Мгновенное распространение с Redis
• Четыре варианта баз данных на выбор
• Асинхронная работа - главный поток не блокируется
• Пропуск лишних сохранений, если ничего не изменилось
• Открытый исходный код (MIT) и активная поддержка

Поддерживаемые платформы

Компонент	Поддержка
Minecraft	1.20 - 26.2
Серверное ПО	Paper, Spigot, Fabric, Velocity (мост)
Java	21+ - для Minecraft 26.x требуется Java 25
База данных	MySQL, MariaDB, PostgreSQL, MongoDB

Скачиваемый файл - это плагин для Paper/Spigot. Сборки для Fabric и Velocity находятся внутри в папке bundled/ - извлеките нужную.

Обратите внимание:

• Fabric пока не полностью функционален. Достижения и статистика не синхронизируются на Fabric. Сборки для 1.20 и 1.21 также не поддерживают Эндер-сундук, эффекты зелий и атрибуты; сборки для 26.x уже включают их.
• Forge временно недоступен, пока его инструменты не догонят Minecraft 26.x.
• На Fabric используйте MariaDB, PostgreSQL или MongoDB. Драйвер MySQL не включен, а модлоадеры его не предоставляют. Драйвер MariaDB отлично работает с MySQL серверами. Paper и Spigot не затронуты.
• SQLite не поддерживается.

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

Полная документация: 👉 https://pds.devvoxel.de/config (внешняя ссылка удалена)

• Paper / Spigot: plugins/PlayerDataSyncReloaded/config.yml
• Fabric: config/playerdatasync.properties, создается при первом запуске

storage:
  type: "mariadb"   # mysql, mariadb, postgres, mongodb
  host: "localhost"
  port: 3306
  database: "minecraft"
  username: "root"
  password: ""

redis:
  enabled: true     # настоятельно рекомендуется для мультисерверных сетей
  host: "localhost"
  port: 6379

sync:
  inventory: true
  ender_chest: true
  economy: true     # требует Vault + плагин экономики
  location: false   # телепортация при входе

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

Повседневная работа полностью автоматическая - игрокам не нужно ничего делать. Для администраторов все команды доступны через /playerdatasync (алиасы /pds, /pdasync) с правом playerdatasync.admin.

Команда	Описание
/pds status	Статистика синхронизации, счетчики ошибок, исключенные миры
/pds save <игрок>	Принудительное сохранение игрока
/pds saveall	Сохранить всех онлайн-игроков
/pds load <игрок>	Перезагрузить игрока из хранилища
/pds list	Список сохраненных профилей
/pds backup	Создать бэкап
/pds export / /pds import	Экспорт/импорт профилей
/pds migrate	Миграция между хранилищами
/pds toggle	Включить/выключить синхронизацию на лету
/pds debug on|off	Включить подробное логирование
/pds reload	Перезагрузить конфигурацию

Производительность

• Асинхронные операции с базой данных - главный поток никогда не блокируется
• Пропуск лишних сохранений, если инвентарь не менялся
• Настраиваемый минимальный интервал между сохранениями
• Сжатые бэкапы
• Низкое потребление CPU и памяти

Плагин подходит как для небольших сообществ, так и для крупных сетей.

Требования

• Java 21+ (Java 25 для Minecraft 26.x)
• MySQL, MariaDB, PostgreSQL или MongoDB
• Сервер Paper, Spigot или Fabric
• Несколько серверов с общей базой данных
• Redis (опционально, рекомендуется) - мгновенная синхронизация между серверами
• Vault + плагин экономики (опционально) - для синхронизации экономики