GuiMod

О моде / About the Mod

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

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

GuiMod 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.

Ключевые возможности / 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

Команды / 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 |

Пример использования / 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

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

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

Fabric only — Requires Fabric API

Язык / Language

Русский • English