VanguardRanks

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