BloomGUI-Folia

No-code GUI menus for Paper & Folia. Build menus in-game or in your browser, no YAML editing required.

Built on FoliaGUI-API, a thread-safe GUI library for Folia/Paper servers.

What it does

Drag-and-drop menu editor, in-game (/bloom edit) or in a web editor the plugin hosts itself Multi-page menus with shared items (borders, nav buttons) and per-page overrides 7 GUI types: chest, workbench, hopper, dispenser, brewing stand, storage, merchant Storage menus act like a personal Ender Chest per player, saved to SQLite or MySQL Merchant menus are real villager trade windows with custom items as cost/reward 23 actions and 6 conditions to control what happens on click and who can see/click things Built in placeholders like %player_name% and %server_tps%, no PlaceholderAPI needed for the basics Item presets, snippets, and templates so you're not rebuilding the same stuff over and over Version history and live sync, so two people editing the same menu won't loose each others changes

Requirements

Paper or Folia 1.21+ Java 21 Optional: Vault (for economy stuff), PlaceholderAPI (for extra placeholders), MySQL (only if you want storage vaults shared across multiple servers)

Install

Drop the jar in plugins/ Restart the server You're op? You already have access. Otherwise grant bloomgui.admin and bloomgui.web

Commands

Command	Does
/bloom menu	Opens the dashboard
/bloom create [id]	Makes a new menu
/bloom edit [id]	Edit a menu in-game
/bloom open [id] [player]	Open a menu
/bloom delete [id]	Delete a menu
/bloom web	Starts the web editor, sends you a link + login code in chat
/bloom stats	Quick dump of TPS, memory, cache hit rate etc
/bloom reload	Reload menus from disk

The web editor

/bloom web spins up a small self-hosted server, no database or external hosting needed. Each session starts from a one-time login code sent to your chat, not a saved password, and it expires after a few hours.

Note: the port (8123 default) needs to be reachable from wherever your browsing from. Some hosts don't let you forward ports, in that case just stick with the in-game editor.

Tabs: Menus, Snippets, Templates, Items, Docs.

Storage vaults

Set a menu's type to Storage and it becomes a real per-player inventory instead of a static layout. Works per-page too, so page 2 is it's own separate storage space from page 1. Backed by SQLite by default, or MySQL if you need vaults shared across server nodes.

Merchant menus

Set a menu's type to Merchant for a villager-style trade window. Configure a result item and 1-2 ingredients per trade, using plain materials or your own saved item presets.

Known limitations

In-game editor is missing some stuff the web editor has (enchants, cycling items, conditional lore, item presets, merchant trades) No shield builder for item presets yet MySQL storage backend works but hasn't been battle tested as much as SQLite, test it yourself before relying on it money/placeholder conditions pass open if Vault/PPAPI aren't installed, so don't treat them as a hard lock

Building from source

mvn clean package

Java 21 + Maven, runs the test suite and spits out a shaded jar at target/BloomGUI-Folia-<version>.jar.

Built on FoliaGUI-API · Java 21 · Paper & Folia 1.21+