GuiMod

<div align="center"> <img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/logo.png"/>

Modrinth

CurseForge

GitHub

</div>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> О моде / About the Mod

виртуальных меню-сундуков — локальный мод для Fabric, добавляющий систему виртуальных меню-сундуков без единого реального блока в мире. Администраторы создают интерактивные GUI прямо через команды: расставляют предметы, назначают команды на слоты и открывают меню игрокам по правому клику на предмет с NBT-тегом `GUI`.

Подходит для: хабов, варпов, выдачи китов, магазинов, диалогов с NPC, админ-панелей и любых других интерактивных меню.

---

virtual chest GUI system is a local-side Fabric mod that adds a virtual chest GUI system — no real blocks required. Admins build interactive menus via commands: place items into slots, assign commands, and trigger menus by right-clicking any item with a `GUI` NBT tag.

Use cases: server hubs, warps, kit dispensers, shops, NPC dialogues, admin panels, and any other interactive menu you can imagine.

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> Ключевые возможности / Key Features

[ RU ]

- Создавай меню прямо в игре — открывается реальный сундук, расставляй предметы по слотам - Правый клик по предмету в редакторе — чат предложит ввести команду для этого слота - Команды выполняются от лица игрока, который кликнул - Три типа сундуков: стандартный (27 слотов), двойной (54 слота), эндер-сундук - Кастомные заголовки с поддержкой цветовых кодов (`§a`, `§6` и т.д.) - Слоты «взятия» — игрок забирает предмет в инвентарь вместо запуска команды - Меню сохраняются как JSON-файлы — можно редактировать вручную без перезагрузки - Открытие меню правым кликом по любому предмету с тегом `GUI` в NBT

[ EN ]

- Build menus in-game — a real chest opens, place items into any slots - Right-click an item in the editor — chat prompts you to type a command for that slot - Commands run as the player who clicks - Three chest types: standard (27 slots), double (54 slots), ender chest appearance - Custom titles with full color code support (`§a`, `§6`, etc.) - Take-item slots — the player receives the item into their inventory instead of triggering a command - Menus saved as JSON files — edit manually without reloading - Trigger menus by right-clicking any item with a `GUI` NBT tag

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> Команды / Commands

Все команды требуют права оператора (уровень 2). / All commands require operator permission (level 2).

| Команда / Command | Описание / Description | |:---|:---| | `/guimod create <id>` | Создать новое меню / Create a new menu | | `/guimod edit <id>` | Редактировать существующее меню / Edit an existing menu | | `/guimod delete <id>` | Удалить меню / Delete a menu | | `/guimod show <id>` | Открыть меню в режиме просмотра / Open menu as preview | | `/guimod open <id>` | Открыть меню как игрок / Open menu as a player | | `/guimod list` | Список всех меню / List all menus | | `/guimod cfg <id> menu-type <type>` | Тип сундука: `chest`, `double`, `enderchest` / Set chest type | | `/guimod cfg <id> chest-name <name>` | Заголовок меню / Set menu title | | `/guimod cfg <id> take-item <from> <to>` | Диапазон слотов взятия / Set take-item slot range | | `/guimod cfg <id> list` | Текущий конфиг меню / Show current menu config |

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> Пример использования / Example Workflow

[ RU ]

1. Создай меню: `/guimod create kits_menu` 2. Расставь предметы по слотам, закрой сундук 3. Правый клик по предмету → введи команду, например `function pvpmap:give_kit_sword` 4. Задай заголовок: `/guimod cfg kits_menu chest-name §6Choose a Kit` 5. Выдай себе триггер-предмет: `/give @s minecraft:compass[custom_data={GUI:"kits_menu"}]` 6. Правый клик компасом → меню открывается, клик по предмету → кит выдан

[ EN ]

1. Create a menu: `/guimod create kits_menu` 2. Place items into slots, close the chest 3. Right-click an item → type a command, e.g. `function pvpmap:give_kit_sword` 4. Set a title: `/guimod cfg kits_menu chest-name §6Choose a Kit` 5. Give yourself a trigger item: `/give @s minecraft:compass[custom_data={GUI:"kits_menu"}]` 6. Right-click the compass → menu opens, click the item → kit given

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> Поддерживаемые версии / Supported Versions

| Версия / Version | Поддержка / Support | |:---:|:---:| | 1.21 — 1.21.8 | Supported |

Fabric only — Requires Fabric only

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/separator.png"/>

<img src="https://raw.githubusercontent.com/orangefahta/guimod/main/pictures/Compass.gif" width="32" height="32"/> Язык / Language

Русский • English