HexaForms

# HexaForms An advanced menu system for Minecraft servers with PlaceholderAPI integration, Bedrock form support, and DeluxeMenus conversion. ## Features - **Java & Bedrock Support**: Automatic detection of Bedrock players and display of native forms - **Dropdown Menus**: Interactive dropdown menus for Bedrock players with custom options - **Multi-Dropdown Forms**: Advanced 3-dropdown forms for complex selections (ban commands, etc.) - **DeluxeMenus Converter**: Convert DeluxeMenus configurations to HexaForms format automatically - **PlaceholderAPI Integration**: Full support for all PlaceholderAPI placeholders - **Flexible Configuration**: Simple YAML-based menu configuration - **Condition Checking**: Advanced condition checking for menu items - **Action System**: 30+ actions including commands, messages, sounds, dropdowns, and more - **Enchantment Support**: Support for enchantments and glow effects - **Economy & Permissions**: Vault integration for economy and permission management ## Installation 1. Make sure you have the following plugins installed: - **PlaceholderAPI** (required) - **Floodgate** (optional, for Bedrock support) - **Geyser** (optional, for Bedrock support) - **Vault** (optional, for economy/permission actions) 2. Download the HexaForms.jar to your plugins folder 3. Restart the server 4. Configure the menus in the `plugins/HexaForms/menus/` folder ## Quick Start ### Convert DeluxeMenus (New!) If you're migrating from DeluxeMenus: 1. Place your DeluxeMenus `.yml` files in `plugins/HexaForms/dmconvert/` 2. Run `/hexaconvert deluxemenus all` (or `/hexaconvert deluxemenus <filename>`) 3. Converted menus appear in `plugins/HexaForms/menus/` See (CONVERTER_README.md) for detailed conversion guide. ### Create a Menu Create a YAML file in `plugins/HexaForms/menus/`: ```yaml title: "&6&lShop Menu" size: 27 bedrock_form: title: "&6&lShop Menu" content: "&7Purchase items and equipment" buttons: - text: "&a&lWeapons" actions: - " shop weapons" - " ENTITY_PLAYER_LEVELUP 1 1.5" items: weapons_button: slot: 10 material: DIAMOND_SWORD display-name: "&a&lWeapons" lore: - "&7Click to browse weapons" glowing: true actions: - " shop weapons" ``` ## Configuration ### Main Configuration (config.yml) ```yaml messages: player-only: "&cThis command can only be used by players!" menu-not-found: "&cMenu '%menu%' not found!" no-permission: "&cYou don't have permission!" condition-denied: "&cYou don't meet the requirements for this!" reloaded: "&aPlugin reloaded successfully!" default-menu: "main_menu" auto-save: true debug-mode: false placeholders: enabled: true cache-time: 1000 bedrock: enabled: true fallback-to-java: true image-cache: true ``` ## Commands - `/menu ` - Opens a menu (default: main_menu) - `/menureload` - Reloads the configuration - `/hexaconvert <deluxemenus> <all|file_name>` - Converts DeluxeMenus to HexaForms (NEW!) ## Permissions - `hexaforms.menu.use` - Allows access to menus (default: true) - `hexaforms.reload` - Allows reloading the plugin configuration (default: op) - `hexaforms.admin` - Allows access to admin menus (default: op) - `hexaforms.convert` - Allows using the converter command (default: op) (NEW!) ## Actions ### Command Actions - ` <command>` - Executes a command as the player - ` <command>` - Executes a command from the console - ` <command>` - Executes an unregistered command as the player ### Message Actions - ` <text>` - Sends a message to the player - ` <text>` - Sends a message to everyone online - ` <text>` - Sends a message using MiniMessage format - ` <text>` - Broadcasts using MiniMessage format - ` <JSON-text>` - Sends a JSON message to the player - ` <JSON-text>` - Broadcasts a JSON message - ` <message>` - Sends a message in chat as the player ### Menu Control Actions - ` menu <menu-name>` - Opens another menu - `` - Closes the currently opened menu - `` - Refreshes items in the current menu view ### Network Actions - ` <server-name>` - Connects the player to a server on BungeeCord ### Sound Actions - ` <sound> <volume> <pitch>` - Plays a sound for the player - ` <sound> <volume> <pitch>` - Broadcasts a sound to all players - ` <sound> <volume> <pitch>` - Broadcasts a sound to all players in the world ### Economy Actions (Vault required) - ` <amount>` - Gives money to the player - ` <amount>` - Takes money from the player ### Experience Actions - ` <amount>L` - Gives exp levels (add L) or points to a player - ` <amount>L` - Takes exp levels or points from a player ### Permission Actions (Vault required) - ` <perm.node>` - Gives a per