> 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/solarchat/placeholderapi.md).

# PlaceholderAPI

#### A. Placeholders nội bộ (Dùng trong cấu hình SolarChat)

Các thẻ này có thể chèn trực tiếp vào các định dạng chat trong `config.yml` hoặc các file cấu hình module của SolarChat:

* `{player}` / `{name}`: Tên của người chơi.
* `{displayname}`: Tên hiển thị của người chơi (gồm cả nickname/color thiết lập bởi các plugin khác).
* `{world}`: Tên thế giới hiện tại người chơi đang đứng.
* `{message}`: Nội dung tin nhắn gửi đi.
* `{prefix}`: Prefix (tiền tố) của người chơi lấy từ LuckPerms.
* `{suffix}`: Suffix (hậu tố) của người chơi lấy từ LuckPerms.
* `{rank}` / `{group}`: Nhóm chính (Primary Group) của người chơi trên LuckPerms.
* `{username-color}`: Màu sắc tên người chơi cấu hình trong Meta LuckPerms (`username-color`).
* `{message-color}`: Màu sắc tin nhắn mặc định cấu hình trong Meta LuckPerms (`message-color`).
* `%papi_placeholder%`: Bất kỳ Placeholder nào của plugin khác qua PlaceholderAPI (Ví dụ: `%vault_eco_balance_formatted%`).

#### B. Placeholders cho PlaceholderAPI (Dùng cho các plugin khác)

SolarChat đăng ký định danh `%solarchat_*%` để các plugin khác (như Scoreboard, Tablist, Hologram) có thể lấy dữ liệu trạng thái của người chơi:

| Placeholder                       | Trả về                                               | Ví dụ kết quả           |
| --------------------------------- | ---------------------------------------------------- | ----------------------- |
| `%solarchat_chat_status%`         | Trạng thái bật/tắt nhận chat chung của người chơi    | `§aBật` hoặc `§cTắt`    |
| `%solarchat_nightvision_status%`  | Trạng thái hiệu ứng nhìn đêm của người chơi          | `§aBật` hoặc `§cTắt`    |
| `%solarchat_announcement_status%` | Trạng thái nhận thông báo tự động của người chơi     | `§aBật` hoặc `§cTắt`    |
| `%solarchat_chatping_status%`     | Trạng thái nhận tag `@tên` trong chat của người chơi | `§aBật` hoặc `§cTắt`    |
| `%solarchat_msg_status%`          | Trạng thái nhận tin nhắn riêng `/msg` của người chơi | `§aBật` hoặc `§cTắt`    |
| `%solarchat_msg_last_replied%`    | Tên người chơi cuối cùng nhắn tin riêng với bạn      | `OmhVN` hoặc `Không có` |