# PlaceholderAPI

KaGuilds 插件完全支持 PlaceholderAPI（PAPI），您可以在聊天、记分板、BossBar、Tab 列表等任何支持 PAPI 的地方使用 KaGuilds 的变量。

## 📋 基础信息

### 变量前缀

所有 KaGuilds 的占位符都使用 `kaguilds` 作为前缀：

```
%kaguilds_xxx%
```

### 安装步骤

1. 下载并安装 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 插件
2. 将 `KaGuilds.jar` 和 `PlaceholderAPI.jar` 放入 `plugins` 文件夹
3. 重启服务器，PlaceholderAPI 会自动加载 KaGuilds 扩展
4. 使用 `/papi parse player %kaguilds_name%` 测试变量

## 🎯 变量列表

### 📌 公会信息

| 变量                        | 说明      | 示例                    |
| ------------------------- | ------- | --------------------- |
| `%kaguilds_name%`         | 公会名称    | `我的公会`                |
| `%kaguilds_id%`           | 公会 ID   | `5`                   |
| `%kaguilds_level%`        | 公会等级    | `3`                   |
| `%kaguilds_balance%`      | 公会余额    | `1500.0`              |
| `%kaguilds_announcement%` | 公会公告    | `欢迎加入！`               |
| `%kaguilds_owner%`        | 会长名称    | `Player1`             |
| `%kaguilds_create_time%`  | 公会创建时间  | `2024-01-15 10:30:00` |
| `%kaguilds_exp%`          | 当前经验值   | `1500`                |
| `%kaguilds_need_exp%`     | 下一级所需经验 | `2000`                |

### 👥 成员信息

| 变量                        | 说明    | 示例                          |
| ------------------------- | ----- | --------------------------- |
| `%kaguilds_member_count%` | 当前成员数 | `15`                        |
| `%kaguilds_max_members%`  | 最大成员数 | `20`                        |
| `%kaguilds_member_list%`  | 成员列表  | `Player1, Player2, Player3` |
| `%kaguilds_contribution%` | 个人贡献值 | `500`                       |

### 🔐 职位权限

| 变量                     | 说明      | 示例    |
| ---------------------- | ------- | ----- |
| `%kaguilds_role_name%` | 职位名称    | `管理员` |
| `%kaguilds_is_owner%`  | 是否是会长   | `是/否` |
| `%kaguilds_is_admin%`  | 是否是管理员  | `是/否` |
| `%kaguilds_is_staff%`  | 是否是管理成员 | `是/否` |

### ⚔️ PvP 数据

| 变量                      | 说明  | 示例   |
| ----------------------- | --- | ---- |
| `%kaguilds_pvp_wins%`   | 胜场数 | `10` |
| `%kaguilds_pvp_losses%` | 败场数 | `3`  |
| `%kaguilds_pvp_draws%`  | 平局数 | `2`  |
| `%kaguilds_pvp_total%`  | 总场次 | `15` |

### 📝 其他信息

| 变量                            | 说明               | 示例           |
| ----------------------------- | ---------------- | ------------ |
| `%kaguilds_pending_requests%` | 待处理申请数           | `3`          |
| `%kaguilds_has_guild%`        | 玩家是否已加入公会        | `是/否`        |
| `%kaguilds_reset_countdown%`  | 每日任务重置倒计时（时:分:秒） | `5小时30分钟20秒` |


---

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