SlashLoot

SlashLoot

Персональный лут для каждого игрока в естественно сгенерированных сундуках, бочках, шалкеровых ящиках и вагонетках — только на стороне сервера, клиенту ничего устанавливать не нужно. Каждый игрок, открывающий естественно сгенерированный контейнер, получает свою личную копию лута. Открываешь сундук в шахте — получаешь свой ролл; друг открывает тот же сундук — получает отдельный ролл. Больше не нужно гонять наперегонки по данжам, и никто не приходит к уже опустошённому сундуку. Контейнеры, которые ты поставил сам, никогда не затрагиваются — сундуки, бочки и шалкеровы ящики, которые ты построил, ведут себя точно как в ванилле. Fabric, NeoForge и Forge 1.20.1.

Только на стороне сервера — игрокам ничего устанавливать не нужно

SlashLoot работает полностью на сервере. Игроки подключаются с обычным ванильным Fabric или NeoForge: мод они не устанавливают и не обязаны обновлять его вместе с тобой. SlashLoot никогда не заменяет блок или его block-state, поэтому контейнер всегда остаётся настоящим minecraft:chest (или бочкой, шалкером, вагонеткой и т.д.). Предикаты датапаков, запросы /data, селекторы скорбордов и сохранения структур продолжают видеть обычные ванильные блоки.

Возможности

• Инстансный лут для каждого игрока в естественно сгенерированных контейнерах. Одно открытие = один личный ролл.
• Сохраняется между перезапусками сервера. Личный лут каждого игрока сохраняется отдельно для каждого измерения.
• Стабильно при повторном открытии. Закрой меню с оставшимися внутри предметами — они будут там в следующий раз.
• Контейнеры, поставленные игроком, не затрагиваются — полное ванильное поведение для всего, что ты построил.
• Поддержка двойных сундуков. Каждая половина отслеживает личный лут независимо; открытие любой половины показывает объединённый вид на 54 слота.
• Ванильные крышки, звуки и редстоун. Крышки сундуков и шалкеров анимируются, бочки открываются, а сундуки-ловушки по-прежнему выдают редстоун-сигнал.
• Ванильная точность и в мелочах. Запертые сундуки/бочки/шалкеры остаются запертыми, шалкеровый ящик, перекрытый блоком спереди, остаётся закрытым, переименованные контейнеры сохраняют своё название в личном меню, открытие контейнера продвигает ванильное достижение и статистику лута, а пиглины поблизости по-прежнему злятся на охраняемый контейнер — всё точно как в ванилле, хотя каждое открытие идёт через собственное меню SlashLoot.
• Меню закрываются когда нужно. Если отойти или если настоящий контейнер уничтожен, пока ты смотришь на его копию, меню закрывается — в соответствии с ванильным поведением по дистанции/валидности.
• Настраивается. Блоклисты по измерениям и по таблицам лута для совместимости с приключенческими картами — контейнеры из блоклиста откатываются к обычному ванильному общему луту.
• Дружит с другими модами. Gilded Chests из Cobblemon (все семь настоящих цветовых вариантов) распознаются из коробки как настоящие персональные контейнеры; любой другой нераспознанный модовый контейнер всё ещё можно подключить широко, а опциональное отладочное логирование точно скажет, что SlashLoot решил по каждому из них.
• Самообслуживание. Сохранённый лут очищается при уничтожении контейнера, а фоновая чистка удаляет запись только когда её контейнер действительно исчез — никогда просто из-за изменения конфига или блоклиста.
• Админ-команды для просмотра и очистки личного лута, когда это нужно.

Поддерживаемые контейнеры

• Сундуки, сундуки-ловушки, бочки, шалкеровы ящики
• Вагонетки с сундуком, вагонетки с воронкой, лодки с сундуком
• Двойные сундуки (объединённый вид на 54 слота)
• Gilded Chests из Cobblemon (все настоящие цветовые варианты — сундук-мимик Gimmighoul намеренно не затрагивается)

Установка

1. Положи JAR, соответствующий версии Minecraft и загрузчику, в папку mods/ твоего сервера.
2. На Fabric положи туда же соответствующую версию Fabric API. NeoForge и Forge ничего дополнительно не требуют.
3. Перезапусти сервер. Вот и всё. Клиенты подключаются с немодифицированной игрой — на их стороне ничего устанавливать не нужно.

