# === MiniMessage Formatting ===
# Most plugin messages (including GUI labels and action bars) support MiniMessage.
# MiniMessage uses tags like <red>, <bold>, <hover:...> to style your text.
#
# ✅ Basic Examples:
# - <red>Red Text</red>
# - <bold><yellow>Bold Yellow</yellow></bold>
# - <#ff0000>Hex Color Example</#ff0000>
# - <gradient:#fbbf24:#9b5de5>Gradient Text</gradient>
#
# ️ Interactive Tags:
# - <hover:show_text:'Extra info'><green>Hover Me</green></hover>
# - <click:run_command:'/help'><aqua>Click Me</aqua></click>
#
# ⚠️ CLOSING TAGS REQUIRED:
#   Every tag must be properly closed, or your message will break.
#   ❌ Incorrect: <bold><yellow>Missing closing tag
#   ✅ Correct:   <bold><yellow>Styled</yellow></bold>
#
# Built-in Placeholders (used in some messages):
# - <player>         → Player’s username
# - <ghast>          → Ghast entity ID or reference
# - <mode>           → Logging mode (e.g., DEBUG, VERBOSE)
# - <value>          → Config value (used in warnings)
#
# These placeholders are replaced automatically by the plugin when messages are sent.
# Not all messages use placeholders — only those that require dynamic data.
# Only use placeholders in messages that support them, or they will appear as raw text.
#
# Tips:
# - To disable a message entirely, set its value to an empty string: ""
#   Example: reload-complete: ""
# - For advanced formatting, check the official MiniMessage docs:
#   https://docs.advntr.dev/minimessage/format.html

messages :
  # === Command Usage ===
  usage-main : "<red>❓ Usage: /hgb <reload|debug|help|set></red>"
  usage-debug : "<red>❓ Usage: /hgb debug <off|basic|debug|verbose></red>"
  usage-set : "<red>❓ Usage: /hgb set <default|preset> <boost-speed|refill-rate|drain-rate|particle> <value></red>"
  invalid-usage : "<red>❓ Usage: /happyghastboost <logdisable|logbasic|logdebug|logverbose|reload></red>"

  # === Player Help ===
  help-header : "<gradient:#facc15:#f97316><bold> How to Boost</bold></gradient>"
  help-boost-controls : "<gray>Hold <yellow><bold>W</bold></yellow> for <gradient:#22c55e:#86efac><forward-hold-ms></gradient> to <green><bold>activate boost</bold></green>"
  help-boost-stop : "<gray>Turn sharply or run out of charge to <red><bold>stop boosting</bold></red>"
  help-boost-stats : "<gray>Boost lasts <gradient:#f87171:#ef4444><drain></gradient>, refills in <gradient:#4ade80:#22c55e><refill></gradient>, speed: <aqua><speed></aqua>"

  # === ️ Admin Help ===
  help-title : "<gradient:#4ade80:#22c55e><bold> HappyGhastBoost Admin Help</bold></gradient>"
  help-reload : "<gradient:#60a5fa:#3b82f6>/hgb reload</gradient> <gray>– Reloads the config</gray>"
  help-debug : "<gradient:#60a5fa:#3b82f6>/hgb debug</gradient> <white><off | basic | debug | verbose></white>"
  help-set-default : "<gradient:#60a5fa:#3b82f6>/hgb set</gradient> <white>default <param> <value></white>"
  help-set-preset : "<gradient:#60a5fa:#3b82f6>/hgb set</gradient> <white><preset> <param> <value></white>"
  help-params : "<white>Valid params:</white> <aqua>boost-speed</aqua>, <aqua>refill-rate</aqua>, <aqua>drain-rate</aqua>, <aqua>particle</aqua>"

  # === ✅ Success & Feedback ===
  reload-complete : "<green>✅ HappyGhastBoost configuration reloaded.</green>"
  logging-mode-set : "<gold> Logging mode set to: <mode></gold>"
  set-success : "<green>✅ Set <white><param></white> <green>for <white><target></white> <green>to <white><value></white></green>"

  # === ❌ Errors & Validation ===
  invalid-number : "<red>❌ Invalid number: <value></red>"
  unknown-particle : "<red>❌ Unknown particle type: <white><value></white></red>"
  blocked-particle : "<red>❌ That particle type requires extra data and cannot be used.</red>"
  invalid-particle : "<red>⚠️ Invalid particle type in config: <white><value></white>. Defaulting to <white>FLAME</white></red>"

  # === ⛔ Permissions ===
  no-permission : "<red>⛔ You don't have permission.</red>"

  # === Debug Logging ===
  pilot-assigned : "<gray> Assigned <white><player></white> <gray>as pilot of ghast <white><ghast></white></gray>"
  pilot-unregistered : "<gray> Unregistered pilot <white><player></white></gray>"
  pilot-handoff : "<gray> Pilot auto-switched to <white><player></white> <gray>after dismount.</gray>"
  attempted-boost-empty : "<gray><player></gray> <red><bold>attempted to boost with 0% charge</bold></red>"

  # === Action Bar States ===
  boost-ready : "<green><bold> Boost Ready!</bold></green>"
  charging : "<yellow>⚡ Charging Boost</yellow>"
  boosting : "<red><bold> Boosting</bold></red>"