# Guild

Guild System Overview for BIRDS App

The **Guild System** in BIRDS app allows users to create, manage, and grow their own guilds while inviting friends to join and compete with other guilds for rewards. Below is an outline of how the guild system works and the different tiers available.

<figure><img src="/files/Fg8joa7EDW48dCLcXiaX" alt=""><figcaption></figcaption></figure>

Users can create a **Guild** starting at the "Village" tier. The initial cost to create a guild is **5000 BIRDS**, and it can hold up to **100 members**. As the guild grows, the owner can upgrade to higher tiers by paying additional BIRDS to accommodate more members.

| Guild      | Members | Upgrade fee (BIRDS) |
| ---------- | ------- | ------------------- |
| Village    | 100     | 5,000               |
| Town       | 500     | 10,000              |
| Kingdom    | 1,000   | 25,000              |
| Empire     | 2,000   | 50,000              |
| Metropolis | 5,000   | 100,000             |
| Planet     | 10,000  | 200,000             |
| Galaxy     | 50,000  | 500,000             |

### Guild Benefits

**For Guild Owners:**

* **2% Bonus** from each member’s preying rewards. Guild owners benefit from their members' activity by receiving a percentage of their earned rewards when they prey.

**For Guild Members:**

* Members enjoy an additional **3% BIRDS boost** when they go preying, which encourages active participation within the guild.<br>

<div><figure><img src="/files/p8vKdw1Ev3htW27z6yNa" alt=""><figcaption></figcaption></figure> <figure><img src="/files/Cll96yttDLbL68YiuR7S" alt=""><figcaption></figcaption></figure></div>

### Guild Leaderboard & Boosts

Guilds will compete on a leaderboard based on the **total preying rewards** accumulated by all members. Top-ranking guilds earn extra BIRDS boost for everyone in the guild.

1. **Rank 1**: +3% Boost
2. **Rank 2**: +2% Boost
3. **Rank 3**: +1% Boost
4. **Ranks 4–10**: +0.5% Boost

These bonuses are applied to both guild owners and members.<br>

<figure><img src="/files/v1DaYU0RGpcOjQg84AgK" alt="" width="375"><figcaption></figcaption></figure>


---

# 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://docs.birds.dog/ai-bird-game/guild.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.
