# 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: " "
```


---

# Agent Instructions: 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:

```
GET https://wiki.jetby.space/plugins/treexclans.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.