> 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/upgrades.yml.md).

# upgrades.yml

{% code lineNumbers="true" %}

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

enabled: true
menu:
  title: "&7Clan Upgrades &8- &aLevel %clan_level%"
  size: 54

  fill:
    material: STAINED_GLASS_PANE
    data: 7
    name: "&r"
    slots: [0,1,2,3,4,5,6,7,8,46,47,48,50,51,52]

  close-item:
    material: BARRIER
    data: 0
    name: "&cClose"
    lore:
      - "&7Close this menu"
    slot: 49

  next-item:
    material: ARROW
    data: 0
    name: "&aNext Page"
    lore:
      - "&7Click to go to the next page"
    slot: 53

  prev-item:
    material: ARROW
    data: 0
    name: "&cPrevious Page"
    lore:
      - "&7Click to go to the previous page"
    slot: 45

level-items:
  completed:
    material: INK_SACK
    data: 10
    name: "&aLevel %level% &7- &aObtained"
    lore:
      - ""
      - "&7Rewards obtained:"
      - "%rewards_lore%"
      - ""
      - "&a✔ You already have this level"

  available:
    material: INK_SACK
    data: 14
    name: "&eLevel %level% &7- &eAvailable"
    lore:
      - ""
      - "&7Requirements:"
      - "%conditions_lore%"
      - ""
      - "&7Cost:"
      - "%cost_lore%"
      - ""
      - "&7Rewards:"
      - "%rewards_lore%"
      - ""
      - "&e▸ Click to level up"

  locked:
    material: INK_SACK
    data: 1
    name: "&cLevel %level% &7- &cLocked"
    lore:
      - ""
      - "&7Requirements:"
      - "%conditions_lore%"
      - ""
      - "&7Cost:"
      - "%cost_lore%"
      - ""
      - "&7Rewards:"
      - "%rewards_lore%"
      - ""
      - "&c✘ You don't meet the requirements"

#####################################################################################
#                                                                                   #
#  ■─────────────────────────────────────────────────────────────────────────────■  #
#  │                                                                             │  #
#  │ Available slots for level items: 10-16, 19-25, 28-34, 37-43                 │  #
#  │ They are assigned automatically in order of definition.                     │  #
#  │                                                                             │  #
#  │ Available conditions:                                                       │  #
#  │   min-members — minimum clan members                                        │  #
#  │   min-points — minimum clan points                                          │  #
#  │   min-bank-balance — minimum balance in the clan bank                       │  #
#  │                                                                             │  #
#  │ Available costs:                                                            │  #
#  │   points — clan points are deducted when leveling up                        │  #
#  │   bank-balance — money is withdrawn from the bank when leveling up          │  #
#  │                                                                             │  #
#  │ Available rewards:                                                          │  #
#  │   member-slots — extra member slots (cumulative)                            │  #
#  │   ally-slots — extra ally slots (cumulative)                                │  #
#  │   kill-bonus — extra % points per kill (cumulative, 0.10 = +10%)            │  #
#  │   commands — list of commands that are executed when leveling up            │  #
#  │                                                                             │  #
#  │ Variables:                                                                  │  #
#  │   %clan%, 2%leader%, %level%                                                │  #
#  │                                                                             │  #
#  ■─────────────────────────────────────────────────────────────────────────────■  #
#                                                                                   #
#####################################################################################

levels:
  1:
    conditions:
      min-members: 3
      min-points: 200
      min-bank-balance: 0.0
    cost:
      points: 100
      bank-balance: 0.0
    rewards:
      member-slots: 1
      ally-slots: 0
      kill-bonus: 0.0
      commands: []

  2:
    conditions:
      min-members: 5
      min-points: 500
      min-bank-balance: 500.0
    cost:
      points: 300
      bank-balance: 250.0
    rewards:
      member-slots: 1
      ally-slots: 0
      kill-bonus: 0.0
      commands: []

  3:
    conditions:
      min-members: 8
      min-points: 1500
      min-bank-balance: 2000.0
    cost:
      points: 700
      bank-balance: 1000.0
    rewards:
      member-slots: 2
      ally-slots: 1
      kill-bonus: 0.05
      commands: []

  4:
    conditions:
      min-members: 10
      min-points: 3000
      min-bank-balance: 5000.0
    cost:
      points: 1500
      bank-balance: 3000.0
    rewards:
      member-slots: 2
      ally-slots: 1
      kill-bonus: 0.05
      commands: []

  5:
    conditions:
      min-members: 15
      min-points: 7500
      min-bank-balance: 10000.0
    cost:
      points: 3000
      bank-balance: 7500.0
    rewards:
      member-slots: 3
      ally-slots: 1
      kill-bonus: 0.10
      commands:
        - "broadcast &6[RyzenClans] &eThe clan %clan% has reached level &6%level%&e!"
```

{% 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/upgrades.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.