Shulker & Bundle - GUI и автоподбор для шалкеров и бандлов

Shulker & Bundle - QoL-мод для Майнкрафт (Minecraft), который решает древнюю проблему всех выживальщиков: инвентарь тупо переполняется. Если вы устали каждые десять минут бегать к базе сгружать ресурсы или класть шалкер-бокс на землю, открывать его, закладывать вещи и забирать обратно, этот мод снимает с вас всю эту рутину. Скачать Shulker & Bundle стоит каждому, кто фармит много и не любит возню с менеджментом инвентаря.

По сути, это ванилла-плюс мод из категорий Storage и Utility: он ничего не добавляет в мир, а лишь делает удобнее то, что уже есть в игре. Мод доступен для Fabric (нужен Fabric API) и работает как на клиенте, так и на сервере. Поддерживаются версии Minecraft 1.21.3-1.21.11 и свежие релизы 26.x. Проект отлично вяжется с логикой любой выживалочной или ванильной сборки модов - никаких конфликтов с оптимизационными модами вроде Sodium тут по факту нет, ведь мод только перехватывает взаимодействие с инвентарём.

Что изменится в игре

Открытие GUI без установки шалкера

• Шалкер-бокс: Shift+ПКМ по шалкеру в основной или левой руке открывает его интерфейс на 27 слотов прямо на лету, без установки на землю.
  • Пока GUI открыто, в руке отображается заглушка "Editing Shulker: [название]".
  • Право: shulkerbundle.open.
  • Важно: открыть нельзя, если шалкеры в руке находятся в стаке.
• Бандл (мешок): Shift+ПКМ открывает динамическое GUI, размер которого подстраивается под содержимое - 9, 18 или 27 слотов в зависимости от количества уникальных типов предметов внутри (максимум 27 уникальных типов при ручном взаимодействии).
  • Если в бандле больше 27 уникальных типов предметов, GUI не откроется - это защита от потери данных.
  • Право: shulkerbundle.open_bundle_gui.

Автоматический подбор предметов

• Шалкер в левой руке: подбираемые предметы сразу отправляются в шалкер-бокс в оффхенде, если там есть место. Идеально для шахтёрских вылазок - копаешь, и всё само ложится в переносное хранилище.
  • Право: shulkerbundle.hold.shulker.
  • Уведомления в action bar: сообщение "Shulker has X empty slots left" срабатывает, когда новый предмет занял слот в третьем ряду (слоты 18-26) - то есть хранилище почти полное, пора сваливать.
  • Шалкеры, бандлы и заглушки в подбор не берутся. Стак шалкеров в оффхенде для автоподбора не поддерживается.
• Бандлы в инвентаре и в руке: подобранные предметы уходят в любые доступные бандлы.
  • Право: shulkerbundle.hold.bundle.
  • Уведомления: "Bundle has (X/64) items", если бандл заполнен наполовину и больше, либо "Bundles with space X" в остальных случаях.
  • Автоподбор пропускается, если вы крадётесь (shift), если предмет в чёрном списке (торт, тыквенный пирог, другие бандлы) или если добавление нового типа превысит лимит 9 уникальных типов. Оружие, броня и зелья тоже игнорируются при автоподборе в бандл, чтобы не ломать боевую рутину.
  • Предметы с NBT-тегом CrateBundleNoAutoPickup игнорируются.

Правила взаимодействия с бандлами

Мод аккуратно закрывает дыры ванильной механики, из-за которых можно было бы потерять вещи:

• Чёрный список GUI: торт, тыквенный пирог, шалкер-боксы и непустые бандлы нельзя положить в бандл через кастомный GUI вручную.
• Ручное вложение через ПКМ: те же ограничения действуют при попытке положить предмет с курсора в бандл в инвентаре. Превышение лимита уникальных типов заблокируется.
• Запрет вложения через ЛКМ: нельзя переложить бандл с курсора в бандл в слоте инвентаря левым кликом - вложенность бандлов исключена полностью.
• Лимиты: автоподбор - до 9 уникальных типов, ручное вложение через GUI - до 27.

