What's New in Version 1.1.8
1. New INPUT Action Type
Prompts the player for text input using an Anvil menu. The input can then be used in subsequent commands.


YAML Example:

• Placeholder: {text} or {renameText} will be replaced with the user's input.
• Inline Syntax: - input: "Title;command {text}"
• Dynamic Menus: If the title provided doesn't match a predefined menu, Sheets will dynamically create an Anvil menu for the input.

2. Click-Type Specific Actions
Execute different actions based on how a player interacts with a button in a Java GUI.


Supported Types: left, right, shift, middle.


YAML Example:



3. Chest Edit Mode (Live Editing)
Java players can now edit normal menus visually.

• How to use: Right-click a sheet in the /sheets edit menu, or run /sheets edit <menu> chest.
• Functionality: Drag and drop items in the inventory. Closing the inventory automatically saves the layout as buttons in the YAML file.

4. Menu Templates
Quickly create new sheets using pre-defined templates.

• Templates folder: menus/templates/
• Default templates: basic_gui, simple_inventory, anvil_input.
• Usage: /sheets create <name> <template> or via the graphical template selector.

5. Argument Action
Set local variables/arguments that can be used in subsequent actions or in the next opened menu.


YAML Example:


6. Anvil Menu Improvements

• Real-time Updates: Anvil menus now refresh every second (20 ticks), allowing placeholders like {text} to update in item names and lore as the player types.
• Auto-Confirm: Integrated support for confirm buttons in slot 2 of Anvil menus.
• Auto-Close: Input menus now automatically close after the confirmation action is executed.

Dynamic Placeholders & Variables

1. Sheets Internal Placeholders:
   • %sheets_sheet_[index]_name%: Name of the Nth sheet.
   • %sheets_sheet_[index]_exists%: Whether the Nth sheet exists.
   • %sheets_template_[index]_name%: Name of the Nth template.

Bedrock Images
Updated Material Images

New Commands

• /sheets create <name> [template] - Creates a new sheet.
• /sheets edit [name] [chest] - Opens the editor menu or a specific sheet in chest mode.
• /sheets delete <name> [confirm] - Deletes a sheet.
• /sheets rename <old> <new> - Renames a sheet.

- Added Multiple new menus

Version 1.1.7 Update

Menu System Enhancements
Bedrock & Java Player Integration
- Added support for Java player actions when attempting to open Bedrock-only menus
- Bedrock-only menus can now specify custom actions for Java players using `java_actions`
- Java players can be redirected to alternative menus or receive custom messages
- Improved user experience for both Bedrock and Java players

Example Usage

Code (YAML):

# Set this menu to be Bedrock-only
bedrock_only : true

# Actions to execute when Java players try to open this menu
java_actions:
  - message : "&aThis menu is only for Bedrock players, but you can use these Java-specific features instead!"
  - sound : "ENTITY_PLAYER_LEVELUP"
  - menu : "create_sheet"

Sheets Plugin - Update 1.1.6: Enhanced Action Sequence Reliability
Release Date: February 8, 2025

What's New?

• Improved Action Sequence: Actions now execute sequentially and stop immediately if one fails, preventing cascading errors and ensuring a more reliable experience.
  
  
• Version Bump: The plugin version has been updated to 1.1.6, reflecting these enhancements.
  

Enjoy the improved stability and performance with Sheets Plugin 1.1.6!

Sheets Plugin - Update 1.1.5: Enhanced Benchmarking, Dynamic Replacers & Form Overhaul
Release Date: February 7, 2025

What's New?
Benchmarking Enhancements

• Benchmark Mode: A new benchmarking mode has been added to the configuration, allowing you to measure and monitor key operations. This helps in identifying performance bottlenecks and optimizing your server setup.
  
  
• Built-in Benchmarks: Timings for important tasks are now captured, giving you insight into how long operations such as menu construction and command registration take.
  

Inventory Optimization

• Pre-Build Inventory Open: The inventory now opens before buttons are built. This change ensures that users experience a more responsive and smoother menu interaction, reducing lag during button construction.
  

Form Improvements

• Improved Form Buttons: Form buttons have been refined for better responsiveness and appearance.
  
  
• Updated Replacers in Forms: Replacer functionality for forms has been updated to ensure that dynamic content is processed correctly, including proper handling of arguments.
  
  
• Fixed Argument Handling: Issues with form argument passing have been resolved, ensuring that all parameters are correctly interpreted.
  
  
• Visual Consistency: Updated form images for materials and fixed view requirements, providing a more consistent and polished look across all forms.
  

Advanced Replacer System

• New Replacer Tokens:
  
  • [slot]: Inserts the button slot position.
    
    
  • [index]: Inserts the button index.
    
    
  • [material], [amount], [name], [price]: Display item-specific details directly within your menus.
    
• Mathematical Expression Support:
  
  • {math:expression}: Evaluates a mathematical expression dynamically.
    
    
  • {math:int:expression}: Evaluates a mathematical expression and returns an integer value.
    
