![](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/31b63c1cc08964f616ae35ec874741870f4c8bb4.png\")
![](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/60fcf5a0b12f3cff46b065aea871b3f08629f94e.png\")
![](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/4a1b54c640e2f990880107e8bf3cd6c573a9201a.png\")
\n<\/div>\n—<\/p>\n
| **Dependencies**|
\n|:-|
\n| PlaceholderAPI
\n| Java 17 or higher
\n| Paper or forks
\n| Minecraft Version 1.20 or higher <\/p>\n
—<\/p>\n ### Example<\/p>\n “`java To open a GUI for a player, call `open()`:<\/p>\n “`java —<\/p>\n `ParsedGui` lets you define an entire inventory GUI in a YAML config file \u2014 items, slots, click actions, open\/close hooks, and placeholders \u2014 with no boilerplate code.<\/p>\n —<\/p>\n ### YAML structure<\/p>\n “`yaml on_open: # optional \u2014 action list to run when GUI opens on_close: # optional \u2014 action list to run when GUI closes Items: **Supported click types:** `any`, `left`, `shift_left`, `right`, `shift_right`, `middle`, `drop`, `control_drop`, `double`<\/p>\n **Slot formats:**<\/p>\n “`yaml —<\/p>\n ### Opening from code<\/p>\n “`java \/\/ From a pre-parsed Gui record (more efficient for many players): —<\/p>\n ### Runtime placeholders<\/p>\n Use `setReplace()` to inject values into display names, lore, and action lines at runtime. “`java In YAML: PlaceholderAPI placeholders (`%papi_placeholder%`) are applied automatically \u2014 no extra setup needed.<\/p>\n —<\/p>\n ### Click handlers from code<\/p>\n Register Java-side click logic for items by their YAML section key. “`java gui.addClickHandler(“my_item”, event -> { gui.open(player); —<\/p>\n ### Passing the GUI into actions via ActionContext<\/p>\n When a player clicks an item, `ParsedGui` puts itself into the `ActionContext` automatically. “`java \/\/ do something, then refresh In config: —<\/p>\n ### Slot priority & view_requirements<\/p>\n Multiple items can target the same slot. The one with the lowest `priority` value whose `view_requirements` all pass wins. “`yaml `view_requirements` supports `==`, `!=`, `>=`, `<=`, `>`, `<` with both numbers and strings.\nPlaceholderAPI placeholders are resolved before comparison.\n\n---\n\n### Refreshing the GUI\n\nCall `refresh()` to clear and rebuild all items \u2014 re-evaluates `view_requirements` and re-applies all placeholders.\n\n```java\ngui.refresh();\n```\n\nTypically called inside a click handler after state changes:\n```java\ngui.addClickHandler(\"toggle\", event -> { —<\/p>\n ### Extending ParsedGui<\/p>\n You can subclass `ParsedGui` to add custom inventory slots, override rendering logic, etc.<\/p>\n > \u26a0\ufe0f `super(viewer, config, plugin)` calls `buildItems()` internally during construction \u2014 before your subclass fields are initialized. Override `buildItems()` with a null-check guard:<\/p>\n “`java private final MyPlugin plugin;<\/p>\n public MyGui(Player viewer, FileConfiguration config, MyPlugin plugin) { @Override @Override —<\/p>\n Actions are config-driven commands executed on a player. Each action is a string in the format `[key] text`.<\/p>\n ### Built-in actions<\/p>\n | Key | Description | ### Usage<\/p>\n **Simple run:** **With extra objects in context:** > Extra objects added via `.with()` can be retrieved inside the handler using `ctx.get(YourClass.class)`.<\/p>\n —<\/p>\n ### Registering a custom action<\/p>\n Custom actions are registered in `onEnable` and unregistered in `onDisable`.<\/p>\n Actions from different plugins can share the same key without conflict \u2014 the full key is `namespace:command`:<\/p>\n “`yaml #### Lambda (simple cases)<\/p>\n “`java int amount = Integer.parseInt(text); @Override #### Class (recommended for complex logic)<\/p>\n Register in `onEnable`: @Override Implement `Action`: @Override \/\/ Parse text argument \/\/ Retrieve a custom object from context \u2014 null if not provided entity.teleport(player.getLocation()); #### ActionContext<\/p>\n `ActionContext` is a type-safe container for objects passed into an action. Objects are stored and retrieved by class \u2014 no string keys needed.<\/p>\n “`java \/\/ Get objects out (inside a handler) If you want to store an object under an interface rather than its concrete class: # API<\/p>\n “`xml “`xml “`gradle “`gradle Easy util for Minecraft Gui, Command, Action<\/p>\n","protected":false},"featured_media":93522,"template":"","meta":{"_minecraft_slug":"libb","_minecraft_project_id":"ksoKuDWF","_minecraft_author":"MrJetby","_minecraft_license":"MIT","_minecraft_downloads":49,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"libb.zip","_minecraft_size_bytes":137699,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:08:31.256947Z","_minecraft_date_created":"2026-04-15T23:52:20.688380Z","_minecraft_date_modified":"2026-04-10T16:04:40.505988Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/libb","_minecraft_icon_attachment_id":93522,"_minecraft_imported_at":"2026-06-05T08:22:00+00:00","_minecraft_import_hash":"6bef4f0d05d046ef935ae4bd44e9b803","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-93521","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nGUI<\/summary>\n
\npublic class GuiTest extends AdvancedGui {
\n public GuiTest() {
\n super(“Gui title”);
\n setItem(“example”, ItemWrapper.builder(Material.STONE)
\n .slots(1, 5, 7)
\n .displayName(Component.text(“This is the name dude”))
\n .onClick(event -> {
\n event.setCancelled(true);
\n player.sendMessage(“Clicked on slot: ” + event.getSlot());
\n })
\n .build());
\n }
\n}
\n“`<\/p>\n
\nnew GuiTest().open(player);
\n“`<\/p>\n<\/details>\nParsedGui \u2014 Config-driven GUIs<\/summary>\n
\nid: my_gui
\ntitle: “
\nsize: 54 # must be a multiple of 9<\/p>\n
\n – “[sound] UI_BUTTON_CLICK;1;1”<\/p>\n
\n – “[message]
\n my_item:
\n material: DIAMOND
\n slot: 13 # single slot
\n display_name: “
\n lore:
\n – “”
\n – ”
\n – “”
\n on_click:
\n any: # fires on every click type
\n – “[sound] UI_BUTTON_CLICK;1;1”
\n – “[player] buy diamond”
\n left: # fires only on left click
\n – “[message]
\n shift_left:
\n – “[message]
\n“`<\/p>\n
\nslot: 13 # single slot
\nslots:
\n – ‘0-8′ # range
\n – ’45-53′ # another range
\n – ’27’ # single inside a list
\n“`<\/p>\n
\n\/\/ From a FileConfiguration:
\nFileConfiguration config = YamlConfiguration.loadConfiguration(file);
\nnew ParsedGui(player, config, myPlugin).open(player);<\/p>\n
\nGui gui = …; \/\/ parsed once at startup
\nnew ParsedGui(player, gui, myPlugin).open(player);
\n“`<\/p>\n
\nCall it **before** `open()` \u2014 items are built on open.<\/p>\n
\nParsedGui gui = new ParsedGui(player, config, myPlugin);
\ngui.setReplace(“%price%”, “500”)
\n .setReplace(“%item_name%”, “Diamond Sword”);
\ngui.open(player);
\n“`<\/p>\n
\n“`yaml
\ndisplay_name: “
\nlore:
\n – ”
\n“`<\/p>\n
\nRuns **in addition** to whatever `on_click` is defined in YAML.<\/p>\n
\nParsedGui gui = new ParsedGui(player, config, myPlugin);<\/p>\n
\n Player clicker = (Player) event.getWhoClicked();
\n clicker.sendMessage(“You clicked my_item!”);
\n gui.refresh();
\n});<\/p>\n
\n“`<\/p>\n
\nInside a custom action you can retrieve it:<\/p>\n
\nActionRegistry.register(“myplugin”, “my_action”, (ctx, text) -> {
\n ParsedGui gui = ctx.get(ParsedGui.class);
\n if (gui == null) return;<\/p>\n
\n gui.refresh();
\n});
\n“`<\/p>\n
\n“`yaml
\non_click:
\n any:
\n – “[myplugin:my_action]”
\n“`<\/p>\n
\nThis is useful for conditional items \u2014 e.g. show a locked version until the player has enough money.<\/p>\n
\nItems:
\n buy_locked:
\n material: RED_STAINED_GLASS_PANE
\n slot: 13
\n priority: 1
\n display_name: “
\n view_requirements:
\n – “%vault_eco_balance% < 100\" # shown when balance < 100\n\n buy_unlocked:\n material: EMERALD\n slot: 13\n priority: 2 # fallback \u2014 shown when locked item's requirement fails\n display_name: \"
\n“`<\/p>\n
\n toggleSomething(player);
\n gui.refresh();
\n});
\n“`<\/p>\n
\npublic class MyGui extends ParsedGui {<\/p>\n
\n super(viewer, config, plugin);
\n this.plugin = plugin;
\n \/\/ your init here
\n }<\/p>\n
\n public void buildItems(List
\n if (plugin == null) { \/\/ guard: called from super() before our fields exist
\n super.buildItems(items);
\n return;
\n }
\n \/\/ your custom logic, then:
\n super.buildItems(items);
\n }<\/p>\n
\n public void refresh() {
\n \/\/ update your replacements before items are rebuilt
\n setReplace(“%score%”, String.valueOf(getScore()));
\n super.refresh();
\n }
\n}
\n“`<\/p>\n<\/details>\nActions<\/summary>\n
\n|—–|————-|
\n| `[message]` | Send a message to the player |
\n| `[broadcast_message]` | Broadcast a message to all players |
\n| `[console]` | Run a command from console |
\n| `[player]` | Run a command as the player |
\n| `[effect]` | Apply a potion effect |
\n| `[action_bar]` | Send an action bar message |
\n| `[broadcast_action_bar]` | Broadcast an action bar to all players |
\n| `[title]` | Send a title to the player |
\n| `[broadcast_title]` | Broadcast a title to all players |
\n| `[sound]` | Play a sound for the player |
\n| `[broadcast_sound]` | Play a sound for all players |
\n| `[open]` | Open a GUI |<\/p>\n
\n“`java
\nActionExecute.run(ActionContext.of(player), “[message] Hello!”);
\n“`<\/p>\n
\n“`java
\nActionExecute.run(
\n ActionContext.of(player).with(entity),
\n “[myplugin:give_diamond] 64”
\n);
\n“`<\/p>\n
\n# config.yml
\nactions:
\n – “[plugina:spawn] text” # resolves plugina’s spawn
\n – “[pluginb:spawn] text” # resolves pluginb’s spawn \u2014 no conflict
\n – “[spawn] text” # resolves whichever was registered first
\n“`<\/p>\n
\n@Override
\npublic void onEnable() {
\n ActionRegistry.register(“myplugin”, “give_diamond”, (ctx, text) -> {
\n Player player = ctx.getPlayer();
\n if (player == null || text == null) return;<\/p>\n
\n player.getInventory().addItem(new ItemStack(Material.DIAMOND, amount));
\n player.sendMessage(“You got ” + amount + ” diamonds!”);
\n });
\n}<\/p>\n
\npublic void onDisable() {
\n ActionRegistry.unregisterAll(“myplugin”);
\n}
\n“`<\/p>\n
\n“`java
\n@Override
\npublic void onEnable() {
\n ActionRegistry.register(“myplugin”, “give_diamond”, new GiveDiamondAction());
\n}<\/p>\n
\npublic void onDisable() {
\n ActionRegistry.unregisterAll(“myplugin”);
\n}
\n“`<\/p>\n
\n“`java
\npublic class GiveDiamondAction implements Action {<\/p>\n
\n public void execute(@NotNull ActionContext ctx, @Nullable String text) {
\n Player player = ctx.getPlayer();
\n if (player == null || text == null) return;<\/p>\n
\n int amount = Integer.parseInt(text);
\n player.getInventory().addItem(new ItemStack(Material.DIAMOND, amount));
\n player.sendMessage(“You got ” + amount + ” diamonds!”);<\/p>\n
\n Entity entity = ctx.get(Entity.class);
\n if (entity == null) return;<\/p>\n
\n ActionExecute.run(
\n ActionContext.of(player),
\n “[message]
\n );
\n }
\n}
\n“`<\/p>\n
\n\/\/ Put objects in
\nActionContext ctx = ActionContext.of(player)
\n .with(entity) \/\/ store by entity.getClass()
\n .with(myGui); \/\/ store by myGui.getClass()<\/p>\n
\nEntity entity = ctx.get(Entity.class); \/\/ null if not provided
\nEntity entity = ctx.require(Entity.class); \/\/ throws if not provided
\n“`<\/p>\n
\n“`java
\nctx.with(MyInterface.class, myObject);
\n\/\/ retrieve as:
\nctx.get(MyInterface.class);
\n“`<\/p>\n<\/details>\nMAVEN<\/summary>\n
\n
\n
\n
\n<\/repository>
\n“`<\/p>\n
\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n<\/details>\nGRADLE<\/summary>\n
\nrepositories {
\n maven {
\n url “https:\/\/api.jetby.org\/”
\n name “jetby-repo”
\n }
\n}
\n“`<\/p>\n
\ndependencies {
\n compileOnly “me.jetby:Libb:VERSION”
\n}
\n“`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":"