CustomScreenMenu Plugin Documentation
A high-performance, fully customizable in-game menu plugin for modern Minecraft servers.
Native Folia support included.
For bug reports or suggestions, join the official Discord.
The open-source version doesn't come with tech support. Buying or donating is just a great way to encourage the author to keep developing and also get support and help for the plugin.
Core Features
- Future-proof: Stable on the latest Minecraft releases, compatible with Folia.
- Command-driven: Open or close any screen with a single command.
- Scenario-ready: Auto-display a personal start menu when a player first joins.
- 3-D item showcase: Hovering, rotatable models of held items.
- Extensible: Seamless integration with ItemsAdder, betterhud, and more.
Commands
| Command | Description |
|---|---|
/cursormenu run <name> |
Opens the custom menu with the given name. |
/cursormenu stop |
Instantly closes the active menu. |
/cursormenu items <item_name> |
Displays a 3-D model of the item in your hand. |
/cursormenu itemsstop |
Ends the current 3-D item preview. |
/cursormenu reload |
Reloads all configuration files (required after edits). |
Highlights
- 360° camera orbit around the menu or item.
- Join-trigger: Decide whether the menu should open automatically on every login.
- 3-D model settings: custom model-data, rotation toggle, glow toggle.
- Text placement: precise X, Y, Z offsets and tilt angles for any on-screen text.
- Instant teleport: warp the player the moment they enter the menu.
- …and many more configurable options.
PlaceholderAPI：
%cursormenu_current_menu% – the name of the menu currently open
%cursormenu_selected_option% – the name of the currently highlighted option
%cursormenu_display_item_id% – the ID of the item currently shown
%cursormenu_clicked_option% – the key of the text layout component that was just clicked
%cursormenu_menu_world% – the world in which the menu is located
%cursormenu_button_x% – X coordinate of the selected button
%cursormenu_button_y% – Y coordinate of the selected button
%cursormenu_button_z% – Z coordinate of the selected button
%cursormenu_is_attacking_or_breaking% – Determine whether the player is currently attacking and destroying blocks, with true as yes and false as no
Integrations
| Plugin | Added Capabilities |
|---|---|
| ItemsAdder | Floating 3-D models, live enchants & lore display, custom item panels. |
| betterhud | Render menu elements directly onto the player HUD for a seamless look. |
Demo Videos
- Demo 1 – Menu Interaction
- [Demo 2 – Menu example for registration and login <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/MEgSq2Zfnak" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
- Demo 3 – Advanced Menu Design
# CustomScreenMenu Plugin Documentation
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
CustomScreenMenu 1.5.0 1.5.0 |
1.19, 1.20, 1.21.11, 26.1.2, 26.2
|
paper, purpur, spigot, waterfall
|
Download |
|
CustomScreenMenu 1.4.9 1.4.9 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.20.5, 1.20.6, 1.21.4, 1.21.5, 1.21.10, 1.21.11, 26.1.2, 26.2
|
paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.8 1.4.8 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.6, 1.21.5, 1.21.11, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.7 1.4.7 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.6, 1.21.4, 1.21.5, 1.21.11, 26.1
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.6 1.4.6 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.6, 1.21.4, 1.21.11, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.5 1.4.5 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.6, 1.21.11, 26.1.1, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.4 1.4.4 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.20.6, 1.21.4, 1.21.5, 1.21.10, 1.21.11, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.3 1.4.3 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.20.5, 1.21.10, 1.21.11, 26.1.2
|
paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.2 1.4.2 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.21.10, 1.21.11
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.1 1.4.1 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.6, 1.21.4, 1.21.10, 1.21.11
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.4.0 1.4.0 |
1.19.4, 1.20, 1.21.4, 1.21.11
|
bukkit, paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.3.7 1.3.7 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.21.4, 1.21.8, 1.21.10, 1.21.11
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.3.6 1.3.6 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.3.5 1.3.5 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4
|
bukkit, paper, spigot
|
Download |
|
CustomScreenMenu 1.3.4 1.3.4 |
1.19.4, 1.20, 1.21.4, 1.21.8
|
folia, paper, spigot
|
Download |
|
CustomScreenMenu 1.3.3 1.3.3 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.21
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.3.2 1.3.2 |
1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.21
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.3.1 1.3.1 |
1.19.4, 1.20, 1.21, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.3.0 1.3.0 |
1.19, 1.20, 1.20.4, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.9 1.2.9 |
1.20.4, 1.21, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.8 1.2.8 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.21
|
paper, purpur, spigot
|
Download |
|
CustomScreenMenu 1.2.7 1.2.7 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.6 1.2.6 |
1.19, 1.19.4, 1.20, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.5 1.2.5 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20.4, 1.21, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.4 1.2.4 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.21, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.2.3 1.2.3 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.21, 1.21.1, 1.21.4
|
paper, spigot
|
Download |
|
CustomScreenMenu 1.0.0 1.1 |
1.19.4, 1.20, 1.21
|
folia, paper, spigot
|
Download |