ВЕРСИИ (7)

Added a GUI button that can be used to run commands ```yaml # Runs commands as console when clicked, the menu closes first. # Supports the same prefixes as rank/prestige commands: # console:, message:, title:, discord:, perm_<permission>: and prestige_<name>: "C": icon: PAINTING function: COMMAND display_name: '<aqua>Main menu' lore: - "<gray>Click to go back to the main menu." commands: - "pa open main_menu %player%" ```

### Added - **Prestige-Gated Requirements**: Rank requirements can now specify a minimum required prestige (e.g. `prestige: expert`), hiding and bypassing the requirement for players below that prestige. ```yaml requirements: # This requirement will only be shown if the player has the prestige "expert" or higher, and will be hidden if the player has no prestige or a lower prestige '%prestige_name%': type: TEXT eval: EQUAL value: expert prestige: expert gui_message: '<gray>Prestige <green>%current%<gray>/<yellow>%required% <reset>%status%' deny_message: '<gray>You need to be at least <gray>prestige <red>%required% <gray>to rank up' ``` - **Prestige-Gated Reward Commands**: Reward commands in `ranks.yml` now support prestige prefix conditions (e.g. `prestige_expert: eco give %player% 1333`). ```yaml commands: - 'prestige_expert: p give %player% 1333' ``` - **Automatic Data & Config Migration**: Added automatic migrations across version upgrades. ### Fixed - Fixed player data handling and prestige validation during player join, GUI command processing, and YAML storage serialization.

Added the metrics for answering the following topics. - Is prestige enabled - What's the amount of prestiges setup - What's the type of storage most used

### 👑 Prestige System Now, upon reaching the maximum rank on the server, you can reset your rank progress to increase your **Prestige** level. * **Continuous Journey:** Reset back to the first rank (e.g., *Rookie*) with new goals and accumulated multipliers. * **Simple Commands:** * `/rank prestige` — Initiates the prestige process and displays a confirmation message with details. * `/rank prestige confirm` — Confirms and executes the rank reset and prestige level up. * `/rank prestige <player> [confirm]` — Allows administrators to manage the prestige of other players. ### 📊 Interactive Graphical User Interface (`/rank` or `/rank gui`) The plugin's main GUI has been redesigned to display information about the player's current prestige. * **Prestige Icon:** The menu renders your current prestige icon (supporting standard Minecraft materials or custom textured player heads/skins). * **GUI Interaction:** You can click directly on the prestige icon in the GUI to initiate the prestige action without having to type commands in chat. ### 📈 Dynamic Rank Requirements (Scaling) Rank upgrade requirements can now be dynamically evaluated based on your current prestige level variables! * **Auto-Scaling:** Server admins can set rank requirements to scale up depending on the player's prestige (e.g., `value: '%math_1000*{prestige_var_check_money}%'`). * This establishes a dynamic and balanced economy that automatically adjusts to each player's progress. --- ## 🔧 Information for Server Administrators ### 📝 New Prestige Configuration (`prestiges.yml`) A dedicated configuration file has been introduced to fully customize the prestige tree of your server: * **Icon Customization:** Supports any Minecraft material or custom textured skull Base64 values (e.g., `icon: "head:<base64>"`). * **Automated Rewards:** Configure console commands to execute when a player prestiges. * **Prestige Variables:** Define unique custom variables per prestige level to use in rank requirements or placeholders. ```yaml rookie: prefix: "<dark_gray>[<yellow>ROOKIE<dark_gray>]" display_name: '<yellow>Rookie' icon: GOLD_INGOT icon_amount: 1 icon_model_data: 0 lore: - '<yellow>Rewards' - ' ' - '<gray>- Start your journey to the top!' expert: prefix: "<dark_gray>[<cyan>EXPERT<dark_gray>]" display_name: '<cyan>Expert' icon: DIAMOND icon_amount: 1 icon_model_data: 0 lore: - '<yellow>Rewards' - ' ' - '<gray>- Gain %prestige_var_xp_multiplier%x more XP' variables: check_money: 2 check_xp: 2 xp_multiplier: 1.5 commands: - 'message: <green>Congratulations! You reached prestige %prestige_display_name%!' - 'exp give %player% 1000' ``` ### 📢 Discord Integration (Webhooks) The Discord integration manager has been updated to support multiple dedicated webhooks within `config.yml`: * Send custom rank advancement and prestige milestone announcements directly to distinct Discord channels. * Full support for native and PlaceholderAPI placeholders in Discord messages. ### 🧩 Expanded PlaceholderAPI Support The plugin now registers three dedicated PlaceholderAPI expansion identifiers to query information: 1. **`%prestige_<param>%`**: Dedicated prestige placeholders. 2. **`%rank_<param>%`**: Dedicated rank placeholders. 3. **`%vanguardranks_<param>%`**: Legacy/global placeholders (supports both rank and prestige keys). #### Available Prestige Placeholders * `%prestige_name%` — Internal name of the prestige. * `%prestige_next_name%` — Internal name of the next prestige. * `%prestige_previous_name%` — Internal name of the previous prestige. * `%prestige_display_name%` — Formatted display name of the prestige. * `%prestige_next_display_name%` — Formatted display name of the next prestige. * `%prestige_previous_display_name%` — Formatted display name of the previous prestige. * `%prestige_prefix%` — Styled prefix of the prestige. * `%prestige_next_prefix%` — Styled prefix of the next prestige. * `%prestige_previous_prefix%` — Styled prefix of the previous prestige. * `%prestige_level%` — Numeric level of the prestige. * `%prestige_next_level%` — Numeric level of the next prestige. * `%prestige_previous_level%` — Numeric level of the previous prestige. * `%prestige_var_<variable_name>%` — Value of a custom variable configured for the current prestige level.

- Fixed not setting custom-model-data from ranks.yml, only from config.yml were a applied. - Added a configuration for toggling metrics for bstats. Update the config.yml with metrics section <details> <summary>config.yml</summary> metrics: true </details>

- Fixed an error when checking player's rank and it doesn't have a Rank yet - Fixed a bug where clicking another inventory would trigger events on the VR inventory - Fixed some commands not working when the command had the character ":" in the text - Fixed a bug introduced in the last version where the player head appear with the "gui_close" locale