Restricted Inventory

Restricted Inventory

Закрепляйте слоты инвентаря за конкретными предметами или тегами предметов.

Давно хотели выделить отдельный слот под меч, всегда держать факел в слоте 0 или навести порядок в инвентарях на всём сервере? Restricted Inventory позволяет именно это — настройте любой слот инвентаря (0–35) так, чтобы он принимал только определённый предмет или тег предметов, для всего сервера или для каждого игрока отдельно.

Возможности

• Ограничения слотов — закрепляйте любой слот хотбара или инвентаря за конкретным предметом (например, minecraft:torch) или целым тегом предметов (например, #minecraft:swords)
• Режим сервера или клиента — применяйте одни правила ко всем игрокам из конфига сервера или позвольте каждому игроку задать свои ограничения в клиентском конфиге
• Визуальная подсказка — в ограниченных слотах отображается призрачное превью нужного предмета, чтобы игроки всегда знали, что где лежит
• Оверлей с номерами слотов — удерживайте Tab в любом экране инвентаря, чтобы увидеть номер каждого слота — настройка конфига становится проще простого
• Умная раскладка предметов — подобранные предметы сначала попадают в свои закреплённые слоты, а уже потом заполняют свободные

Команды

Все команды используют префикс /restrictedinventory.

Правила доступа

• Когда useClientRestriction — false (режим сервера): открыть экран настройки могут только операторы сервера (OP уровень 4).
• Когда useClientRestriction — true (режим клиента): каждый игрок может открыть свой экран настройки.

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

Экран настройки — это внутриигровой GUI для редактирования ограничений слотов. Открывается командой /restrictedinventory config.

Выбор предмета / тега (верхняя панель)

• Вкладка Items — список всех зарегистрированных предметов в масштабе ¾. Наведите курсор, чтобы увидеть название предмета и registry ID. Кликните, чтобы выбрать.
• Вкладка Tags — список всех зарегистрированных тегов предметов. Каждый тег перелистывает свои элементы в виде живого превью. Наведите курсор, чтобы увидеть ID тега. Кликните, чтобы выбрать.
• Прокрутка — колесом мыши или перетаскиванием полосы прокрутки справа.

Сетка слотов (средняя панель)

• Отображает все 36 слотов инвентаря игрока (0–35) в стандартном расположении инвентаря.
• Каждый слот показывает перелистывающееся превью текущего ограничения или пуст, если ограничения нет.
• ЛКМ по слоту — выбрать его (подсвечивается белым). Выбранный слот получит предмет или тег, выбранный в панели выбора.
• ПКМ по слоту — убрать предмет или тег.
• Наведите курсор на слот, чтобы увидеть текущее значение ограничения во всплывающей подсказке.

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

Ограничения задаются в простом JSON-конфиге. Поддерживаются как конкретные предметы, так и теги предметов. Nbt/Components тоже поддерживаются.

{
  "useClientRestriction": false,
  "useTeamAndTagRestrictions": true,
  "restrictedSlots": {
    "0": "minecraft:torch",
    "1": {
      "item": "#minecraft:swords",
      "display": { // this is an example with item with nbt/component
        "components": { // use "tag" for 1.20.1
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        },
      }
    },
    "2": {
       "item": "minecraft:enchanted_book",
       "components": { // use "tag" for 1.20.1
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        },
       "display": "minecraft:dirt" // this is an example with plain item
      }
    },
    "3": {
      "group": "group_name"
    }
  },
  "groups": { // Only available in common config
    "group_name": [
      {"item": "minecraft:dirt"},
      {
       "item": "minecraft:enchanted_book",
       "components": { // use "tag" for 1.20.1
         "minecraft:stored_enchantments": {
           "mineraft:silk_touch": 1
        }
      }
    ]
  },
   "teamRestrictions": {
    "team": {
       "restrictedSlots": {
          "0": "minecraft:dirt"
       }
    }
  },
  "tagRestrictions": {
    "dirt": {
       "restrictedSlots": {
          "1": "minecraft:grass_block"
       }
    }
  }
}

| Диапазон слотов | Расположение |
|------------|----------|
| 0–8 | Хотбар (только в режиме выживания) |
| 9–35 | Основной инвентарь |

> **Примечание:** Индексы слотов 0–8 соответствуют хотбару в режиме выживания. В режиме креатива хотбар использует другую раскладку инвентаря, и ограничения на слоты там **не применяются**.

## Примечание о совместимости

Этот мод внедряется в ванильную логику размещения слотов и подбора предметов через Mixin. Моды или блочные сущности, которые вставляют предметы напрямую в инвентарь игрока (минуя стандартную логику слотов), могут не учитывать эти ограничения. Моды, которые также изменяют `Slot`, `Inventory` или `AbstractContainerScreen`, могут конфликтовать.