# PlaceholderAPI

KaGuilds fully supports PlaceholderAPI (PAPI). You can use KaGuilds placeholders anywhere that supports PAPI, including chat, scoreboards, BossBars, and Tab lists.

## 📋 Basic Information

### Variable Prefix

All KaGuilds placeholders use `kaguilds` as the prefix:

```
%kaguilds_xxx%
```

### Installation Steps

1. Download and install [PlaceholderAPI](https://www.spigotmc.org/resources/6245/)
2. Place `KaGuilds.jar` and `PlaceholderAPI.jar` in the `plugins` folder
3. Restart the server — PlaceholderAPI will automatically load the KaGuilds expansion
4. Use `/papi parse player %kaguilds_name%` to test the placeholder

## 🎯 Placeholder List

### 📌 Guild Information

| Placeholder               | Description                      | Example               |
| ------------------------- | -------------------------------- | --------------------- |
| `%kaguilds_name%`         | Guild name                       | `My Guild`            |
| `%kaguilds_id%`           | Guild ID                         | `5`                   |
| `%kaguilds_level%`        | Guild level                      | `3`                   |
| `%kaguilds_balance%`      | Guild balance                    | `1500.0`              |
| `%kaguilds_announcement%` | Guild announcement               | `Welcome!`            |
| `%kaguilds_owner%`        | Owner's name                     | `Player1`             |
| `%kaguilds_create_time%`  | Creation time                    | `2024-01-15 10:30:00` |
| `%kaguilds_exp%`          | Current experience               | `1500`                |
| `%kaguilds_need_exp%`     | Experience needed for next level | `2000`                |

### 👥 Member Information

| Placeholder               | Description           | Example                     |
| ------------------------- | --------------------- | --------------------------- |
| `%kaguilds_member_count%` | Current member count  | `15`                        |
| `%kaguilds_max_members%`  | Maximum members       | `20`                        |
| `%kaguilds_member_list%`  | Member list           | `Player1, Player2, Player3` |
| `%kaguilds_contribution%` | Personal contribution | `500`                       |

### 🔐 Rank Permissions

| Placeholder            | Description     | Example  |
| ---------------------- | --------------- | -------- |
| `%kaguilds_role_name%` | Rank name       | `Admin`  |
| `%kaguilds_is_owner%`  | Is owner        | `Yes/No` |
| `%kaguilds_is_admin%`  | Is admin        | `Yes/No` |
| `%kaguilds_is_staff%`  | Is staff member | `Yes/No` |

### ⚔️ PvP Data

| Placeholder             | Description   | Example |
| ----------------------- | ------------- | ------- |
| `%kaguilds_pvp_wins%`   | Win count     | `10`    |
| `%kaguilds_pvp_losses%` | Loss count    | `3`     |
| `%kaguilds_pvp_draws%`  | Draw count    | `2`     |
| `%kaguilds_pvp_total%`  | Total matches | `15`    |

### 📝 Other Information

| Placeholder                   | Description                           | Example      |
| ----------------------------- | ------------------------------------- | ------------ |
| `%kaguilds_pending_requests%` | Pending join requests                 | `3`          |
| `%kaguilds_has_guild%`        | Player has a guild                    | `Yes/No`     |
| `%kaguilds_reset_countdown%`  | Daily task reset countdown (HH:MM:SS) | `5h 30m 20s` |


---

# 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://katacr.gitbook.io/plugins/kaguilds-en/placeholderapi.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.