PlayerSync

PlayerSync - это мод для Minecraft, который решает одну из главных головоломок владельцев серверных сетей: как сделать так, чтобы игроки могли свободно перемещаться между разными серверами, не теряя свой прогресс. Если у вас есть, скажем, хаб, выживание и мини-игры на разных серверах, то без PlayerSync каждый переход - это лотерея: инвентарь сбрасывается, опыт обнуляется, а модовые предметы и вовсе могут исчезнуть. С этим модом всё иначе.

Что делает PlayerSync

Мод использует централизованную базу данных MySQL или MariaDB, чтобы хранить данные игроков. Когда вы заходите на сервер, ваши данные подгружаются из базы. Когда выходите или данные сохраняются - они обновляются. Всё просто и надёжно.

Основные фишки

• Синхронизация инвентаря: Основной инвентарь, броня, эндер-сундук и предметы в оффхенде всегда актуальны на любом сервере.
• Опыт и характеристики: XP, здоровье, еда и очки сохраняются при переходах.
• Достижения: Ваши ачивки и достижения следуют за вами.
• Эффекты зелий: Активные эффекты восстанавливаются при входе на новый сервер.
• Поддержка модов:
  • Curios API: слоты и предметы Curios синхронизируются.
  • Sophisticated Backpacks: содержимое рюкзаков сохраняется.
  • Cobblemon: партия, PC и Podex поддерживаются (только 1.21.1).
  • Aether, Cosmetic-armor-reworked, Apotheosis, Refined-storage, Extra-disks и другие.
  • Любые моды, использующие NeoForge AttachmentTypes.
• Заглушки для предметов: Если модовый предмет отсутствует на сервере, создаётся заглушка, чтобы ничего не потерялось.
• Синхронизация чата (опционально): Можно включить в конфиге, чтобы сообщения передавались между серверами.

Как это работает

PlayerSync хранит все данные игроков в центральной базе MySQL или MariaDB. Когда вы заходите на сервер, данные загружаются из базы. Когда вы выходите или данные сохраняются - они обновляются. Так ваш прогресс всегда актуален, независимо от того, на каком сервере вы играете.

Начало работы

1. Установите мод: Скачайте PlayerSync и поместите его в папку mods каждого сервера, который хотите синхронизировать.
2. Настройте базу данных: Запустите сервер, чтобы сгенерировался конфиг. Отредактируйте файл playersync.toml в папке config, указав данные для подключения к базе. У каждого сервера должен быть уникальный Server_id.
3. Запустите серверы: PlayerSync сам создаст нужные таблицы и начнёт синхронизацию.
4. (Опционально) Включите синхронизацию чата: В конфиге можно активировать передачу сообщений между серверами.

Настройки конфига

Все опции находятся в файле playersync.toml в папке config вашего сервера.

Настройки базы данных

• host - адрес вашего MySQL/MariaDB сервера. По умолчанию: "localhost"
• db_port - порт для подключения к базе. По умолчанию: 3306
• use_ssl - использовать ли SSL для соединения. По умолчанию: false
• user_name - имя пользователя базы данных. По умолчанию: "playersync"
• password - пароль от базы данных.
• db_name - название базы данных. По умолчанию: "playersync"
• Server_id - уникальный идентификатор сервера в сети. У каждого сервера должно быть своё целое число! По умолчанию: генерируется случайно.

Опции синхронизации

• sync_advancements - синхронизировать ли достижения между серверами. По умолчанию: true

Опции сериализации

• use_legacy_serialization - использовать старый формат сериализации (до Base64) для записи данных в базу. Включайте true ТОЛЬКО если у вас есть моды версии ниже 1.35, которые читают ту же базу. По умолчанию: false

Настройки заглушек предметов

• item_placeholder_title_override - переопределить название заглушки (для отсутствующих модовых предметов). По умолчанию: "" (используется стандартный перевод)
• item_placeholder_description_override - переопределить описание заглушки. По умолчанию: "" (используется стандартный перевод)

Важно знать

Что будет, если у меня есть модовые предметы, а я захожу на сервер без этого мода? PlayerSync создаст заглушку, чтобы ваш предмет не пропал. Когда вернётесь на сервер с модом - предмет восстановится.

Безопасны ли мои данные? Да. Все данные хранятся в центральной базе и не теряются при переключении между серверами.

Работает ли это для одиночной игры? PlayerSync создан для сетей серверов. В одиночной игре он не нужен.

Какие моды поддерживаются? Curios API и Sophisticated Backpacks работают из коробки. Поддержка других модов может быть добавлена позже.

Итог

Если вы собираете сеть серверов Майнкрафт и хотите, чтобы игроки могли свободно перемещаться между ними без потери инвентаря, опыта и достижений - PlayerSync это то, что нужно. Мод работает на Forge и NeoForge, поддерживает популярные моды и легко настраивается. Скачайте PlayerSync и забудьте о проблемах синхронизации.