Поддерживаемые версии

25 JAR-файлов — 13 Fabric, 11 NeoForge, 1 Forge. Выбери тот, что соответствует версии Minecraft и загрузчику твоего сервера — файлы называются `slashloot-+mc-.jar. Сборкам Fabric нужен Fabric API указанной версии; сборкам NeoForge и Forge ничего кроме загрузчика не нужно. **Forge только для 1.20.1.** Тот же JAR с -forge` также работает на NeoForge 1.20.1, так что серверы на NeoForge 1.20.1 тоже используют его. Покрытие NeoForge немного отличается: у NeoForge нет собственной линейки 1.20.5 и нет стабильных сборок 21.6 / 21.7 / 21.9, поэтому MC 1.21.6–1.21.8 и 1.21.9–1.21.10 покрываются сборками 21.8 и 21.10. Линейки 26.1.2, 26.2 и 26.3 выпускаются для обоих загрузчиков.

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

При первом запуске создаётся файл config/slashloot.json:

{
  "enabled": true,
  "dimensionBlocklist": [],
  "lootTableBlocklist": [],
  "handleUnknownContainers": false,
  "delegateContainerAnimation": true,
  "playOpenCloseSounds": true,
  "cleanupOnBreak": true,
  "pruneIntervalTicks": 6000,
  "pruneBatchSize": 256,
  "debugLogging": false
}

• enabled — главный переключатель. false делает SlashLoot неактивным; каждый контейнер ведёт себя как в ванилле.

• dimensionBlocklist — измерения (например, "minecraft:the_nether"), обслуживаемые обычным общим ванильным лутом.

• lootTableBlocklist — таблицы добычи (например, "minecraft:chests/buried_treasure"), которые нужно пропускать. Полезно для приключенческих карт с намеренно общим лутом.
• handleUnknownContainers — создавать отдельные экземпляры для модовых контейнеров, которые SlashLoot не распознаёт специально. По умолчанию выключено: оставлять неизвестные модовые контейнеры ванилле — совместимый выбор. (Настоящие Gilded Chests из Cobblemon распознаются в любом случае — это влияет только на контейнеры без встроенного распознавания.)
• delegateContainerAnimation — передавать открытие/закрытие настоящему контейнеру, чтобы крышки анимировались, бочки открывались, а сундуки-ловушки выдавали редстоун-сигнал. Оставьте включённым, если только какой-то мод не конфликтует.
• playOpenCloseSounds — ручной звук открытия. Используется только когда delegateContainerAnimation равно false (при включённой передаче звук проигрывает ванилла).
• cleanupOnBreak — выбрасывать сохранённый лут контейнера при его разрушении.
• pruneIntervalTicks / pruneBatchSize — фоновая очистка, которая удаляет записи для контейнеров, которых больше не существует. 0 отключает её.
• debugLogging — писать по одной строке на контейнер с его позицией, таблицей добычи и тем, создал ли SlashLoot отдельный экземпляр или откатился к ванилле, с указанием причины. Сделано для тестирования совместимости модпаков. Отсутствующие ключи принимают значения по умолчанию, поэтому конфиг от старой версии продолжает работать. /slashloot reload перечитывает файл без перезапуска.

Админ-команды

Все требуют уровень разрешений 2 (op).

Известные ограничения

• Воронки не вытягивают из контейнеров с отдельными экземплярами. Мировой контейнер по задумке остаётся «неразвёрнутым», поэтому воронка, привязанная к нему, видит пустой контейнер. На контейнеры, поставленные игроком, это не влияет — как и на контейнеры из блоклиста, которые ведут себя точно как в ванилле.
• Выход компаратора читается как 0 у тех же контейнеров по той же причине.
• Украшенные горшки и подозрительный песок/гравий не поддерживаются — у них другая механика (очистка щёткой).
• Сундук-мимик Gimmighoul из Cobblemon намеренно не считается контейнером с лутом — это замаскированный покемон, а не настоящее хранилище, поэтому SlashLoot его полностью не трогает.

Исходный код и ссылки

• GitHub (исходный код, задачи, подробный разбор архитектуры): https://github.com/slashdaemon/SlashLoot
• Лицензия: CC-BY-4.0