VanguardRanks

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.

  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).

  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.

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