PlaceholderAPI: placeholder
Cài đặt PlaceholderAPI, tải expansion, danh sách placeholder hữu ích, và gỡ lỗi khi placeholder hiện ra thay vì giá trị.
Cập nhật 13 tháng 8, 2026
PlaceholderAPI là một thư viện placeholder. Nó cho phép một plugin hiển thị dữ liệu từ plugin khác: số dư trong chat, khu vực trên scoreboard, clan trong danh sách người chơi.
Cài đặt
Cài đặt plugin từ danh mục, sau đó cài các expansion cho những nguồn dữ liệu bạn cần:
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
Cài từng expansion một, mỗi nguồn dữ liệu một expansion.
Các placeholder hữu ích
| Placeholder | Ý nghĩa |
|---|---|
%player_name% | Biệt danh |
%player_ping% | Ping |
%player_world% | Thế giới |
%server_online% | Số người chơi trực tuyến |
%server_tps_1% | TPS trong phút vừa qua |
%vault_eco_balance_formatted% | Số dư |
%luckperms_prefix% | Tiền tố nhóm |
%worldguard_region_name% | Khu vực người chơi đang đứng |
Kiểm tra
papi parse me %vault_eco_balance%
Lệnh này hiển thị những gì thực sự được thay thế. Nếu bạn thấy nguyên văn %vault_eco_balance%, nghĩa là:
- expansion chưa được cài đặt;
- thiếu nguồn dữ liệu (không có plugin kinh tế);
- plugin nơi bạn chèn placeholder không hỗ trợ PlaceholderAPI.
Trường hợp cuối là nguyên nhân phổ biến nhất: không phải plugin nào cũng hỗ trợ placeholder bên ngoài, kể cả khi nó có placeholder riêng.
Hiệu năng
Placeholder được tính lại mỗi lần làm mới. Một scoreboard có mười giá trị, làm mới mỗi tick, nghĩa là 200 phép tính mỗi giây cho mỗi người chơi: Scoreboard.
