Player Persistence Mod

ВНИМАНИЕ: Для работы мода требуется настроенный PostgreSQL сервер!

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

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

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

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

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

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

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

Технические особенности

Мод создан как инструмент для серверных разработчиков и не добавляет видимых игровых элементов. После интеграции в сборку сервера и настройки подключения к базе данных библиотека автоматически обрабатывает сохранение данных игроков.

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

Библиотека работает на платформе Fabric API и совместима с последними версиями Minecraft. Модульная архитектура позволяет разработчикам адаптировать и расширять функционал под конкретные требования сервера.

Отсутствует нужная функция? Создайте запрос на GitHub, и мы рассмотрим возможность ее реализации.

Порядок использования

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

include("maven.modrinth:playerpersistence:0.0.2")?.let { modImplementation(it) }

Создайте объект PlayerPersistence:

var pp = PlayerPersistence()

Используйте предоставленные методы по вашему усмотрению. Удачного программирования!