> For the complete documentation index, see [llms.txt](https://onic-studio.gitbook.io/solarplugins-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onic-studio.gitbook.io/solarplugins-docs/plugins/solarduels/placeholderapi.md).

# PlaceholderAPI

SolarDuels chỉ trả placeholder khi server đã cài **PlaceholderAPI**.

### Cài PlaceholderAPI

{% stepper %}
{% step %}

### Tải PlaceholderAPI

Tải từ SpigotMC:

* `https://www.spigotmc.org/resources/placeholderapi.6245/`
  {% endstep %}

{% step %}

### Cài vào plugins

Thả file `.jar` vào thư mục `plugins/`.
{% endstep %}

{% step %}

### Restart server

Restart để PlaceholderAPI load.
{% endstep %}
{% endstepper %}

### Danh sách placeholder

Định dạng chung là `%solarduels_<placeholder>%`.

#### Thống kê trận đấu

| Placeholder                | Mô tả                             |
| -------------------------- | --------------------------------- |
| `%solarduels_wins%`        | Số trận thắng.                    |
| `%solarduels_losses%`      | Số trận thua.                     |
| `%solarduels_draws%`       | Số trận hòa.                      |
| `%solarduels_total_games%` | Tổng số trận đã đấu.              |
| `%solarduels_kills%`       | Số mạng hạ gục trong trận.        |
| `%solarduels_deaths%`      | Số lần tử trận.                   |
| `%solarduels_kdr%`         | Tỉ lệ K/D.                        |
| `%solarduels_winrate%`     | Tỉ lệ thắng, tính theo phần trăm. |
| `%solarduels_winstreak%`   | Chuỗi thắng hiện tại.             |
| `%solarduels_beststreak%`  | Chuỗi thắng cao nhất đã đạt được. |

#### Điểm ELO và xếp hạng

| Placeholder                     | Mô tả                                      |
| ------------------------------- | ------------------------------------------ |
| `%solarduels_elo%`              | Điểm ELO hiện tại.                         |
| `%solarduels_elo_colored%`      | Điểm ELO kèm màu theo phân hạng.           |
| `%solarduels_rank%`             | Tên hạng hiển thị hiện tại.                |
| `%solarduels_rank_id%`          | ID của hạng hiện tại.                      |
| `%solarduels_rank_min%`         | Mốc ELO tối thiểu của hạng hiện tại.       |
| `%solarduels_rank_max%`         | Mốc ELO tối đa của hạng hiện tại.          |
| `%solarduels_rank_next%`        | Tên hạng kế tiếp.                          |
| `%solarduels_rank_next_id%`     | ID của hạng kế tiếp.                       |
| `%solarduels_rank_next_needed%` | Số điểm ELO còn thiếu để lên hạng kế tiếp. |
| `%solarduels_rank_progress%`    | Phần trăm tiến trình lên hạng hiện tại.    |

#### Trạng thái và trận đấu

| Placeholder                | Mô tả                                                  |
| -------------------------- | ------------------------------------------------------ |
| `%solarduels_in_duel%`     | Trả `true` nếu người chơi đang trong trận.             |
| `%solarduels_in_queue%`    | Trả `true` nếu người chơi đang trong hàng chờ.         |
| `%solarduels_status%`      | Trạng thái hiển thị, như đang đấu, đang chờ hoặc rảnh. |
| `%solarduels_duel_toggle%` | Trạng thái nhận lời thách đấu.                         |

Test nhanh trong game:

```
/papi parse me %solarduels_wins%
```