Gestorage

Gestorage

Gestorage — модульный мод для Fabric (Minecraft 1.21.1), улучшающий хранение предметов и управление инвентарём. Это экосистема независимых модулей, которые можно включать и выключать по отдельности, так что вы ставите только те механики, которые вам действительно нужны. Все модули по умолчанию отключены и активируются через экран настроек в игре (/gestorage config), по горячей клавише или редактированием config/gestorage/.

Возможности

Подробности о модулях

Expanded Ender Chest

• Три уровня хранилища, выбираемые для всего сервера игровым правилом gestorage:enderChestSize: Normal (27), Large (54) и Extra Large (228 слотов).
• Предметы сверх ванильных 27 слотов хранятся для каждого игрока и сохраняются между сессиями (состояние NBT, версионируется с резервными копиями).
• Настраиваемая горячая клавиша открывает ваш эндер-сундук откуда угодно, без предмета.
• Также доступно через /gestorage endersize [normal|large|extra_large] (требуется OP уровень 2).

Shulker Restock

• Отметьте два слота (шалкер-источник и цель) назначенной клавишей, чтобы создать постоянную привязку для мира.
• Целевой слот пополняется из шалкера до стандартного размера стака, когда опускается ниже заданного порога, с адаптивной задержкой.
• Привязки сохраняются для каждого мира в config/gestorage/links.json и переживают перезапуски; они общие для всех игроков.

Stackable Shulkers

• Пустые шалкеры ведут себя как любой другой предмет (складываются до 64), а непустые сохраняют обычный лимит стака 1.
• Серверная логика: переключатель на экране настроек записывает серверный конфиг и отключается при подключении к удалённому серверу.

Storage Overlay

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

Inventory Sorting

• Сортировка в один клик для инвентаря игрока (только основной инвентарь; хотбар и броня не трогаются), сундуков, эндер-сундуков и шалкеров.
• Опции: объединение стаков, сортировка по имени, порядок сортировки (по возрастанию/убыванию) и блокировка для каждого типа инвентаря.
• Сервер проверяет сортируемый диапазон, так что это работает одинаково независимо от того, кто хостит.

Careful Break

Серверные флаги, синхронизируются со всеми клиентами и переключаются с OP уровнем 2 (или как хост одиночной игры):

• Careful Break — добытые блоки попадают прямо в ваш инвентарь (активируется при приседании).
• Careful Drop / Always Careful — дроп с блоков и сущностей (предметы, таблицы лута, надетая экипировка, содержимое вагонеток) собирается в ваш инвентарь, а не разбрасывается.
• Tree Capitator — валка целых деревьев при разрушении нижнего бревна (с ограничениями по дереву/листве).
• Better Harvesting — разрушение целых цепочек кактусов, сахарного тростника, бамбука и ламинарии одним ударом.
• Auto Replant — автоматическая пересадка деревьев и культур после сбора.

Tool Wheel

• Радиальное HUD-колесо (9 слотов), открывается по горячей клавише; клик меняет реальный предмет между колесом и вашей основной рукой. Содержимое колеса сохраняется для каждого игрока и следует за вами между сессиями и измерениями.
• Auto Tool (серверная логика для каждого игрока): при START_DESTROY_BLOCK лучший инструмент из колеса мгновенно перемещается в руку, пересчитывается на каждом блоке, который вы начинаете добывать, и возвращает ваш исходный инструмент через секунду после остановки добычи.
• Хранилище для каждого игрока сохраняется в оверворлде (`gestorage_tool_wheel_`) и синхронизируется с владельцем при входе и после каждого изменения.

Требования

• Minecraft 1.21.1
• Fabric Loader >= 0.16.10
• Fabric API
• owo-lib идёт в комплекте с модом (предупреждает, если его нет)

Установка

1. Установите Fabric Loader для Minecraft 1.21.1.
2. Установите подходящую версию Fabric API.
3. Скачайте последний релиз Gestorage со страницы релизов.
4. Поместите .jar файл в вашу папку .minecraft/mods.
5. Запустите игру. Модули по умолчанию отключены — откройте экран настроек через /gestorage config (или Mod Menu), чтобы включить их.

Настройка

Вся конфигурация находится в config/gestorage/:

| storage_overlay.json | Видимость элементов оверлея и клавиши переключения | | inventory_sorting.json | Настройки сортировки и клавиши переключения | | careful_break.json | Серверные флаги Careful Break (записываются только сервером) | | careful_break_keybinds.json | Клиентские клавиши Careful Break | | tool_wheel.json | Клавиши Tool Wheel и флаг включения модуля | | links.json | Определения связей шалкеров |

Команды и игровые правила

• /gestorage config — открывает экран настроек в игре.
• /gestorage endersize [normal|large|extra_large] — задаёт игровое правило gestorage:enderChestSize (уровень OP 2).
• Игровое правило gestorage:enderChestSize — принимает 0 (normal), 1 (large) или 2 (extra large); игровое правило является единственным источником истины для размера эндер-сундука на сервере.

Обратная связь и вклад

Gestorage активно развивается. Если вы столкнулись с проблемой, у вас есть идея для функции или вы хотите внести вклад в код — откройте Issue или отправьте Pull Request.

Лицензия

Выпущено под MIT License.