Player Persistence Mod

ВАЖНО: Этот мод является API-библиотекой! Для его работы необходим функционирующий сервер PostgreSQL и дополнительное программирование! Не работает как самостоятельное дополнение!

Player Persistence — это компактная библиотека для разработчиков Minecraft серверов, которая предоставляет возможность создания бесперебойного игрового процесса с сохранением состояния игроков между перезапусками сервера и сменой миров. Мод автоматически сохраняет и загружает инвентари игроков, содержимое эндер-сундуков и позиционные данные в базу данных, гарантируя точное сохранение игрового состояния.

Основные возможности:

Оптимизация для Docker и Kubernetes: Упрощенная настройка подключения к базе данных через переменные среды _DB_URL, _DB_USER, _DB_PASS. Для синхронизации координат между серверами разных типов установите переменную _SERVER_NODE с названием вашего сервера.

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

Сохранение эндер-Minecraft-сундуков: Аналогично инвентарям, эта функция сохраняет и загружает содержимое эндер-сундуков, предотвращая потерю ценных предметов игроков.

Синхронизация позиций: Поддержка точных координат игроков и данных о измерениях между перезапусками сервера и даже при переходе между разными серверами. Игроки продолжают игру именно с того места, где остановились.

Интеграция с PostgreSQL: Мод разработан для работы с базами данных PostgreSQL, что делает его идеальным решением для крупных серверных сетей и кастомных настроек, требующих устойчивого хранения данных.

Применение

Этот мод предназначен для использования в качестве базовой библиотеки разработчиками серверов и не добавляет непосредственных игровых функций. Чтобы использовать мод, достаточно интегрировать его в настройки сервера, настроить подключение к базе данных и позволить сисModtem автоматически обрабатывать сохранение игровых данных.

Совместимость

Мод разработан для работы с Fabric API и совместим с последней версией Minecraft. Также он модульный и может быть настроен или расширен разработчиками под конкретные требования сервера.

Как использовать

• Добавьте зависимость в свой проект:

  modApi("maven.modrinth:player-persistence:VERSION")?.let { include(it)}

• Создайте объект PlayerPersistence, например:

  var pp = PlayerPersistence()

• Используйте методы по необходимости

Недостающие функции?

Если вам не хватает какой-то функциональности, создайте issue на GitHub, и мы рассмотрим возможность её добавления.