Milestone Update：This version is a turning point. The plugin is set to enter the 1.4.0 era in the next release.

New Features：

• Fully Customizable Login/Registration System
• Complete support for player registration, login, password visibility, and account record-keeping.
  
• Local SQL player data storage is now supported.

Bug Fixes：

• Fixed the issue with teleportation not supporting return to a specified coordinate in version 1.21.8.
• Fixed password errors during player login and registration in the test version.

Changelog – v1.3.6：

• Added link functionality: Add link: "[link]https://xxxxxxx" in the configuration to send a clickable link that redirects to a webpage.

• Fixed an issue where, when a player was in a menu and used the /cmenu reload command to reload the configuration, if camera-block-check was enabled, the blocks that were removed would not be restored after exiting the menu.

New Features

• Password input variables
  • %cursormenu_input_password% captures the first chat message entered by the player.
  • %cursormenu_password_visibility% returns whether the entered content is currently visible.
  • %cursormenu_input_confirm_password% captures the second confirmation input by the player.
• Same-level sub-menus: Directly expand sub-pages under the same coordinates without needing to exit and re-enter.
• Instant main-menu switch: If the world and coordinates match, directly refresh to another main menu without going through the “close-reopen” process.
• Text hover effects: Default is off. When enabled, highlights/shadows are displayed when the mouse hovers over text.
• SQL data storage support.
• Experimental WorldGuard compatibility: Initial support for region detection, with ongoing improvements.

Fixes & Optimizations

• Fixed several minor bugs.
• Optimized code structure to enhance overall performance.

New / Breaking：

• Switched core dependency from ProtocolLib to PacketEvents – ProtocolLib is no longer required.
• Velocity cross-server teleport compatible – use [server] <target> in any command list.
  
• Custom cursor size – set your own pointer scale in menus.
  
• Custom cursor movement area – restrict how far the cursor can travel.
  
• Squashed various small bugs and trimmed dead code for a smaller, faster jar.
  The latest version is 1.3.7.

Changelog – v1.3.3
New Features

• Per-button “random-probability commands”
• Activate by setting `random-commands` and `random-chances`
• The plugin picks one command to run based on the listed probabilities (e.g. `[10,50,40]` → 10 %, 50 %, 40 %)
• Falls back to standard `commands` if random arrays are absent

Tweaks

• Updated every menu language file with new random-command placeholders/messages

⚡ Optimizations

• Refactored internals to keep random and legacy logic completely conflict-free

Changelog – v1.3.2

Bug Fixes： Delayed commands no longer execute after the player leaves the menu Fixed broken menu commands in config; they now parse correctly again

New Features： Menus support usage conditions: open/click only allowed when specified requirements are met

Misc： Plugin is back to its regular release cycle—expect steady updates ahead

Changelog – v1.3.1

Bug Fixes：

• Fixed inaccurate delay-command timing
• Fixed menu break on first teleport to distant coordinates due to unloaded chunks

⚡ Optimizations：

• Removed unused code for better performance and maintainability
  
  (PS: The latest version has been updated to 1.3.4, and the version being sent now is the free version)

Changelog – v1.3.0
Breaking Changes Delete and back up your old configs, then let the plugin generate fresh ones!

Bug Fixes：
Fixed various minor bugs

New Features：

• Per-button command delay in menus
• Custom command executed when a player first joins the server
• Completely restructured config: each menu is now in its own file, making creation and editing effortless
• Global command delay per menu
• Players can open any menu from anywhere with a single command

Changelog – v1.2.9
Bug Fixes：

• Plugin fails to load ProtocolLib after renaming
• Players blocked from opening menu due to name or range-check errors
• /spawn and other teleport commands fail when stopmenu is enabled
• Players who disconnect or are kicked while in a menu can’t rejoin normally
  
  New Features：

• Toggleable range check: when enabled, nearby blocks are removed on menu open and restored on close
  
  Optimizations：

• Removed redundant code for improved performance
  
  (PS: The current latest version 1.3.2)

Changelog – v1.2.8

Bug Fixes：

• Fix the menu button when clicked will directly cause the player to exit the menu

Changelog – v1.2.7

• Reduced oversized click area between buttons
  
• Fixed teleportation failures
• Resolved locked camera after teleporting

Changelog – v1.2.5
Bug Fixes

• Fixed compatibility issue where custom whitelist commands only worked with vanilla commands.
• Resolved limitation where newly added menu command execution only functioned in the "world" dimension.
• Jump Menu: Fixed variables not applying after transitioning to another menu.
• Teleportation: Added customizable facing direction post-teleport.
• Fixed teleportation function not working as intended.
• Fixed initial cursor position to start at a designated spot.

New Features

• Customizable Jump Menus: Added configurable jump menus for flexible navigation.

⚠️ Note: Due to config structure changes, backup your old config before updating to let the plugin generate a new one.

Text Control Commands: Added support for opening text displays via commands.
/cursormenu text open <textID> [player]

Configuration Updates：

Pumpkin Overlay: Players now automatically get a pumpkin overlay when entering menus (configure via use-pumpkin-overlay: true).
Command Whitelist: Added support for customizable command whitelists to restrict executable commands.

Bug Fixes

Fixed issue where text displays from text.yml persisted after reloading.

Fixed Y-axis coordinate failure for newly added layout components (ensure layout1’s Y-axis is non-zero before adding others).


Notes

Layout component Y-axis positions depend on layout1’s Y-axis value. Configure a non-zero Y-axis for layout1 before adding new layouts.

(PS: The current latest version 1.2.6)

### Changelog – v1.2.3
#### ✅ Fixes
- **Fixed**: Custom-model-data cursors were not loaded after every server restart.
#### New Features
1. **Auto-Config Generation**
- On startup the plugin checks for missing files and automatically creates fresh defaults.
2. **Extended Text Styles**
- Added new display modes: text rotation, bottom-to-top flow, and left-right direction.
- See the freshly generated `test.yml` for usage examples.
3. **Gamemode Sync**
- Switching to the camera view automatically sets the player to **Adventure** mode.
- Disconnecting or leaving the view restores **Survival** mode.
- Works seamlessly with **ItemsAdder** and **BetterHud** to hide the crosshair.
4. **Player-State Variable**
- New placeholder: `cursormenu_is_attacking_or_breaking`
- Returns `true` while the player is attacking an entity or breaking a block, otherwise `false`.
5. **Per-Player Menu Command**
- New command: `/cursormenu run test <player>`
- Opens the specified menu for the given player without affecting others.
6. **Granular Permissions**
- Added to `config.yml`:
- Menu-level permission nodes (e.g. `cursormenu.button.test.layout1`).
- Individual button permissions within any menu.

New placeholders:
- %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


Add a new folder lang/ inside the plugin’s data directory.

Inside it, place one file per language:

• lang/en_us.yml – English example
• lang/ru_ru.yml – Russian example
• lang/zh_cn.yml – Chinese example

Each file contains the same keys and only the translated strings.
Fix: prevent menu overlap when /cursormenu run is used while already in camera mode.