Restricted Inventory

Мод Restricted Inventory для Minecraft 1.20.1

Мод Restricted Inventory позволяет привязать конкретные ячейки инвентаря к определённым предметам или целым группам предметов (тегам). Это помогает игрокам и администраторам серверов поддерживать порядок, например, заставляя держать факелы в первом слоте или мечи в определённых ячейках. Ограничения настраиваются через JSON-конфигурацию или удобный игровой интерфейс, а при попытке положить неподходящий предмет слот показывает «призрачную» копию требуемого предмета.

Основная механика: привязка слотов к предметам

Мод позволяет жестко ограничить содержимое любого слота инвентаря игрока (от 0 до 35), разрешив размещение только конкретного предмета или целого тега предметов. Например, можно запретить положить в слот 0 всё, кроме факела (minecraft:torch), или разрешить в слоте 1 только мечи из тега #minecraft:swords. Если игрок попытается перетащить неподходящий предмет в заблокированный слот, перемещение не произойдет. Вместо этого слот отобразит полупрозрачное изображение (ghost preview) требуемого предмета, визуально напоминая игроку, что здесь должно находиться именно оно.

Умная маршрутизация предметов и удобство управления

При сборке предметов или их подборе из мира система автоматически направляет их в соответствующие заблокированные слоты, если они подходят по критериям, прежде чем заполнять свободные места. Для удобства настройки мод предлагает наложить нумерацию на слоты инвентаря: достаточно зажать клавишу Tab в любом окне инвентаря, чтобы увидеть номер каждого слота. Это упрощает процесс конфигурации, позволяя точно указывать, какие правила применяются к каким ячейкам.

Режимы работы: глобальные правила и индивидуальные настройки

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

Интерфейс настройки ограничений

Конфигурация редактируется через игровой интерфейс, открываемый командой /restrictedinventory config. Окно состоит из двух основных панелей. Верхняя панель служит для выбора: вкладка Items отображает все зарегистрированные предметы в масштабе 3/4 (при наведении показывается ID), а вкладка Tags позволяет выбрать тег предметов с живым предпросмотром его содержимого. Средняя панель представляет собой сетку из 36 слотов инвентаря. Левый клик по слоту выбирает его для назначения (выделение белым), правый клик удаляет текущее ограничение. При наведении на слот отображается его текущее значение в виде тултипа.

Команды и управление правами доступа

Все команды мод начинаются с префикса `/restrictedinventory`. Ключевая команда `/restrictedinventory config` открывает интерфейс настройки. Права доступа зависят от режима работы:

*   Если `useClientRestriction` **false** (серверный режим): экран конфигурации могут открывать только операторы сервера (OP уровня 4).
*   Если `useClientRestriction` **true** (клиентский режим): любой игрок может открыть свой личный конфиг.

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

Важное ограничение для творческого режима

Слоты с индексами 0–8 соответствуют горячей строке (hotbar) только в режиме выживания. В творческом режиме интерфейс инвентаря имеет другую структуру, и ограничения слотов в этом режиме не применяются корректно. При настройке учитывайте, что в творческом режиме слоты горячей строки занимают другие позиции.

Сравнение режимов работы

JSON-конфигурация и расширенные возможности

Ограничения также можно задавать вручную через файл конфигурации в формате JSON. Поддерживаются конкретные предметы, теги, а также NBT-теги и компоненты. Структура файла включает раздел restrictedSlots, где ключом является номер слота (0–35), а значением — объект с описанием ограничения. Примеры показывают, как связать слот с факелом, мечами через тег, или использовать компоненты для хранения заклинаний. Дополнительно поддерживаются разделы groups для групповых ограничений и teamRestrictions для привязки правил к игровым командам.

Совместимость и технические ограничения

Мод использует Mixin для перехвата стандартной логики размещения предметов и их подбора. Это означает, что он может не работать с модами или блоками сущностей, которые вставляют предметы напрямую в инвентарь, полностью обходя стандартную логику слотов. Также возможны конфликты с модами, модифицирующими классы Slot, Inventory или AbstractContainerScreen. В таких случаях ограничения могут игнорироваться или вызывать ошибки.

Автор: CoolerProMC · Лицензия: MIT