> For the complete documentation index, see [llms.txt](https://pm2plugins.gitbook.io/guiplus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pm2plugins.gitbook.io/guiplus/home.md).

# Home

*Create and edit inventory menus directly in Minecraft.*

***

GUIPlus lets you build server menus with an in-game editor or YAML. Add commands, conditions, animated scenes and player input, then reuse shared buttons across your menus.

These pages describe **GUIPlus 4.0.0**. If you have just installed it, try `/rewards` for working Daily Rewards, Playtime Milestones and a Starter Choice. You can change the actual prizes with `/gui practical edit`.

## ✨ Key Features

| Feature                                                                          | What you can do                                                                                    |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| [In-game editor](/guiplus/creating-guis/creating-guis.md)                        | Create menus, copy items, change appearance and configure actions without writing YAML.            |
| [Scenes and animations](/guiplus/creating-guis/scenes.md)                        | Build pages, timed sequences and animated lore.                                                    |
| [Click events](/guiplus/creating-guis/click-events.md)                           | Run commands, give items, use an economy, open another menu or ask for player input.               |
| [Conditions](/guiplus/creating-guis/conditions.md)                               | Check permissions, balances and saved values; choose which items appear and which actions can run. |
| [Button states](/guiplus/creating-guis/button-states.md)                         | Give one button Locked, Ready and Owned states with shared text values.                            |
| [Interaction flows](/guiplus/interactive/interaction-flows.md)                   | Collect several answers, offer choices and let the player review before confirming.                |
| [Input rules](/guiplus/interactive/input-rules.md)                               | Accept bounded numbers, player names, enum choices and validated text.                             |
| [Ready-to-use rewards](/guiplus/tutorials-and-resources/ready-to-use-rewards.md) | Start with real vanilla rewards, then edit bundles and timing in game.                             |
| [Shared components](/guiplus/creating-guis/shared-components.md)                 | Link buttons to one template while keeping local names and lore.                                   |
| [Warp catalogs](/guiplus/integrations/warp-catalogs.md)                          | Generate a searchable, paged menu from your EssentialsX warps.                                     |
| [Personal storage](/guiplus/interactive/personal-storage.md)                     | Give players saved item storage with permission-based sizes.                                       |
| [Player data](/guiplus/interactive/player-data.md)                               | Save per-player values for your own menus and progression.                                         |
| [Custom items and heads](/guiplus/interactive/custom-heads-and-skulls.md)        | Use held-item metadata, custom textures and player heads.                                          |
| [Integrations](/guiplus/integrations/plugin-integrations.md)                     | Connect menu actions to Vault, PlaceholderAPI and your other server plugins.                       |

## 📋 Requirements

|                     | GUIPlus 4.0.0                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| **Server profiles** | Paper and Spigot 1.21.11; Paper 26.3                                                                  |
| **Java**            | Java 21 or newer, and the Java version required by your server. Paper 26.x requires Java 25 or newer. |
| **Folia**           | Not supported.                                                                                        |
| **Default rewards** | No economy plugin, PlaceholderAPI or resource pack required.                                          |

Older GUIPlus downloads have their own requirements. Do not use an old release's Minecraft version list for the V4 JAR.

## 🧩 Optional Plugins

| Plugin                                     | Used for                                                                       |
| ------------------------------------------ | ------------------------------------------------------------------------------ |
| Vault and an economy provider              | Balance conditions, money actions and banking.                                 |
| PlaceholderAPI and the relevant expansions | Other plugins' placeholders and ordinary GUIPlus player-data display.          |
| EssentialsX                                | The automatic warp catalog; other Essentials commands remain Essentials-owned. |
| PlayerPoints                               | Points conditions and removal actions.                                         |
| HeadDatabase                               | Selecting heads from its database.                                             |
| Multiverse-Core                            | Menus that use its worlds or commands.                                         |

Only install an integration if your menu uses it. See [Plugin Integrations](/guiplus/integrations/plugin-integrations.md) for examples.

### ⚙ Getting Started

|                                                                                   |                                                              |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [🚀 Getting Started](/guiplus/getting-started/getting-started.md)                 | Installation, first reward and first custom menu.            |
| [📋 Commands & Permissions](/guiplus/getting-started/commands-and-permissions.md) | Player commands, authoring commands and access.              |
| [⚙ Configuration](/guiplus/getting-started/configuration.md)                      | Main settings, backups and refresh intervals.                |
| [🔄 Updating & Backups](/guiplus/getting-started/updating-and-backups.md)         | Update an existing server and keep a matching rollback copy. |

### 🎨 Creating GUIs

Start with [Creating GUIs](/guiplus/creating-guis/creating-guis.md), then add [scenes](/guiplus/creating-guis/scenes.md), [animations](/guiplus/creating-guis/animations.md), [click events](/guiplus/creating-guis/click-events.md) and [conditions](/guiplus/creating-guis/conditions.md). For reusable menus, see [Button States](/guiplus/creating-guis/button-states.md) and [Shared Components](/guiplus/creating-guis/shared-components.md).

### 💬 Interactive Menus

[Chat Fetcher](/guiplus/interactive/chat-fetcher.md) handles a single prompt. [Interaction Flows](/guiplus/interactive/interaction-flows.md) collect several answers with a review screen. Both use [Input Rules](/guiplus/interactive/input-rules.md). [Player Data](/guiplus/interactive/player-data.md) stores values you want to keep after the menu closes.

### 📖 Practical Examples

Try [Ready-to-Use Rewards](/guiplus/tutorials-and-resources/ready-to-use-rewards.md), an [EssentialsX Warp Catalog](/guiplus/integrations/warp-catalogs.md) or [Personal Storage](/guiplus/interactive/personal-storage.md). The [Tutorials](/guiplus/tutorials-and-resources/tutorials.md) and [Premade Configurations](/guiplus/tutorials-and-resources/premade-configurations.md) cover custom menus. `/gui examples` installs editable progression, unlock and choice demonstrations.

### ❓ Help & Development

[FAQ & Troubleshooting](/guiplus/help/faq-and-troubleshooting.md) · [Tips & Best Practices](/guiplus/tutorials-and-resources/tips-and-best-practices.md) · [Developer API](/guiplus/for-developers/developer-api.md)

## 💬 Support

For help, use the plugin's Discord or your purchase platform. Include your GUIPlus version, server version and the relevant console error. For menu problems, include the smallest configuration that reproduces them.
