Item Browser GUI

/ei browse opens a two-level browser: the first level lists item packs, clicking a pack icon opens the second level listing the items inside it, and a left click takes one piece into the inventory (Shift + left click takes a full stack). Each level offers its own slot types, and each pack is described by the metadata file pack.yml

Each level has its own layout file, both under plugins/EmakiItem/gui/:

File	Level	Purpose
pack_browser_gui.yml	First	Lists every item pack under items/
item_browser_gui.yml	Second	Lists all items inside one pack

Check this before you open it: the command requires the emakiitem.browse permission (default op) and is player-only. /ei browse [page] jumps straight to a page, counted from 1; values below 1 resolve to page 1, and a value beyond the total page count opens an empty page you can leave with the page buttons

Pack metadata: pack.yml

You can drop a pack.yml into every subdirectory under items/ to define how that pack's icon looks on the first level

Items placed directly in the items/ root also form a "root pack": its pack id is the empty string, it still appears in the first-level list, and its display name comes from the browser.default_pack_name language key

display_name: "<gold>Example Item Pack</gold>"
icon: "minecraft-chest"
lore:
  - "<gray><white>%count%</white> items</gray>"
  - "<dark_gray>Pack id: %pack%</dark_gray>"
  - ""
  - "<yellow>Click to browse</yellow>"
order: 10

Key	Default	Description
display_name	directory name	Pack name shown on the first level, with MiniMessage support. Empty falls back to the directory name
icon	minecraft-chest	Pack icon as a CoreLib ItemSource shorthand, the same syntax as item.source in an item definition
lore	item count	Lore for the pack icon. %count% is the pack's item count and %pack% is the pack id
order	100	Sort weight on the first level, ascending

Keep three points in mind before you write pack.yml:

• The pack id comes from the directory's relative path, independent of pack.yml contents
• Without a pack.yml, everything falls back: a minecraft:chest icon, the directory name as display name, and lore showing the item count
• pack.yml is not read by the item loader as an item definition

Which packs you can see is limited by data_directories.max_depth in config.yml; directories beyond that depth do not become separate packs

First-Level Slot Types

type	Purpose
pack_entry	Pack icon area, filled by ascending order (pack id lexicographic order breaks ties), paginated when it overflows. Clicking opens that pack's second level
page_prev / page_next	Page turning
page_info	Page numbers and statistics
close	Closes the window
filler	Decorative filler

Placeholders available to pack_entry and page_info:

Placeholder	Where	Meaning
%pack%	pack_entry	Pack id
%pack_name%	pack_entry	Pack display name
%pack_lore%	pack_entry	Pack lore taken from lore in pack.yml, or fallback text when undefined
%count%	pack_entry	Item count in that pack, the same value as %item_count%
%item_count%	pack_entry	Item count in that pack
%current_page% / %total_pages%	page_info	Current page number and total page count
%pack_count%	page_info	Total pack count
%item_count%	page_info	Total number of loaded item definitions

Second-Level Slot Types

type	Purpose
item_entry	Item icon area, filled in item id lexicographic order and paginated when it overflows. Left click takes one piece, Shift + left click takes a full stack; right clicks do nothing
back	Returns to the first level
page_prev / page_next	Page turning
page_info	Page numbers and statistics
close	Closes the window
filler	Decorative filler

The item icon itself is rendered from the item definition; when the slot declares lore, it is appended on top of the item's own lore

On the second level, page_info supports %current_page%, %total_pages%, %pack% (current pack id), %pack_name% (current pack name), and both %item_count% and %count% (item count in the current pack)

Page Capacity Comes From the Layout

How many entries fit on a page depends on how many cells pack_entry / item_entry declare in the layout, not on a fixed number. The default layouts give 21 cells on both levels (rows 2 through 4 minus the side borders)

Change the cell count of those areas and pagination changes with it; the page buttons need no adjustment

Related Pages

• Commands and Permissions
• Item Definitions