Также работает с: Reinforced Shulker Boxes

Если поставить мод Reinforced Shulker Boxes, вся магия распространится и на усиленные шалкеры: их GUI на 45-108 слотов, автоподбор и уведомления работают корректно. Для тех, кто строит серьёзную систему хранения, это прямо must-have связка.

Команды

Базовая команда /shulkerbundle или короткий алиас /sb выводит справку.

Глобальные команды (только админы)

Требуют право shulkerbundle.admin (OP уровень 2).

• /sb global gui [shulker|bundle] - включить или выключить открытие GUI для всех игроков.
• /sb global pickup [shulker|bundle] - переключить автоподбор глобально.
• /sb global notify [shulker|bundle] - переключить уведомления в action bar глобально.

Личные команды

Каждый игрок настраивает мод под себя, настройки сохраняются на сервере.

• /sb personal gui [shulker|bundle] - ваш личный переключатель GUI.
• /sb personal pickup [shulker|bundle] - личный переключатель автоподбора.
• /sb personal notify [shulker|bundle] - личный переключатель уведомлений.

Как включаются функции: трёхуровневая система

Мод проверяет активность функции в три этапа:

1. Выбор игрока (клиент): функция должна быть включена в личных настройках (через ModMenu или /sb personal). Отключили - и она не будет работать никогда, даже если сервер разрешает.
2. Глобальные настройки сервера: если игрок включил функцию, сервер проверяет /sb global.
3. Права: если функция выключена глобально, проверяется конкретный permission-узел (например, shulkerbundle.open).

Мастер-выключатель: в клиентском конфиге для мультиплеера есть опция "Deny Server Permissions". Включил - и все функции мода жёстко отключены для вас на любом сервере, глобальные настройки и права игнорируются.

Клиентский конфиг через ModMenu

Если установлен Mod Menu, появляется полноценный экран настроек. Параметры разделены на категории Singleplayer и Multiplayer, так что для одиночной игры и серверов можно задать разное поведение. Это удобная альтернатива командам /sb personal.

Для администраторов серверов

• Детект клиентского мода: сервер видит, есть ли у игрока мод. Если зашёл без него, игрок дважды получит сообщение в action bar со ссылкой. Отключить можно, поставив notifyPlayer: false в конфиге shulkerbundle.json.
• LuckPerms: для раздачи прав удобнее всего использовать LuckPerms - все узлы перечислены ниже.

Все permission-узлы

• shulkerbundle.open - открытие GUI шалкера через Shift+ПКМ.
• shulkerbundle.open_bundle_gui - открытие GUI бандла через Shift+ПКМ.
• shulkerbundle.hold.shulker - автоподбор предметов в шалкер в левой руке.
• shulkerbundle.hold.bundle - автоподбор предметов в бандлы в инвентаре.
• shulkerbundle.notify.shulker - уведомления о заполнении шалкера.
• shulkerbundle.notify.bundle - уведомления о заполнении бандла.
• shulkerbundle.admin - админские права, включая глобальные команды. (По умолчанию: OP уровень 2)
• shulkerbundle.command.use - доступ к базовой команде /shulkerbundle и /sb. (По умолчанию: все)

Политика сборок

Мод можно свободно включать в любую сборку модов. Нельзя только напрямую модифицировать JAR-файл, а сама сборка или доступ к моду внутри неё не должны продаваться.

Практические советы

Важный нюанс: не держите в оффхенде стак из нескольких шалкеров - автоподбор и открытие GUI в таком случае работать не будут. Один шалкер - одна рука, так задумано, чтобы не сломать данные при частичном стаке.

Совет для шахтёров: повесьте шалкер в левую руку, включите автоподбор через /sb personal pickup shulker и забудьте про переполненный инвентарь. Как только увидите сообщение, что в третьем ряду остались считанные слоты - выдохите факелы и валите наверх.

На сервере: если вы админ, начните с /sb global pickup bundle on - игроки быстро оценят, что дроп с ферм сам укладывается в бандлы, а нагрузка на сервер от мода минимальная.