• Enhanced Replacement Logic:
  
  • Replacers now also process inside variables and arguments, providing greater flexibility and dynamic content rendering.
    
    
  • Added support for fetching list sizes from variables, making it easier to work with arrays and collections.
    
    
  • Improved slot ordering by adding a "to" keyword in slot definitions.
    
    
  • Integrated arguments action and saving to functions for more complex command workflows.
    
    
  • Made the size parameter a string for better formatting.
    
    
  • Fixed priority issues with the DeluxeMenus converter to ensure smoother integration.
    

Additional Optimizations and Fixes

• Condition Requirements: Improved condition requirement checks, including fixes for balance-related issues.
  
  
• Command Registering: Optimized the command registration process for faster and more reliable performance.
  
  
• Small-Caps Formatting: Enhanced small-caps text formatting for a cleaner, modern look in your menus.
  
  
• Overall Performance: Optimized menus and buttons for better performance and reduced resource usage and improved larger menus by up to 90%
  

This update brings a host of improvements aimed at boosting performance, enhancing dynamic content capabilities, and refining the visual and functional aspects of menus and forms. Enjoy the smoother, more responsive experience with Sheets Plugin 1.1.5!

Sheets Plugin - Update 1.1.4: Config Enhancements & Named Arguments
Release Date: January 8, 2025

What's New?
1. Config Enhancements

• Added Small-Caps Support to the configuration for more customization options.

2. Named Command Arguments

• Introduced Named Arguments for commands, improving readability and flexibility.

Other Changes

• Minor tweaks and improvements.

Sheets Plugin - Update 1.1.3: Enhanced Variables & Floodgate Support
Release Date: January 8, 2025

What's New?
1. Enhanced Variable System

• Maps and Lists are now supported in variable replacers for more complex configurations.
• Added a Variables Folder and support for Variable Files.
• Included an Example Variable File to help users get started.
• Introduced Variable Parsers for dynamic processing.

Enhancements
Improved Floodgate Support

• Better integration with Floodgate, enhancing compatibility with Bedrock players.

Required Items

• Enhanced handling of Required Items, ensuring smoother and more reliable checks.

Improved Logger

• Added Logger Formatting for cleaner logs.
• Upgraded the Logger System for better debugging and readability.

Sheets Plugin - Update 1.1.2: Improved Commands & Dynamic Reload
Release Date: January 5, 2025

What's New?
1. Improved Command System

• Enhanced the Command System for better performance and flexibility.
• Added support for newer Minecraft versions, primarily 1.21.3, ensuring compatibility with the latest updates.

Enhancements
Dynamic Configuration Reload

• Updated /sh reload command to dynamically reload variables and messages without requiring a server restart.

Platform-Specific Button Handling

• Added support for platform-specific button configurations, allowing finer control over Bedrock and Java button setups.

Other Changes

• Removed obsolete files, ensuring a cleaner and more efficient plugin structure.

Sheets Plugin - Update 1.1.1: Placeholder Improvements & Debug Enhancements
Release Date: December 30, 2024

What's New?
1. Placeholder Updates

• Enhanced placeholders for better functionality and integration with dynamic data.

2. Path Formatting Enhancements

• Improved path formatting for better consistency and reliability in configuration and menu structures.

3. Debug Mode

• Added a Sheets Debug Mode to help diagnose issues and assist with troubleshooting during development or configuration.

Bug Fixes

• Fixed various issues with path handling in the plugin configuration and menu system.

This update focuses on refining existing features, improving placeholder functionality, and introducing a debug mode to enhance your workflow. Update now to explore these enhancements!

Sheets Plugin - Update 1.1.0: Major Improvements & New Features
Release Date: December 29, 2024

What's New?
1. Async Command Registration

• Commands are now registered asynchronously, improving performance and reducing potential lag during initialization. overriding other commands

2. Enhanced Requirement System

• Improved handling of requirement types and values for better flexibility.
• Requirements now accept maps for more complex configurations.
• Added debugging support for the balance requirement type to assist with troubleshooting.
• Fixed parsing and validation issues in requirements.

3. Item Parser and Related Features

• Introduced the Item Action Type and Item Requirement Type, enabling menus and actions to handle item-specific logic.
• Fixed issues related to price handling, ensuring reliable functionality for item pricing.

4. String Processing Enhancements

• Improved string replacers by processing variables before arguments, resulting in more accurate and dynamic string replacements.

5. Configuration Updates

• Added more customizable messages to the configuration file to improve user feedback and clarity.

Bug Fixes

• Resolved missing arguments in various menu and button functions.
  

This update introduces powerful new features, optimizations, and bug fixes, making Sheets more robust and flexible than ever. Update now to take advantage of these enhancements!

Sheets Plugin - Update 1.0.9: Command Actor Fixes
Release Date: December 28, 2024

What's New?
1. Command Actor Fixes

• Resolved issues related to command actors not functioning correctly in certain scenarios.
• Improved handling of command execution across different actors, ensuring reliable performance.

Bug Fixes

