# \ud83c\udfae CustomGuiReworked – Plugin Mechanics<\/p>\n
Detailed description of all mechanics and systems of the CustomGuiReworked plugin.<\/p>\n
## \ud83d\udccb **GUI System**<\/p>\n
### Creation and Editing
\n– **Built-in Editor** – Creating GUI through `\/gui create` and `\/gui edit` commands
\n– **Visual Editing** – Placing items in slots through interface
\n– **Property Configuration** – Setting title, size, commands for slots
\n– **File Saving** – Each GUI is saved in a separate YAML file<\/p>\n
### Inventory Types
\n– **9 slots** (1 row) – For simple menus
\n– **18 slots** (2 rows) – For small interfaces
\n– **27 slots** (3 rows) – Standard size
\n– **36 slots** (4 rows) – Extended interfaces
\n– **45 slots** (5 rows) – Large menus
\n– **54 slots** (6 rows) – Maximum size<\/p>\n
## \ud83d\udcbe **Data Storage System**<\/p>\n
### 5 Storage Types<\/p>\n
| Type | Description | Usage |
\n|——|————-|——-|
\n| **Block** | Data bound to specific block | Chests, furnaces, workbenches |
\n| **Personal** | Data unique for each player | Personal inventories, settings |
\n| **Global** | Shared data for all players | global banks, global chest |
\n| **Team** | Data for player groups | Clan storages |
\n| **Temporary** | Data only for session duration | Temporary menus, forms |<\/p>\n
### Saving Mechanics
\n– **Automatic saving** when content changes
\n– **Data loading** when opening GUI
\n– **Synchronization** between players for shared inventories<\/p>\n
## \ud83c\udfaf **Command System**<\/p>\n
### Slot Commands
\n– **Command execution** when clicking on slot
\n– **Variable support** (%player%, %slot%, %item%)
\n– **Conditional execution** – commands only under certain conditions
\n– **Console commands** – execution on behalf of server<\/p>\n
### Command Examples
\n“`yaml
\ncommands:
\n – command: “give %player% diamond 1”
\n slot: 10
\n condition: “has_permission”
\n – command: “teleport %player% spawn”
\n slot: 15
\n“`<\/p>\n
## \ud83d\udd0d **SlotTypeAPI – Slot Type Detection**<\/p>\n
### Automatic Detection<\/p>\n
| Type | Description | Behavior |
\n|——|————-|———-|
\n| **DESIGN** | Decorative slots | Cannot interact |
\n| **CONTAINER** | Storage slots | Full interaction |
\n| **CRAFT** | Crafting\/recipe slots | Limited interaction |
\n| **RESULT** | Crafting result slots | Only item retrieval |
\n| **FUEL** | Fuel slots | Fuel validity check |<\/p>\n
only design have functional, other for API to easy codding<\/p>\n
### Standard Inventory Support
\n– **Crafting Table** – Crafting slots and result
\n– **Furnace** – Ingredient, fuel, result
\n– **Brewing Stand** – Potions, fuel, bottles
\n– **Anvil** – Items and result
\n– **Enchanting Table** – Item and lapis<\/p>\n
### Heuristics for Custom Inventories
\n– **Size analysis** of inventory
\n– **Pattern detection** of layout
\n– **Result caching** for performance<\/p>\n
## \ud83d\udd27 **Developer API**<\/p>\n
### Static API (CustomGuiAPI)
\n“`java
\n\/\/ Simple calls without getting plugin instance
\nCustomGuiAPI.createGui(“shop”);
\nCustomGuiAPI.openGui(player, “shop”);
\nCustomGuiAPI.isDesignSlot(slot, inventory);
\n“`<\/p>\n
### Internal API (ApiManager)
\n– **Direct access** to plugin managers
\n– **Extended capabilities** for complex integration
\n– **Full control** over functionality<\/p>\n
## \ud83c\udfa8 **Design System**<\/p>\n
### Appearance Configuration
\n– **Titles** with color codes (\u00a76, \u00a7a, \u00a7c)
\n– **skeleton system** – items for buttons and elements<\/p>\n
### **ItemsAdder SUPPORT!**<\/p>\n
## \ud83d\udee1\ufe0f **Security System**<\/p>\n
### Checks and Restrictions
\n– **Access rights** – permission checking
\n– **Data validation** – correctness verification
\n– **Exploit protection** – bug prevention<\/p>\n
## \u26a1 **Performance Optimization**<\/p>\n
### Caching
\n– **Slot type cache** – fast access to information
\n– **GUI cache** – loaded interfaces in memory
\n– **Lazy loading** – loading on demand<\/p>\n
### Memory Management
\n– **Auto-cleanup** – removing unused data
\n– **Size limitation** – preventing memory leaks
\n– **Asynchronous operations** – non-blocking operations<\/p>\n
## \ud83c\udf10 **Multilingual Support**<\/p>\n
### Language Support
\n– **English** – primary language
\n– **Russian** – additional language
\n– **Translation system** – easy to add new languages<\/p>\n
### Localization
\n– **Messages** – translation of all texts
\n– **Commands** – support for different languages
\n– **Documentation** – help translation<\/p>\n
## \ud83d\udd27 **Integration with Other Plugins**<\/p>\n
### API Capabilities
\n– **GUI creation** from other plugins
\n– **Data management** – reading\/writing content
\n– **Event handling** – reacting to player actions
\n– **Functionality extension** – adding new capabilities<\/p>\n
### Integration Examples<\/p>\n
| Plugin | Application | Examples |
\n|——–|————-|———-|
\n| **Economy Plugins** | Shops with prices | Vault, Essentials |
\n| **Warp Systems** | Teleportation menus | Essentials, Multiverse |
\n| **Clan Systems** | Clan management | Factions, Clans |
\n| **Mini-games** | Game interfaces | Custom mini-games |<\/p>\n
## \ud83d\udcca **Performance**<\/p>\n
### Metrics
\n– **GUI loading time**: < 50ms\n- **Memory per GUI**: ~2-5KB\n- **Concurrent users support**: 1000+\n- **Compatibility**: 99% of plugins\n\n### Optimizations\n- **Lazy initialization** - loading only when needed\n- **Object pooling** - object reuse\n- **Asynchronous processing** - non-blocking operations\n- **Smart caching** - cache with TTL\n\n## \ud83d\ude80 **Advanced Features**\n\n### Advanced Functions\n- **Dynamic GUIs** - real-time content changes\n- **Conditional logic** - showing elements by conditions\n- **Animations** - smooth transitions and effects\n- **Web integration** - connection with web services\n\n### Future Plans\n- **Visual constructor** - drag-and-drop interface\n- **GUI templates** - ready-made designs\n- **Plugin marketplace** - GUI exchange between servers\n- **Mobile support** - management through app\n<\/p>\n","protected":false},"excerpt":{"rendered":"
a simple plugin to create Custom GUI Inventory interfaces with saving data items system<\/p>\n","protected":false},"featured_media":53096,"template":"","meta":{"_minecraft_slug":"customguireworked","_minecraft_project_id":"SWM5KwIv","_minecraft_author":"Moonaticks","_minecraft_license":"MIT","_minecraft_downloads":289,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customguireworked.zip","_minecraft_size_bytes":413780,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T11:51:05.057318Z","_minecraft_date_created":"2025-08-25T21:35:39.530960Z","_minecraft_date_modified":"2025-11-19T21:29:27.228928Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customguireworked","_minecraft_icon_attachment_id":53096,"_minecraft_imported_at":"2026-06-02T22:46:28+00:00","_minecraft_import_hash":"6a1ff68956caded8defbf342b43f7200","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,873,127,128,91,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-53095","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-storage","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n