> For the complete documentation index, see [llms.txt](https://docs.pett.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pett.ai/features/guild-wars.md).

# 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.