# Moxvallix’s GUI Lib
\n## Making Datapack GUIs easier<\/p>\n
**Moxvallix’s GUI Lib relies on Taglib, and Moxlib** <\/p>\n
This datapack automates much of hard parts of GUI development.
\nIt is data driven, meaning it renders the GUI based on a template stored in data storage.<\/p>\n
Currently, the library works in two modes; “enderchest”, and “barrel”. In “enderchest” mode, the GUI is drawn
\nto the player’s Enderchest. This overrides whatever contents were previously in the enderchest, so be warned!
\nEnderchest mode is the easiest to use, and is best for Adventure maps, where the main Enderchest functionality
\nis not needed.<\/p>\n
The other, “barrel”, mode, draws the GUI to a container at ~ ~ ~. While this works with any container block,
\nit is advised that a Barrel is used, as that allows for it to detect when the container is opened, allowing for it
\nto then easily prevent other players using the GUI whilst the first player is.<\/p>\n
One benefit of this GUI system, being data driven, means that making generators for GUIs should be fairly easy.
\nI however have not created one yet.<\/p>\n
### Getting Started Note: type “barrel” should be executed at the same position as a container block. If you have multiple GUIs in your packs, There are two main functions: `gui:api\/ All functions outside of the api\/ subfolder are to be considered private, and are not supported to be ran.<\/p>\n The watch function should be run as the player, on a loop, whenever the GUI should be active. #### Making an Index It is recommended that you set the template data within a separate function, and that index merely calls said function.<\/p>\n *An example index function* You will then need to register your index function to run in the index tag. Add it to the `gui:index` function tag. #### Making a Template *An example template function (pack:gui\/menu)* If you want to try it out, make sure to set your `gui.page` score to 1, then run either `gui:api\/ #### Manipulate Slots as they Render Every time a slot is going to be rendered, it first calls the `gui:render\/slot` function tag. The current slot data will be available to be manipulated from the data storage `gui:slot current`.<\/p>\n Render will also call the function tag `gui:render\/item`, with @s being a temporary armor stand, #### Custom Functionality on Selection Whenever a slot is selected, it calls the `gui:select\/slot` function tag, You will then be able to read the selected slot from the data storage `gui:slot current`.<\/p>\n","protected":false},"excerpt":{"rendered":" This datapack automates much of hard parts of GUI development.
\n#### Overview
\nDepending on whether the GUI should be drawn to a container, or the Enderchest, the API is namespaced under “barrel”,
\nor “enderchest” respectively. The following guide will use `
\nmethod.<\/p>\n
\nyou may want to have entities positioned at the same location as the block, executing at them.<\/p>\n
\nRender will draw the gui, based on the page id, and watch will run any clicks in the GUI.<\/p>\n
\nIf you wanted the GUI always active, you could set it to run as @a from your tick function.<\/p>\n
\nFor your GUI to work, you will need an index function.
\nSuch a function, when run, will take in `@s` score of `gui.page`, and will set the correct template data for that page.<\/p>\n
\n“`
\nexecute if score @s gui.page matches 1 run function pack:gui\/menu
\nexecute if score @s gui.page matches 2 run function pack:gui\/options
\nexecute if score @s gui.page matches 3 run function pack:gui\/shop
\n“`<\/p>\n
\n“`
\n{
\n “values”: [
\n “pack:gui\/index”
\n ]
\n}
\n“`<\/p>\n
\nNow we can create GUI templates. These will be functions that the index will run.<\/p>\n
\n“`
\ndata modify storage gui:page template set value [{slot:12b,page:2s,item:{id:”minecraft:redstone_dust”}},{slot:14b,page:3s,item:{id:”minecraft:chest”}}]
\n“`
\nThe above menu template would render two items to the GUI, one in slot 12, the other in slot 14.
\nSlot 12:
\n – has page:2s, would render `pack:gui\/options` when clicked
\n – has an item tag, setting the item to `redstone_dust`
\nSlot 14:
\n – has page:3s, would render `pack:gui\/shop` when clicked
\n – has an item tag, setting the item to `chest`<\/p>\n
\nhave `gui:api\/
\nSometimes, you will want to manipulate slots as they render, such that you can have dynamic menus.
\nYou can add any custom tags you like to the slots in your template data, as long as the `slot` tag is defined.<\/p>\n
\nYou can add a custom function to this tag, in order to manipulate the slot data.<\/p>\n
\nand the current item being rendered in its mainhand. This will allow for item modifiers to be run.<\/p>\n
\nAnother key part of a gui is being able to run custom functions when a particular slot is selected.<\/p>\n
\nas the player that selected the slot.<\/p>\n
\nIt is data driven, meaning it renders the GUI based on a template stored in data storage.<\/p>\n","protected":false},"featured_media":106635,"template":"","meta":{"_minecraft_slug":"moxgui","_minecraft_project_id":"lwRi0J1U","_minecraft_author":"moxvallix","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":186,"_minecraft_follows":2,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"moxgui.zip","_minecraft_size_bytes":88203,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:01:44.937300Z","_minecraft_date_created":"2022-12-30T21:38:29.458957Z","_minecraft_date_modified":"2023-01-10T16:18:37.696850Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/moxgui","_minecraft_icon_attachment_id":106635,"_minecraft_imported_at":"2026-06-06T03:46:22+00:00","_minecraft_import_hash":"c437f9f4854e356d0d1bca6064240d4f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,873],"mod_loader":[86],"minecraft_version":[54,55,56,57],"class_list":["post-106634","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-library","mod_loader-datapack","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3"],"yoast_head":"\n