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

---

💻 Commands return messages

commands:
  create:
    success: "%prefix% #a0ff72✔ You created the %team% team."

• success: This message is shown when a team is successfully created. (Placeholders: %prefix%, %team%)

delete:
  success: "%prefix% #a0ff72✔ You have deleted team %team%."
  successall: "%prefix% #a0ff72✔ You have deleted all the teams."

• success: Displays when a team is deleted. (Placeholders: %prefix%, %team%)

• successall: Shows when all teapms have been deleted. (Placeholders: %prefix%)

  setdisplay:
    success: "%prefix% #a0ff72✔ Successfully changed the displayname of %team% to '%display_name%'."

• success: This message is shown when the display name of a team successfully changed. (Placeholders: %prefix%, %team%, %display_name%)

join:
  other:
    success: "%prefix% #a0ff72✔ Player %player% joined the %team% team."
    successall: "%prefix% #a0ff72✔ Player %player% joined all teams."
  self:
    success: "%prefix% #a0ff72✔ You joined the %team% team."
    successall: "%prefix% #a0ff72✔ You joined all the teams."

• other/success: Message shown when another player successfully joins a team. (Placeholders: %prefix%, %player%, %team%)

• other/successall: Displays when another player joins all teams. (Placeholders: %prefix%, %player%)

• self/success: Message for when a player joins a team themselves. (Placeholders: %prefix%, %team%)

• self/successall: Shows when the player joins all teams. (Placeholders: %prefix%)

leave:
  other:
    success: "%prefix% #a0ff72✔ Player %player% left the %team% team."
    successall: "%prefix% #a0ff72✔ Player %player% left all teams."
  self:
    success: "%prefix% #a0ff72✔ You left the %team% team."
    successall: "%prefix% #a0ff72✔ You left all the teams."

• other/success: Message shown when another player leaves a team. (Placeholders: %prefix%, %player%, %team%)

• other/successall: Displays when another player leaves all teams. (Placeholders: %prefix%, %player%)

• self/success: Message for when a player leaves a team themselves. (Placeholders: %prefix%, %team%)

• self/successall: Shows when the player leaves all teams. (Placeholders: %prefix%)

list:
  empty: "%prefix% #FF0000🚫 Can't find any team."
  string:
    header: "%prefix% #fff18d📰 List of teams:"
    row: "&7  - &r%display_name% &7(%team%) &8- #ccccccPriority: #fff18d%priority%"

• empty: Message shown when no teams are found. (Placeholders: %prefix%)

• string/header: Header for the list of teams. (Placeholders: %prefix%)

• string/row: Format for each row in the team list, showing the team’s display name, ID, and priority. (Placeholders: %prefix%, %team%, %display_name%, %priority%)

teaminfo:
  string:
    header:
      - " "
      - "%prefix% #ffdcff'%team%' team information:"
      - " "
      - "&8▪ #fff18dDisplay Name: &r%display_name%"
      - "&8▪ #fff18dPriority: &r%priority%"
      - " "
    members_header: "&8▪ #fff18dMembers:"
    no_members: "&8▪ #fff18dMembers: #FF4444None"
    members_row: "&7  - &f%member%"
    footer:
      - " "
      - "#c490c4xTeams developed by @eldrygo"
      - " "

• string/header: Header where you can write anything. (Placeholders: %prefix%, %team%, %display_name%, %priority%)

• string/members_header: Displays "Members" for the team’s member list.

• string/no_members: Message shown when a team has no members.

• string/members_row: Format for listing each member of the team. (Placeholders: %member%)

• string/footer: Footer where you can write anything in multiple lines.

playerinfo:
  string:
    header:
      - " "
      - "%prefix% #ffdcff'%player%' player information:"
      - " "
    main_team: "&8▪ #fff18dMain Team: &r%display_name% &7(%team%)"
    team_list_header: "&8▪ #fff18dHis Teams:"
    team_list_row: "&7  - &r%display_name% &7(%team%) &8- #ccccccPriority: #fff18d%priority%"
    no_teams: "#ff4444Player %player% is not on a team."
    footer:
      - " "
      - "#c490c4xTeams developed by @eldrygo"
      - " "

• string/header: Header where you can write anything. (Placeholders: %prefix%, %player%)

• string/main_team: Displays the main team of the player (The main team is the highest priority team of the player). (Placeholders: %display_name%, %team%)

• string/team_list_header: Displays "His Teams: " for the player team's list.

• string/no_members: Message shown when to player don't belong to any team. (Placeholders: %player%)

• string/team_list_row: Format for listing each team that the player belongs to. (Placeholders: %display_name%, %team%, %priority%)

