📝messages.yml

📄 Introduction

The messages.yml file allows you to customize all messages that the xTeams plugin sends to players, helping create a tailored experience for your server. This file includes messages for team creation, deletion, joining, leaving, and other related actions. You can also customize error messages and command outputs to improve the clarity and overall user experience.

💡 Breakdown of the messages.yml file

prefix: "#ffbaff&lx&r&lTeams &8»&r"

• prefix: Defines the primary prefix for all messages. Supports regular color codes (&) and hex color codes of the format #RRGGBB and &x&R&R&G&G&B&B.

---

⚙️ Plugin Commands Messages

commands:
  plugin:
    unknown_command: "%prefix% #FF0000🚫 Unknown command. &7Use &f/xwhitelist help &7to see the list of commands."
    reload_success: "%prefix% #a0ff72✔ Plugin reloaded."

• plugin/unknown_command: This message is shown when a player uses a command that no exists. (Placeholders: %prefix%)

• plugin/reload_success: This message is shown when a player uses the reload command. (Placeholders: %prefix%)

📝 Whitelist Command Messages

commands:
  whitelist:
    enable:
      success: "%prefix% #a0ff72✔ The whitelist has been enabled."
      already: "%prefix% #fff18d📰 The whitelist is already enabled."

• success: This message is shown when a player enables the whitelist. (Placeholders: %prefix%)

• already: This message is shown when a player tries to enable the whitelist when it is already enabled. (Placeholders: %prefix%)

whitelist:
  disable:
    success: "%prefix% #ff7272❌ The whitelist has been disabled."
    already: "%prefix% #fff18d📰 The whitelist is already disabled."

• success: This message is shown when a player disables the whitelist. (Placeholders: %prefix%)

• already: This message is shown when a player tries to disable the whitelist when it is already disabled. (Placeholders: %prefix%)

whitelist:
  add:
    success: "%prefix% #a0ff72✔ Added player %player% to the whitelist."
    already: "%prefix% #FF0000🚫 The player %player% is already in the whitelist."
    usage: "%prefix% #FF0000🚫 Incorrect usage. &7Use &f/xwhitelist add <player> &7to add a player to the whitelist."

• success: This message is shown when a player add another player to the whitelist. (Placeholders: %prefix%, %player%)

• already: This message is shown when a player tries to add a player to the whitelist and he is already on it. (Placeholders: %prefix%, %player%)

• usage: This message is shown when a player uses the add command but not in the right way. (Placeholders: %prefix%)

whitelist:
  remove:
    success: "%prefix% #ff7272❌ Removed player %player% from the whitelist."
    already: "%prefix% #FF0000🚫 Can't find player %player% in the whitelist."
    usage: "%prefix% #FF0000🚫 Incorrect usage. &7Use &f/xwhitelist remove <player> &7to remove a player from the whitelist."

• success: This message is shown when a player removes another player from the whitelist. (Placeholders: %prefix%, %player%)

• already: This message is shown when a player tries to remove a player to the whitelist and he is not on the whitelist. (Placeholders: %prefix%, %player%)

• usage: This message is shown when a player uses the remove command but not in the right way. (Placeholders: %prefix%)

whitelist:
  list:
    header: "%prefix% #fff18d📰 List of player in the whitelist:"
    row: "&8- #ffffff%player%"
    empty: "%prefix% #FF0000🚫 The whitelist is empty."

• header: This message is shown has header for the list of players in the whitelist. (Placeholders: %prefix%)

• row: This is show for every player on the whitelist when use the list command. (Placeholders: %player%)

• empty: This message is shown when a player uses the list command but the whitelist has no players. (Placeholders: %prefix%)

whitelist:
  cleanup:
    success: "%prefix% #a0ff72✔ The whitelist has been cleared."

• success: This message is shown when a player uses the cleanup command. (Placeholders: %prefix%)

🚧 Maintenance Whitelist Command Messages

commands:
  maintenance:
    enable:
      success: "%prefix% #a0ff72✔ The maintenance whitelist has been enabled."
      already: "%prefix% #fff18d📰 The maintenance whitelist is already enabled."

• success: This message is shown when a player enables the maintenance whitelist. (Placeholders: %prefix%)

• already: This message is shown when a player tries to enable the maintenance whitelist when it is already enabled. (Placeholders: %prefix%)

maintenance:
  disable:
    success: "%prefix% #ff7272❌ The maintenance whitelist has been disabled."
    already: "%prefix% #fff18d📰 The maintenance whitelist is already disabled."

• success: This message is shown when a player disables the maintenance whitelist. (Placeholders: %prefix%)

• already: This message is shown when a player tries to disable the maintenance whitelist when it is already disabled. (Placeholders: %prefix%)

maintenance:
  add:
    success: "%prefix% #a0ff72✔ Added player %player% to the MWhitelist."
    already: "%prefix% #FF0000🚫 The player %player% is already in MWhitelist."
    usage: "%prefix% #FF0000🚫 Incorrect usage. &7Use &f/xwhitelist maintenance add <player> &7to add a player to the MWhitelist."

• success: This message is shown when a player add another player to the maintenance whitelist. (Placeholders: %prefix%, %player%)

• already: This message is shown when a player tries to add a player to the maintenance whitelist and he is already on it. (Placeholders: %prefix%, %player%)

• usage: This message is shown when a player uses the maintenance add command but not in the right way. (Placeholders: %prefix%)

maintenance:
  remove:
    success: "%prefix% #ff7272❌ Removed player %player% from the MWhitelist."
    already: "%prefix% #FF0000🚫 Can't find player %player% in the MWhitelist."
    usage: "%prefix% #FF0000🚫 Incorrect usage. &7Use &f/xwhitelist maintenance remove <player> &7to remove a player from the MWhitelist."

• success: This message is shown when a player removes another player from the maintenance whitelist. (Placeholders: %prefix%, %player%)

• already: This message is shown when a player tries to remove a player from the maintenance whitelist and he is not on the whitelist. (Placeholders: %prefix%, %player%)

• usage: This message is shown when a player uses the maintenance remove command but not in the right way. (Placeholders: %prefix%)

maintenance:
  list:
    header: "%prefix% #fff18d📰 List of player in the MWhitelist:"
    row: "&8- #ffffff%player%"
    empty: "%prefix% #FF0000🚫 The MWhitelist is empty."

• header: This message is shown has header for the list of players in the maintenance whitelist. (Placeholders: %prefix%)

• row: This is show for every player on the maintenance whitelist when use the list command. (Placeholders: %player%)

• empty: This message is shown when a player uses the maintenance list command but the maintenance whitelist has no players. (Placeholders: %prefix%)

maintenance:
  cleanup:
    success: "%prefix% #a0ff72✔ The whitelist has been cleared."

• success: This message is shown when a player uses the maintenance cleanup command. (Placeholders: %prefix%)

---

❌ Error Messages

error:
  no_permission: "%prefix% #FF0000🚫 You have no permission to use this command."
  database_exception: "%prefix% #FF0000🚫 Database connection error."

• no_permission: Message for when a player does not have permission to use a command. (Placeholders: %prefix%)

• database_exception: Message when a command have a database error. (Placeholders: %prefix%)

---

🧩 Placeholders

You can also use placeholders from other expansions of PlaceholderAPI including the xWhitelist placeholders.

• %prefix%: Returns the plugin prefix, defined on the prefix line of the message config.

• %player%: Returns the code name of the player involved.