Sheets - Unified Menus & Forms for Java v1.1.8

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:

YAML:

actions:
  - input:
      title: "Enter your name"
      command: "say hello {text}"

• 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:

YAML:

actions:
  - left: "sheets open example_menu"
  - right:
      message: "You right-clicked this button!"
  - shift:
      - argument:
          sheet_name: "%player_name%"
      - menu: "confirm_delete"
  - middle:
      input: "Rename Item;rename {text}"

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:

YAML:

actions:
  - argument:
      target_player: "%player_name%"
      custom_value: "123"
  - menu: "another_menu" # another_menu can now use {target_player} and {custom_value}

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

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!