> For the complete documentation index, see [llms.txt](https://wiki.jetby.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.jetby.space/plugins/treexclans.md).

# TreexClans

**Clan System Plugin** – Advanced clans plugin for Minecraft servers with clan wars, rankings, clan homes, shared storage, PvP battles, invites, leaderboards, economy support, and customizable settings. Perfect for SMP, PvP, Factions, and survival servers. Lightweight, optimized, easy to set up, and fully configurable for modern Minecraft networks.

## Why TreexClans?

* Flexible API
* Separate folder for add-ons
* Customizable — fully configurable with custom functionality support.
* GUIs — create unlimited custom interfaces.
* Technology — uses modern solutions such as MiniMessage and Libby.
* Support — active bug fixing and community-driven improvements.
* Economy — includes a clan bank system for deposits and upgrades.
* Clan Coins — earn and spend coins on perks and rewards.
* Levels — level up clans to unlock more members, storage, and bank capacity.

###  What addons do you have?

* [Leaderboard](https://modrinth.com/plugin/clanleaderboard)
* [Quests](https://modrinth.com/plugin/clanquest)
* [Glow](https://modrinth.com/plugin/clanglow)
* [Events](https://modrinth.com/plugin/clanevents)
* War(soon, paid)
* Aliances(soon, free)
* Discord Integration (soon, free)

### You have to know about GUIs:

* We use guis system by [Libb](https://modrinth.com/plugin/libb), it's our own library/factory for guis.\
  It means, our yaml syntax is exactly the same as Libb

So, because of our flexible gui factory, you can simply make any type of gui you want, as much as you want.\
Let me give you an example what you can build with our gui system, to show you how customizable is TreexClans:\
\
**As an example I will make Shop.** \
Make sure your guis inside the `Menu/custom` folder, you can make any folder you want inside the folder. Just please put it inside custom.\
\
Now we make the yaml file:

```yaml
id: shop # unique identification name
title: "&0&lClan Shop"
size: 54

# Args helps you make the command part of TreexClans
open_args:
  - 'shop' # it means /clan shop - easy right?

# A model is something that completely changes the behavior of the gui.
# CLAN_ONLY means that only players who's in clan can open the gui.
model: clan_only

# You can make any item, as much as you want
Items:

  diamond: # unique name (never uses, it could be anything)
    slot: 9
    material: DIAMOND
    lore:
      - ""
      - "&6• Cost &610 coins"
      - "&6• Your balance &6%clan_coin% coins"
      - ""
      - "&7▶ Click to buy"

    # This can be the part that you, never seen before, it's simple actions section, with custom features called checks
    on_click:
      any:
        # make sure that the spaces for checks is important
        - check1: # unique name
            if: "%clan_coin% >= 10" # expression
            # actions, also support other checks
            then:
              - "[console] minecraft:give %player_name% diamond 1"
              - "[coin_take] 10"
              - "[open] shop"
            else:
              - "[message] &cYou do not have enough coins."
 ### Decoration
  orange:
    material: ORANGE_STAINED_GLASS_PANE
    slots:
      - 0-2
      - 6-8
      - 45-47
      - 51-53
    display_name: " "
  black:
    material: BLACK_STAINED_GLASS_PANE
    slots:
      - 3
      - 5
      - 48
      - 50
    display_name: " "
  gray:
    material: GRAY_STAINED_GLASS_PANE
    slots:
      - 4
      - 49
    display_name: " "
```