SoulKeeper

SoulKeeper - это продвинутый плагин для Майнкрафт (а также мод для Forge и NeoForge), который полностью меняет механику потери вещей после смерти. Никто не любит терять алмазную броню в лаве или свой опыт в Энде. Этот плагин решает проблему раз и навсегда: в момент смерти весь ваш инвентарь и часть опыта захватываются в светящуюся душу, которая остается висеть на месте гибели.

Если вы планируете поиграть с друзьями онлайн, SoulKeeper легко установится на ваш сервер за 1 клик на BungeeHost (https://bungee.host), так как это серверный проект, который не требует установки на стороне клиента.

Как это работает в игре

В момент гибели плагин перехватывает эвент смерти до того, как вещи вообще успеют упасть на землю. Инвентарь и опыт упаковываются в базу данных, а на месте появляется облако частиц с табличкой "Soul of <Ваш ник>".

Подбирать душу предельно просто - достаточно просто подойти к ней вплотную. Никаких правых кликов или приседаний. Как только вы войдете в радиус, начнется передача:

• Если инвентарь полный, опыт впитается первым, а вещи поместятся по слотам. Остаток останется в душе.
• Душа не исчезнет, пока вы не освободите место. Вы можете сбегать в базу, разгрузиться и вернуться.

Жизненный цикл души тоже продуман. Сначала она приватная - только владелец может ее забрать. Через настраиваемое время (по умолчанию 2 дня) она становится публичной, и любой игрок на сервере сможет подобрать ваш лут. А через 14 дней душа навсегда исчезает. Все это делают фоновые процессы, сервер перезагружать не нужно.

Система бэкапов Krates

Каждая смерть создает YAML-снапшот (Krate) на диске, независимо от основной базы данных. Это ваша страховка на случай, если SQLite базу повредит или откатит.

Если БД упала, админ может восстановить вещи игрока напрямую из файла командой /soulkrate <uuid> <epoch> <index>. Предметы просто появятся в инвентаре. Максимально надежно.

Технические фишки и оптимизация

SoulKeeper написан на Kotlin с использованием корутин. Все тяжелые операции - запись в БД, поиск игроков рядом с душой, сохранение - работают в фоновых потоках. Главный поток сервера не трогается, так что TPS не просядет даже при массовых смертях.

Таблички с именами душ реализованы через PacketEvents как виртуальные сущности. В мире не появляются реальные Armor Stand'ы, которые грузят сервер.

Души в Энде имеют ограничение по высоте (endLocationLimitY), чтобы они не провалились в пустоту и не стали недоступными.

Настройка и команды

Конфиг живет в config.yml и перезагружается на лету через /skreload. Можно настроить:

• Сколько XP сохранять (retained_xp от 0.0 до 1.0).
• Радиус, в котором душа начинает издавать звуки и спавнить частицы, чтобы вы могли найти ее в темноте.
• Поведение при PvP-смерти (можно отключить создание души при убийстве игроками, или сохранять только опыт).

Основные команды:

• /souls [page] - список ваших душ с координатами и возрастом. Админы видят кнопки для мгновенного освобождения души и телепортации к ней.
• /skreload - горячая перезагрузка конфига.
• /soulkrate <uuid> <epoch> <index> - восстановление из бэкапа.

Совместимость и платформы

Проект мультиплатформенный. Доступен для Paper/Spigot, а также в виде модов для Forge и NeoForge (версии 1.21.1+). Выбирайте нужный jar-файл и закидывайте в папку.

Важный нюанс: Плагины, которые сильно модифицируют или отменяют PlayerDeathEvent (например, какие-нибудь кейсы или антигриф-системы), могут мешать созданию души. Если вещи после смерти не сохраняются, проверьте конфликт с другими плагинами на эвенты смерти.

Скачайте SoulKeeper для Minecraft, если устали терять ценный лут из-за случайных смертей в лаве или от падения в пустоту. Это must-have для пвп-серверов и сложного выживания.