Smart Inventory Manager

Smart Inventory Manager

Smart Inventory Manager — клиентский мод на Fabric, который добавляет быстрое и безопасное сортирование инвентаря с аккуратными кнопками-иконками, горячими клавишами, несколькими режимами сортировки, восстановлением конфига JSON, поддержкой Mod Menu и широкой локализацией.

Автор: Matfi1

Возможности

• Сортировка инвентаря игрока прямо с экрана инвентаря.
• Сортировка обычных контейнеров: сундука, бочки, шалкерового ящика, воронки, раздатчика и выбрасывателя.
• Компактные кнопки-иконки вместо больших текстовых кнопок.
• Переключение режима сортировки кнопкой-иконкой прямо в игре.
• Иконка режима меняется в зависимости от выбранного режима сортировки.
• Подробные всплывающие подсказки при наведении объясняют каждую иконку.
• Настройки доступны из главного меню/меню паузы и по горячей клавише.
• Сортировка учитывает защищённые слоты хотбара, если включён ignoreHotbar.
• Сортировка учитывает настроенные lockedSlots.
• Повреждённые файлы конфига сохраняются в резервную копию и заменяются настройками по умолчанию.
• В MVP нет миксинов.

Режимы сортировки

• Item ID
• Категория
• Количество
• Прочность
• Имя A-Z
• Имя Z-A

Управление

Горячие клавиши по умолчанию:

• I: сортировать инвентарь игрока
• O: сортировать открытый контейнер
• K: открыть настройки Smart Inventory Manager

Их можно изменить в меню управления Minecraft.

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

Собранные jar-файлы для Modrinth сохраняются в dist/modrinth/.

Для Minecraft 26.1 и 26.1.2 требуется Java 25.

Установка

1. Установи Fabric Loader для своей версии Minecraft.
2. Установи Fabric API для своей версии Minecraft.
3. Положи подходящий файл SmIm-*.jar в папку mods.
4. По желанию: установи Mod Menu, чтобы открывать экран настроек из списка модов.

Это клиентский мод. На серверах он не нужен.

Конфиг

Файл конфига создаётся здесь:

config/smartinventorymanager.json

Ключи конфига:

• enableInventorySort
• enableContainerSort
• buttonSide
• buttonScale
• animationEnabled
• sortMode
• ignoreHotbar
• lockedSlots

Если JSON повреждён, Smart Inventory Manager переименовывает его в резервную копию .broken с отметкой времени и создаёт новый конфиг по умолчанию.

Локализация

Включённые языки:

• English (en_us)
• Russian (ru_ru)
• German (de_de)
• French (fr_fr)
• Spanish (es_es)
• Portuguese, Brazil (pt_br)
• Italian (it_it)
• Polish (pl_pl)
• Ukrainian (uk_ua)
• Turkish (tr_tr)
• Dutch (nl_nl)
• Czech (cs_cz)
• Hungarian (hu_hu)
• Chinese, Simplified (zh_cn)
• Chinese, Traditional (zh_tw)
• Japanese (ja_jp)
• Korean (ko_kr)

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

Smart Inventory Manager использует события экранов Fabric и избегает небезопасных индексов списков виджетов. Если экран не распознан, функция тихо отключается вместо краша клиента.

Цели для ручного тестирования совместимости:

• Sodium
• Iris
• Mod Menu
• Mouse Tweaks
• Shulker Box Tooltip
• JEI
• libIPN

Это цели для ручного тестирования, а не полная сертификация совместимости. Моды, которые тоже перемещают слоты инвентаря, могут конфликтовать, если оба мода сортируют одновременно.

Сборка

Собрать все поддерживаемые файлы для Modrinth:

./scripts/build-modrinth.sh

Собрать одну версию Minecraft:

./gradlew clean build -PmcVersion=1.21.11

Собрать 26.x с Java 25:

JAVA_HOME="$PWD/.jdks/jdk-25" ./gradlew clean build -PmcVersion=26.1
JAVA_HOME="$PWD/.jdks/jdk-25" ./gradlew clean build -PmcVersion=26.1.2

Успешно собранные jar-файлы копируются в:

```text
dist/modrinth/

План ручного тестирования

• Откройте инвентарь игрока.
• Убедитесь, что иконки сортировки и режима находятся за пределами GUI инвентаря, а не в центре.
• Откройте сундук, бочку, шалкеровый ящик, воронку, раздатчик и выбрасыватель.
• Нажмите «Сортировать» в каждом поддерживаемом экране.
• Переключите режимы сортировки и убедитесь, что иконка режима меняется.
• Используйте горячие клавиши для сортировки инвентаря игрока и контейнеров.
• Измените масштаб GUI и откройте экраны заново.
• Повредите JSON конфига и убедитесь, что создаётся резервная копия и конфиг восстанавливается по умолчанию.
• Запустите с Mod Menu и убедитесь, что экран конфига открывается.
• Запустите с Sodium/Iris и убедитесь, что GUI по-прежнему отображается.

Планы

Запланированные идеи для будущих релизов:

• Быстрое складывание
• Пополнение хотбара
• Автоматическое пополнение
• Интерактивный интерфейс блокировки слотов
• Очистка инвентаря

Лицензия

MIT