• Fixed errors caused by incorrect command actor recognition.
• Improved stability for command-based features.

This update focuses on improving command execution reliability. Update now for a better experience!

Sheets Plugin - Update 1.0.8: Stability Fixes for Paper and PlaceholderAPI
Release Date: December 27, 2024

What's New?
1. Paper Compatibility Fixes

• Resolved compatibility issues with Paper servers, ensuring smoother performance and full feature functionality.

2. PlaceholderAPI Fixes

• Addressed bugs causing placeholders to malfunction under certain conditions.
• Improved placeholder handling for better reliability.

Bug Fixes

• Fixed crashes related to PlaceholderAPI integration.
• Resolved errors during placeholder parsing for specific keys.

This update ensures greater stability and compatibility, especially for Paper and PlaceholderAPI users. Update now to enjoy a seamless experience!

Sheets Plugin - Update 1.0.7: PlaceholderAPI Support & Improvements
Release Date: December 26, 2024

What's New?
1. PlaceholderAPI Expansion

• Added support for PlaceholderAPI with new placeholders:
  • Global Variables:
    %sheets_variable_<key>% - Get the value of a global variable.
  • Formatted Placeholders:
    %sheets_format_<value>% - Dynamically format placeholders.
  • Requirement Checks:
    %sheets_requirement_<requirement>% - Check if a requirement is met.
  • Menu Count:
    %sheets_total% - Show the total number of menus.

2. Improved Requirement Handling

• Easily check if players meet specific requirements using placeholders.

3. Better Menu Management

• %sheets_total% now shows the total number of menus dynamically.

Bug Fixes

• Fixed placeholder crashes with invalid keys.
• Ensured placeholders persist after plugin reloads.

Examples:

• %sheets_variable_example%: Returns the value of the variable example.
• %sheets_requirement_balance_100%: Returns true if the player meets a balance of 100.
• %sheets_total%: Shows the total number of menus (e.g., 5).

This update makes Sheets more flexible and powerful with dynamic placeholders. Try it out and let us know your thoughts!

Sheets Plugin - Update 1.0.6: Complete Rewrite, Commands, DeluxeMenus Converter

Release Date: December 25, 2024

New Features & Enhancements:

1. Complete Rewrite in Kotlin
   
   • The plugin has been entirely rewritten in Kotlin, resulting in cleaner code, improved performance, and easier maintainability.
2. Anvil Menu Enhancements
   • Introduced Anvil menus with advanced rename text functionality. Use {text} as a placeholder for dynamic rename text values.
3. Expanded Requirement Types
   
   • Added new requirement types, such as permission and balance, to provide more dynamic options for conditions.
   • Extended conditions for requirement types to allow for more complex checks.
4. New Action Types
   
   • Introduced a variety of new action types to increase interactivity and customization:
     • Teleport: Move players to specific coordinates.
     • Server: Transfer players between servers.
     • World: Change a player's world.
     • Broadcast: Send global messages to all players.
     • Balance: Modify player balances (positive values add; negative values subtract).
     • Permission: Dynamically grant or revoke permissions using Vault (! prefix removes permissions).
     • Broadcast-Sound: Play global sound effects.
     • Sudo: Execute commands as a player.
5. Menu Command System
   
   • Added a new menu command system with Brigadier-style arguments, supporting types such as string, array, word, number, and player for precise command handling.
6. Bedrock Compatibility
   
   • Added support for Bedrock skins for player heads.
   • Enhanced compatibility with skin face rendering in Bedrock forms.
7. Real-Time Updates
   
   • Menus now automatically update every 20 ticks by default, ensuring real-time dynamic interaction.
8. Global Variables
   
   • Introduced support for global variables to enable consistent data across menus.
9. Custom Requirement Messages
   
   • Customize messages for unmet requirements to provide better feedback to users.
10. Enhanced Java & Bedrock Separation
    
    • Added optional distinctions for actions, requirements, titles, names, and lores between Java and Bedrock editions.
11. Small Caps Numbers
    
    • Introduced small caps styling for numeric displays to improve visual design.
12. Tutorial Menus
    
    • Added built-in tutorial menus to guide users on plugin usage and features.
13. New Button Properties
    
    • Added support for:
      • Data attributes for buttons.
      • Hide Enchants and Hide Attributes options to streamline button display.
14. Improved Reload Commands
    
    • Introduced new subcommands for managing menus more effectively:
      • Reload Specific Menus: Reload individual menus on demand.
      • Load and Test Commands: Streamlined for better menu testing workflows.
15. Updated Configuration
    
    • Enhanced the configuration file to include:
      • Messages: Customize user-facing messages.
      • Variables: Define global variables directly in the config.
      • Debug Options: Simplify troubleshooting and fine-tuning.
16. Spigot Compatibility
    
    • Removed the Paper API requirement, allowing the plugin to function seamlessly on both Paper and standard Spigot servers.

Sheets Plugin - Update 1.0.5: Update Checker

Release Date: December 1, 2024

New Features & Enhancements:
- Added Spigot Update Checker