• string/footer: Footer where you can write anything in multiple lines.

---

❌ Error Messages

error:
  commands:
    unknown_command: "%prefix% #FF0000🚫 Unknown command. &7Use &f/xteams help &7to see the list of commands."
    no_permission: "%prefix% #FF0000🚫 You have no permission to use this command."
    player_not_found: "%prefix% #FF0000🚫 Can't find player %player%."
    team_not_found: "%prefix% #FF0000🚫 Can't find team %team%."
    team_already_exists: "%prefix% #FF0000🚫 Team %team% already exists."
    invalid_priority: "%prefix% #FF0000🚫 Priority must be a valid integer."

• unknown_command: This message is shown when an unknown command is used. (Placeholders: %prefix%)

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

• player_not_found: Message when a specified player is not found. (Placeholders: %prefix%, %player%)

• team_not_found: Message when a specified team is not found. (Placeholders: %prefix%, %team%)

• team_already_exists: Message when a team with the specified name already exists. (Placeholders: %prefix%, %team%)

• invalid_priority: Message for invalid priority input. (Placeholders: %prefix%)

team_not_specified:
  create: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams create <team> <priority>"
  delete: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams delete <team or *>"
      setdisplay: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams setdisplay <team> [New Display Name]"
  leave: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams leave <team or *> <player or leave blank for you>"
  join: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams join <team or *> <player or leave blank for you>"
  teaminfo: "%prefix% #FF0000🚫 Need to specify a team. &7Use &f/xteams info <team>"

• create: Message when no team is specified during the team creation command. (Placeholders: %prefix%)

• delete: Message when no team is specified during the team elimination command. (Placeholders: %prefix%)

• setdisplay: Message when no team is specified during the team display name changing command. (Placeholders: %prefix%)

• leave: Message when no team is specified during the team leaving command. (Placeholders: %prefix%)

• join: Message when no team is specified during the team joining command. (Placeholders: %prefix%)

• teaminfo: Message when no team is specified during the teaminfo command. (Placeholders: %prefix%)

only_player:
  leave: "%prefix% #FF0000🚫 When executed by console, need to specify a player. &7Use &f/xteams leave <team or *> <player>"
  join: "%prefix% #FF0000🚫 When executed by console, need to specify a player. &7Use &f/xteams join <team or *> <player>"

• only_player/leave: Message when the leave command is executed by the console but a player is not specified. (Placeholders: %prefix%)

• only_player/join: Message when the join command is executed by the console but a player is not specified. (Placeholders: %prefix%)

create:
  priority_not_specified: "%prefix% #FF0000🚫 Need to specify the priority. &7Use &f/xteams create <team> <priority>"

• create/priority: Message when the sender don't specify the priority of the team to create. (Placeholders: %prefix%)

leave:
  self:
    not_in_team: "%prefix% #FF0000🚫 You are not in %team% team."
    not_in_anyteam: "%prefix% #FF0000🚫 You are not in any team"
  other:
    not_in_team: "%prefix% #FF0000🚫 You are not in %team% team."
    not_in_anyteam: "%prefix% #FF0000🚫 You are not in any team"

• self/not_in_team: Message when a player is not in the specified team. (Placeholders: %prefix%, %team%)

• self/not_in_anyteam: Message when a player is not in any team. (Placeholders: %prefix%)

• other/not_in_team: Message when a player is not in the specified team. (Placeholders: %prefix%, %team%)

• other/not_in_anyteam: Message when a player is not in any team. (Placeholders: %prefix%)

join:
  self:
    already_in_team: "%prefix% #FF0000🚫 You are already on %team% team."
  other:
    already_in_team: "%prefix% #FF0000🚫 Player %player% is already on %team% team."

• other/already_in_team: Message when another player is already in the specified team. (Placeholders: %prefix%, %player%, %team%)

• self/already_in_team: Message when the player trying to join is already in the specified team. (Placeholders: %prefix%, %team%)

setdisplay:
  displayname_not_specified: "%prefix% #FF0000🚫 Need to add the display name. &7Use &f/xteams setdisplay <team> [New Display Name]"
  invalid_format: "%prefix% #FF0000🚫 The Display Name format is invalid. &7Remember to use double quotes: \"Display Name\"."

• displayname_not_specified: Message when a player uses the command without adding the new display name in it. (Placeholders: %prefix%)

• invalid_format: Message when the Display Name is not valid. (Placeholders: %prefix%)

---

🧩 Placeholders

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

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

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

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

• %display_name%: Returns the display name of the team involved.

• %priority%: Returns the priority of the team involved.

• %member%: Returns the member name. (This one is applicated on /xteams teaminfo command.)