CountryFlags

# === 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
# - <country>  : ISO country code or country name
# - <flag>     : Country flag emoji
# - <prefix>   : Full flag prefix string (emoji + space)
#
# 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 & Help ===
  help-root: "<gradient:#60a5fa:#3b82f6><bold> CountryFlags — Commands</bold></gradient>\n<gray><commands></gray>"
  help-line-toggle: "<#93c5fd>/countryflags toggle <broadcast|pack></#93c5fd> <#9ca3af>– Toggle your flag or resource pack</#9ca3af>"
  help-line-override: "<#93c5fd>/countryflags override <player> <country-code|clear></#93c5fd> <#9ca3af>– Set/clear a player's country</#9ca3af>"
  help-line-reload: "<#93c5fd>/countryflags reload</#93c5fd> <#9ca3af>– Reload config & messages</#9ca3af>"
  help-line-debug: "<#93c5fd>/countryflags debug <on|off></#93c5fd> <#9ca3af>– Toggle debug logging</#9ca3af>"

  usage-flagtoggle: "<gradient:#f87171:#ef4444>❓ Usage:</gradient> <#93c5fd>/countryflags toggle <broadcast|pack></#93c5fd> <#9ca3af>— Toggle your country flag broadcast or the custom resource pack on/off.</#9ca3af>"
  usage-flagoverride: "<gradient:#f87171:#ef4444>❓ Usage:</gradient> <#93c5fd>/countryflags override <player> <country-code|clear></#93c5fd> <#9ca3af>— Manually override a player's flag.</#9ca3af>"
  usage-reload: "<gradient:#f87171:#ef4444>❓ Usage:</gradient> <#93c5fd>/countryflags reload</#93c5fd> <#9ca3af>— Reload configuration and messages.</#9ca3af>"
  usage-debug: "<gradient:#f87171:#ef4444>❓ Usage:</gradient> <#93c5fd>/countryflags debug <on|off></#93c5fd> <#9ca3af>— Enable or disable debug logging.</#9ca3af>"

  no-player: "<gradient:#f87171:#ef4444>⛔ This command can only be run by a player.</gradient>"
  player-not-found: "<gradient:#f87171:#ef4444>❌ Player <white><player></white> not found or offline.</gradient>"
  no-permission: "<gradient:#f87171:#ef4444>⛔ You do not have permission to use this command.</gradient>"

  # === ✅ Success & Feedback ===
  broadcast-toggle-on: "<gradient:#34d399:#10b981>✅ Your flag will now be shown to others.</gradient>"
  broadcast-toggle-off: "<gradient:#fbbf24:#f59e0b>⚠ Your flag will be hidden from others.</gradient>"
  pack-toggle-on: "<gradient:#34d399:#10b981>✅ Resource pack enabled. It will be applied automatically where supported.</gradient>"
  pack-toggle-off: "<gradient:#fbbf24:#f59e0b>⚠ Resource pack disabled. You'll see Unicode/text fallback.</gradient>"
  pack-globally-disabled: "<gradient:#fbbf24:#f59e0b>⚠ Resource packs have been disabled by the server. You'll see Unicode/text fallback.</gradient>"

  # === Admin Notifications ===
  admin-override-set: "<gradient:#a78bfa:#6366f1>⚙ You set a flag override for <white><player></white>: <flag> <bold><country></bold></gradient>"
  admin-override-cleared: "<gradient:#a78bfa:#6366f1>⚙ You cleared the flag override for <white><player></white>.</gradient>"
  reload-complete: "<gradient:#34d399:#10b981>✅ CountryFlags configuration and messages reloaded successfully.</gradient>"

  # === ❌ Errors & Validation ===
  error-invalid-country: "<gradient:#f87171:#ef4444>❌ Invalid country code. Use a valid 2‑letter ISO code (e.g., US, GB).</gradient>"
  error-geoip-fail: "<gradient:#fbbf24:#f59e0b>⚠ Could not determine your country; using default flag <flag>.</gradient>"
  resource-pack-declined: "<gradient:#f87171:#ef4444>⚠ You declined the CountryFlags resource pack! You'll only see raw country codes like 'U S' instead of actual flag emojis.</gradient>"
  resource-pack-failed: "<gradient:#f87171:#ef4444>⚠ Resource pack failed to download. Please try again later.</gradient>"

  # === ️ Info & Debug ===
  debug-enabled: "<gradient:#60a5fa:#3b82f6> Debug mode enabled. Detailed logs will be shown.</gradient>"
  debug-disabled: "<gradient:#fbbf24:#f59e0b> Debug mode disabled.</gradient>"