# Guild Wars

Guild Wars is a high-stakes, multiplayer PVP feature in the Pett.ai ecosystem where Guilds compete for dominance and $AIP rewards. In this mode, Your Wealth is Your Health—the more $AIP a Guild holds, the harder it is to destroy, but the richer the prize for its enemies.

### 📋 Participation Requirements

To participate in Guild Wars—whether declaring war or being targeted—a Guild must meet the minimum treasury threshold:

* Minimum Vault Balance: `10,000 $AIP` 
* Status: Only Guilds meeting this requirement are "Active" on the battlefield. 

***

### 🏰 Core Mechanics

#### 1. Guild HP (Health Points)

A Guild's durability is directly tied to the size of its Treasury. We use a scaling formula that rewards larger vaults with significantly higher HP, though with slight diminishing returns.

Scaling Examples:

| **Vault Balance ($AIP)** | **Guild HP** |
| ------------------------ | ------------ |
| 1,000                    | 1,504        |
| 10,000                   | 11,944       |
| 50,000                   | 50,850       |

#### 2. Defensive Systems (Shields)

Guilds can purchase Static Shields using their Vault's $AIP. Shields act as a buffer, absorbing 100% of incoming damage until they are depleted. Damage only touches the Guild's actual HP (and Vault) once the shield is broken. 

| **Tier**          | **Cost ($AIP)** | **Shield HP** | **Efficiency** |
| ----------------- | --------------- | ------------- | -------------- |
| Basic Shield      | 500             | 2,000         | 4.0 HP/$AIP    |
| Magic Barrier     | 1,000           | 5,500         | 5.5 HP/$AIP    |
| Fortified Bastion | 2,000           | 12,000        | 6.0 HP/$AIP    |

> Strategic Note: Higher-tier shields offer better cost-efficiency, making them essential for protecting large treasuries.

***

### ⚔️ Combat System

Players attack enemy Guilds using specific weapons. Each weapon has a unique cost, damage output, and critical hit chance, allowing for different tactical roles (DPS, Nuker, Poker).

Weapon Statistics 

| **Weapon**  | **Cost ($AIP)** | **Damage (HP)** | **Special Effect**                  |
| ----------- | --------------- | --------------- | ----------------------------------- |
| 🗡️ Sword   | 40              | 360             | Reliable: Consistent heavy strikes. |
| 🏹 Bow      | 20              | 200             | Crit: 20% chance of 2x Damage.      |
| ⚡ Lightning | 200             | 1,000           | Nuke: 5% chance of 2x Damage.       |

***

### 💰 Loot & Rewards System

When an enemy Guild's HP is reduced to 0, they are defeated. This triggers a "Heist" event where 30% of their remaining Vault is seized and distributed to the victors. 

Distribution Breakdown

1. Attacker Loot Pool (25%): Distributed among the players who attacked.
2. Guild Vault (5%): Deposited directly into the winning Guild's treasury to fund future wars.

#### The Profit Multiplier (1.3x)

To ensure war is profitable for active soldiers, the system applies a 1.3x Multiplier to the Attacker Loot Pool. 

> Summary:
>
> * Winners: The Guild grows stronger (+5% of enemy funds).
> * Soldiers: Attackers earn a massive payout (split of 25% + 1.3x multiplier).
> * Losers: The defeated Guild loses 30% of their holdings.


---

# 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.pett.ai/features/guild-wars.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.