> For the complete documentation index, see [llms.txt](https://imshadows-organization.gitbook.io/ryzenclans-or-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://imshadows-organization.gitbook.io/ryzenclans-or-wiki/configurations/messages.yml.md).

# messages.yml

{% code lineNumbers="true" %}

```yaml
#####################################################################################
# ■━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━■ #
# ┃                                                                               ┃ #
# ┃ ██████╗ ██╗   ██╗███████╗███████╗███╗   ██╗ ██████╗██╗      █████╗ ███╗   ██╗ ┃ #
# ┃ ██╔══██╗╚██╗ ██╔╝╚══███╔╝██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗████╗  ██║ ┃ #
# ┃ ██████╔╝ ╚████╔╝   ███╔╝ █████╗  ██╔██╗ ██║██║     ██║     ███████║██╔██╗ ██║ ┃ #
# ┃ ██╔══██╗  ╚██╔╝   ███╔╝  ██╔══╝  ██║╚██╗██║██║     ██║     ██╔══██║██║╚██╗██║ ┃ #
# ┃ ██║  ██║   ██║   ███████╗███████╗██║ ╚████║╚██████╗███████╗██║  ██║██║ ╚████║ ┃ #
# ┃ ╚═╝  ╚═╝   ╚═╝   ╚══════╝╚══════╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝ ┃ #
# ■━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━■ #
#                                                                                   #
#  Discord: https://discord.gg/RKu7vfwtRW                                           #
#  Author: ImShadow                                                                 #
#                                                                                   #
#####################################################################################

prefix: "&7[&e&lCLANS&7] &8▸ &r"

no-permission: "&cYou don't have permission to use this command."
only-players: "&cThis command can only be used by players."
no-clan: "&cYou don't have a clan."
clan-not-found: "&cThe specified clan does not exist."
player-not-found: "&cThe specified player is not online."

top-clans:
  format:
    - "&7&m------------------------------------------"
    - "&c&lTOP CLAN POINTS"
    - "&7"
    - "%top_entries%"
    - "&7&m------------------------------------------"
  entry-format: "&e#%position% &7- &8[%clan_name%&8] &7(&a%clan_points%&7 points)"

clan-list:
  format:
    - "&7&m------------------------------------------"
    - "&3&lCLAN LIST &7(&f%current_page%/%total_pages%&7)"
    - "&7Total clans: &f%total_clans%"
    - "&7"
    - "%clan_entries%"
    - "&7&m------------------------------------------"
  entry-format: " &8[%clan_name%&8] &7- &7(%clan_size% Members) &7(&a%clan_points%&7 points)"

help:
  format:
    - "&7&m------------------------------------------"
    - "&5&lHELP COMMANDS &7(&f%current_page%/%total_pages%&7)"
    - "%help_commands%"
    - "&7&m------------------------------------------"
    - "&7Page &e%current_page%/%total_pages% %prev_page% &8| %next_page%"
  pages:
    page-1:
      - " &d/clan create <prefix> &7- Create a clan"
      - " &d/clan disband &7- Delete the clan"
      - " &d/clan invite <player> &7- Invite a player"
      - " &d/clan uninvite <player> &7- Remove invitation"
      - " &d/clan join <clan> &7- Join a clan"
      - " &d/clan info [clan/player] &7- View information"
      - " &d/clan leave &7- Leave the clan"
      - " &d/clan setleader <player> &7- Transfer leadership"
      - " &d/clan description <description> &7- Add a description to the clan"
      - " &d/clan prefix <prefix> &7- Modify the clan prefix/name"
    page-2:
      - " &d/clan kick <player> &7- Kick a member"
      - " &d/clan promote <player> &7- Promote a member"
      - " &d/clan demote <player> &7- Demote a member"
      - " &d/clan ally <clan> &7- Form an alliance"
      - " &d/clan unally <clan> &7- Break alliance"
      - " &d/clan enemy <clan> &7- Mark as enemy"
      - " &d/clan neutral <clan> &7- Remove enemy"
      - " &d/clan focus <clan> &7- Focus on clan"
      - " &d/clan upgrade &7- Open the clan upgrade menu"
    page-3:
      - " &d/clan unfocus &7- Unfocus clan"
      - " &d/clan ff &7- Toggle clan PvP"
      - " &d/clan top &7- View top clans"
      - " &d/clan list [page] &7- List all clans"
      - " &d/clan chat [message] &7- Clan chat"
      - " &d/clan chat ally [message] &7- Alliance chat"
      - " &d/clan rally &7- Create rally point"
      - " &d/clan withdraw [amount] &7- Withdraw money from clan"
      - " &d/clan deposit [amount] &7- Add money to clan"
navigation:
  next-page: "&a&l[NEXT]"
  previous-page: "&c&l[PREVIOUS]"
  click-to-next: "&7Click to go to the next page"
  click-to-previous: "&7Click to go to the previous page"

clan:
  ff:
    status:
      enabled: "Enabled"
      disabled: "Disabled"
  description:
    empty: "&7No description."
  notify:
    join: "&a%s &7(&e%s&7) &7has connected."
    quit: "&c%s &7(&e%s&7) &7has disconnected."
  top:
    empty: "&8-"

commands:
  clan:
    create:
      usage: "&7Usage:&b /clan create <prefix>"
      success: "&aYou have successfully created the clan %s&a!"
      error: "&cError creating the clan. Make sure you don't have a clan or that the name isn't already in use."
      blocked-word: "&cThe name contains a blocked word."
      blocked-character: "&cThe name contains blocked characters."
      no-numbers: "&cThe name cannot contain numbers."
      blocked-pattern: "&cThe name does not meet the required format."

    disband:
      success: "&aYou have successfully disbanded your clan."
      error: "&cError disbanding the clan."
      not-leader: "&cOnly the leader can disband the clan."
      notify: "&cYour clan has been disbanded."
      confirm-prompt: "&7Are you sure you want to disband &e%clan_name%&c? "
      confirm-button: "&c&l[CONFIRM]"
      confirm-hover: "&cClick to confirm disbanding your clan"
      no-pending: "&cYou don't have a pending disband request or it has expired."

    invite:
      usage: "&7Usage:&b /clan invite <player>"
      success: "&aYou have invited &6%s &ato the clan!"
      received: "&aYou have been invited to the clan %s&a! Use &6/clan join %s &ato join."
      error: "&cCould not invite the player."
      clickable:
        prefix: "&aYou have been invited to the clan %s&a! "
        button: "&e&l[CLICK TO JOIN]"
        hover: "&aClick to join the clan"

    uninvite:
      usage: "&7Usage:&b /clan uninvite <player>"
      success: "&aYou have revoked the invitation for &6%s&a."
      error: "&cCould not revoke the invitation."

    join:
      usage: "&7Usage:&b /clan join <clan>"
      success: "&aYou have joined the clan %s&a!"
      error: "&cCould not join the clan. Make sure you have an invitation."
      notify: "&6%s &ahas joined the clan."

    prefix:
      usage: "&7Usage:&b /clan prefix <new prefix>"
      success: "&aClan prefix changed to: %s"
      error: "&cCannot change the prefix. A clan with that name may already exist."
      blocked-word: "&cThe prefix contains a blocked word."
      blocked-character: "&cThe prefix contains blocked characters."
      no-numbers: "&cThe prefix cannot contain numbers."
      blocked-pattern: "&cThe prefix does not meet the required format."

    description:
      usage: "&7Usage:&b /clan description <text>"
      success: "&aClan description updated."
      too-long: "&cThe description cannot exceed &e%d &ccharacters."

    members:
      cannot-action-leader: "&cYou cannot perform actions on the clan leader."
      cannot-action-self: "&cYou cannot perform actions on yourself."
      info-shown: "&aMember information displayed."

    setleader:
      usage: "&7Usage:&b /clan setleader <player>"
      success: "&aYou have transferred leadership to &6%s&a."
      promoted: "&aYou are now the clan leader!"
      not-leader: "&cOnly the leader can transfer leadership."
      notify: "&6%s &ais now the clan leader."
      error: "&cError transferring leadership."

    leave:
      success: "&aYou have left the clan."
      leader-error: "&cThe leader cannot leave the clan. Use /clan disband to delete it."
      notify: "&6%s &ahas left the clan."
      error: "&cError leaving the clan."

    kick:
      usage: "&7Usage:&b /clan kick <player>"
      success: "&aYou have kicked &6%s &afrom the clan."
      kicked: "&cYou have been kicked from the clan."
      notify: "&6%s &ahas been kicked from the clan."
      error: "&cCould not kick the player."

    promote:
      usage: "&7Usage:&b /clan promote <player>"
      success: "&aYou have promoted &6%s &ato &e%s&a."
      promoted: "&aYou have been promoted to &e%s&a!"
      error: "&cCould not promote the player."

    demote:
      usage: "&7Usage:&b /clan demote <player>"
      success: "&aYou have demoted &6%s &ato &e%s&a."
      demoted: "&cYou have been demoted to &e%s&c."
      error: "&cCould not demote the player."

    ally:
      usage: "&7Usage:&b /clan ally <clan>"
      success: "&aYou are now allied with %s&a!"
      notify: "&aYour clan is now allied with %s&a!"
      error: "&cError forming the alliance."
      requested: "&aYou have sent an alliance request to %s&a."
      accepted: "&aYou are now allied with %s&a!"
      accepted-them: "&aYour clan is now allied with %s&a!"
      is-enemy: "&cYou cannot ally with %s&c because you have them marked as enemies. Use &e/clan neutral %s &cto remove them first."
      cooldown: "&cYou must wait &e%s &cseconds before sending another alliance request."
      clickable:
        prefix: "&e%s &ahas requested an alliance. "
        button: "&a&l[ACCEPT]"
        hover: "&aClick to accept"

    unally:
      usage: "&7Usage:&b /clan unally <clan>"
      success: "&cYou are no longer allied with &6%s&c."
      error: "&cError breaking the alliance."

    enemy:
      usage: "&7Usage:&b /clan enemy <clan>"
      success: "&cYou have marked &6%s &cas an enemy."
      error: "&cError marking as enemy."
      is-ally: "&cYou cannot mark %s&c as an enemy because they are your allies. Use &e/clan unally %s &cto break the alliance first."

    neutral:
      usage: "&7Usage:&b /clan neutral <clan>"
      success: "&aYou no longer mark &6%s &cas an enemy."
      error: "&cError marking as neutral."

    focus:
      usage: "&7Usage:&b /clan focus <clan>"
      success: "&dYou are now focused on the clan %s&d!"
      same-clan: "&cYou cannot focus on your own clan."
      error: "&cError focusing on the clan."

    unfocus:
      success: "&aYou have stopped focusing on clans."
      error: "&cError unfocusing."

    ff:
      enabled: "&aPvP between clan members enabled."
      disabled: "&cPvP between clan members disabled."
      notify-enabled: "&aClan PvP has been enabled."
      notify-disabled: "&cClan PvP has been disabled."

    join-requests:
      enabled: "&aJoin requests are now enabled."
      disabled: "&cJoin requests are now disabled."
      blocked: "&cThis clan is not accepting join requests."

    ranks:
      cannot-edit-leader: "&cThe Leader rank cannot be modified."
      renamed: "&aRank &e%s &arenamed to &f%s&a."
      perms-updated: "&aPermissions for rank &e%s &aupdated."

    rally:
      success: "&aRally point created! Your teammates can now see it."
      notify: "&6A rally point has been created! Check your waypoint."
      not-available: "&cThe rally function is not available."

    deposit:
      usage: "&7Usage:&b /clan deposit <amount>"
      disabled: "&cThe bank system is disabled."
      vault-not-available: "&cThe economy system is not available."
      invalid-amount: "&cInvalid amount."
      insufficient-funds: "&cYou don't have enough money. You need &e%s&c."
      max-balance-reached: "&cThe bank has reached the maximum limit of &e%s&c."
      success: "&aYou deposited &e%s &ato the bank. Balance: &e%s&a."
      prompt: "&aType the amount to deposit or type '&ecancel&a':"

    withdraw:
      usage: "&7Usage:&b /clan withdraw <amount>"
      disabled: "&cThe bank system is disabled."
      vault-not-available: "&cThe economy system is not available."
      invalid-amount: "&cInvalid amount."
      insufficient-funds: "&cThe bank doesn't have enough money. Balance: &e%s&c."
      success: "&aYou withdrew &e%s &afrom the bank. Balance: &e%s&a."
      prompt: "&cType the amount to withdraw or type '&ecancel&c':"

    setbase:
      success: "&aClan base set at your current position."
      disabled: "&cThe base system is disabled."
      no-permission: "&cYou don't have permission to set the base."

    delbase:
      success: "&cClan base deleted."
      disabled: "&cThe base system is disabled."
      no-base: "&cThe clan does not have a base set."
      no-permission: "&cYou don't have permission to delete the base."

    home:
      disabled: "&cThe base system is disabled."
      no-base: "&cThe clan does not have a base set."
      teleport-countdown: "&eTeleporting in &f%seconds% &eseconds... Don't move."
      teleport-success: "&aTeleported to the clan base!"
      teleport-cancelled-moved: "&cTeleport cancelled. You moved."
      teleport-cancelled-damage: "&cTeleport cancelled. You took damage."

    top:
      empty: "&cNo clans registered yet."

  points:
    death-penalty: "&c-%d points &7for death of &6%s&7. Total: &e%d points&7."
    kill-reward: "&a+%d points &7for kill of &6%s&7 to &c%s&7. Total: &e%d points&7."
    admin-added: "&a+%d points &7added by an admin. Total: &e%d points&7."
    admin-set: "&ePoints set to &6%d &7by an admin."

  # Admin commands
  rclan:
    addpoints:
      usage: "&7Usage:&b /rclan addpoints <clan> <points>"
      success: "&aAdded &6%d points &ato clan %s&a. Total: &e%d points&a."

    removepoints:
      usage: "&7Usage:&b /rclan removepoints <clan> <points>"
      success: "&aRemoved &6%d points &afrom clan %s&a. Total: &e%d points&a."

    setpoints:
      usage: "&7Usage:&b /rclan setpoints <clan> <points>"
      success: "&aClan %s &apoints set to &e%d&a."

    delete:
      usage: "&7Usage:&b /rclan delete <clan>"
      success: "&aClan %s &ahas been deleted."
      error: "&cError deleting the clan."
      notify: "&cYour clan has been deleted by an admin."

    forcejoin:
      usage: "&7Usage:&b /rclan forcejoin <player> <clan>"
      success: "&a%s has been added to clan %s."
      joined: "&aYou have been added to clan %s by an admin."
      has-clan: "&c%s already belongs to clan %s."
      error: "&cError adding the player to the clan."

    forceleave:
      usage: "&7Usage:&b /rclan forceleave <player>"
      success: "&a%s has been removed from clan %s."
      removed: "&cYou have been removed from clan %s by an admin."
      no-clan: "&c%s does not belong to any clan."
      is-leader: "&cCannot force the clan leader to leave."
      error: "&cError removing the player from the clan."

    setally:
      usage: "&7Usage:&b /rclan setally <clan1> <clan2>"
      success: "&aAlliance created between %s and %s successfully."
      notify: "&aYour clan is now allied with %s &aby an admin."
      same-clan: "&cYou cannot create an alliance between the same clan."
      already-allies: "&c%s and %s are already allies."
      error: "&cError creating the alliance."

    forceunally:
      usage: "&7Usage:&b /rclan forceunally <clan1> <clan2>"
      success: "&aThe alliance between %s and %s has been broken."
      notify: "&cYour alliance with %s has been broken by an admin."
      error: "&cError breaking the alliance."

    forceff:
      usage: "&7Usage:&b /rclan forceff <clan>"
      success: "&aPvP for clan %s %s by an admin."
      notify-enabled: "&aClan PvP has been enabled by an admin."
      notify-disabled: "&cClan PvP has been disabled by an admin."

    forcesetleader:
      usage: "&7Usage:&b /rclan setleader <clan> <player>"
      success: "&a%s is now the leader of clan %s."
      notify-old: "&cYou have been demoted to Admin. &6%s &cis now the clan leader."
      notify-new: "&aYou are now the clan leader by an admin!"
      notify-clan: "&6%s &ais now the clan leader."
      not-member: "&c%s is not a member of clan %s."
      error: "&cError changing the clan leader."

    chatspy:
      enabled: "&aChat spy enabled."
      disabled: "&cChat spy disabled."

    reload:
      success: "&aPlugin reloaded successfully."
      error: "&cError reloading the plugin."

    delbase:
      usage: "&7Usage:&b /rclan delbase <clan>"
      success: "&aBase of clan %s deleted."
      no-base: "&cClan %s does not have a base set."
      notify: "&cThe clan base has been deleted by an admin."

    adminwithdraw:
      usage: "&7Usage:&b /rclan withdraw <clan>"
      success: "&aEmptied the bank of clan %s&a. Amount: &e%s&a."
      empty: "&cThe clan bank has no money."
      notify: "&cThe clan bank has been emptied by an admin. Amount withdrawn: &e%s&c."

    setlevel:
      usage: "&7Usage:&b /rclan setlevel <clan> <level>"
      success: "&aClan %s &alevel set to &e%d&a."
      negative: "&cLevel cannot be negative."
      max-exceeded: "&cThe maximum configured level is &e%d&c."
      notify: "&eYour clan level has been set to &6%d &eby an admin."

    addlevel:
      usage: "&7Usage:&b /rclan addlevel <clan> [amount]"
      success: "&aAdded &e%d &alevel(s) to clan %s&a. Current level: &e%d&a."
      already-max: "&cClan %s &cis already at the maximum level (&e%d&c)."
      invalid-amount: "&cThe amount must be greater than 0."
      notify: "&eYour clan has been upgraded to level &6%d &eby an admin."

    removelevel:
      usage: "&7Usage:&b /rclan removelevel <clan> [amount]"
      success: "&aRemoved &e%d &alevel(s) from clan %s&a. Current level: &e%d&a."
      already-zero: "&cClan %s &cis already at level 0."
      invalid-amount: "&cThe amount must be greater than 0."
      notify: "&cYour clan level has been reduced to &6%d &cby an admin."

    invalid-number: "&cThe entered value is not a valid number."

gui:
  noclan:
    create-prompt: "&aType your clan prefix in chat or type '&ecancel&a':"
    join-request-prompt: "&aType the clan name to request joining or type '&ecancel&a':"
    join-request-sent: "&aJoin request sent to clan %s&a."
    join-request-cooldown: "&cYou must wait &e%s &cseconds before sending another join request."
    join-request-received: "&e%s &ahas requested to join your clan. &e[CLICK TO INVITE]"
    join-request-prefix: "&e%s &ahas requested to join your clan. "
    join-request-button: "&e[CLICK TO INVITE]"
    join-request-hover: "&aClick to invite %s"
    no-invites: "&7You have no pending clan invitations."

  rank-config:
    rename-prompt: "&aType a new name for this rank or type '&ecancel&a':"
    perms-prompt: "&aType permissions separated by commas (e.g. invite,kick,ally) or type '&ecancel&a':"

  settings:
    ally:
      chat-prompt: "&aType the clan name to request alliance or type '&ecancel&a':"
    enemy:
      chat-prompt: "&cType the clan name to mark as enemy or type '&ecancel&c':"
    no-next-page: "&cThere are no more pages."
    input-cancelled: "&cThe action has been cancelled successfully."

  upgrade:
    success: "&aYour clan has been upgraded to level &e%d&a!"
    already-max: "&cYour clan is already at the maximum level."
    conditions-not-met: "&cYou do not meet all the requirements to level up."
    insufficient-points: "&cYour clan does not have enough points."
    insufficient-bank: "&cYour clan bank does not have enough balance."
    disabled: "&cThe upgrade system is currently disabled."
    no-clan: "&cYou do not have a clan."
    no-next-page: "&cThere are no more levels to show."

  conditions-lore:
    met: "&a✔ %description%"
    not-met: "&c✘ %description%"
    none: "&7None"

  cost-lore:
    points: "%color%%amount% points"
    bank: "%color%$%amount% from bank"
    free: "&7Free"

  rewards-lore:
    member-slots: "&7+&f%amount% &7member slot(s)"
    ally-slots: "&7+&f%amount% &7ally slot(s)"
    kill-bonus: "&7+&f%percent%% &7kill point bonus"
    none: "&7None"


chat:
  clan:
    format: "&7[&d&lCLAN-CHAT&7] &f%player%&7: &a%message%"
    toggle-on: "&aClan chat enabled.&f Your messages will be sent to the clan."
    toggle-off: "&cClan chat disabled.&f Your messages will be sent to global chat."

  ally:
    format: "&7[&b&lALLIANCE-CHAT&7] &f%player%&7: &b%message%"
    toggle-on: "&aAlliance chat enabled.&f Your messages will be sent to alliances."
    toggle-off: "&cAlliance chat disabled.&f Your messages will be sent to global chat."
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://imshadows-organization.gitbook.io/ryzenclans-or-wiki/configurations/messages.yml.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.