Tham khảo
Placeholder API
DotMan tích hợp với PlaceholderAPI. Tất cả placeholder đều có prefix %dotman_..._..._...%.
Dữ liệu người chơi
Lấy tổng số tiền nạp của người chơi đang xem placeholder.
| Placeholder | Mô tả |
|---|---|
%dotman_data_<key>% | Toàn thời gian |
%dotman_dataday_<key>% | Ngày hôm nay |
%dotman_dataweek_<key>% | Tuần này |
%dotman_datamonth_<key>% | Tháng này |
Key hiện có:
| Key | Mô tả |
|---|---|
donate_total | Tổng số tiền nạp |
Ví dụ:
%dotman_data_donate_total%
%dotman_dataday_donate_total%
%dotman_dataweek_donate_total%
%dotman_datamonth_donate_total%Top nạp
Lấy thông tin người chơi hoặc giá trị tại một vị trí trong bảng xếp hạng.
Cú pháp: %dotman_<loại>_<key>_<rank>_<type>%
| Tham số | Giá trị |
|---|---|
<loại> | top (toàn thời gian), topday, topweek, topmonth |
<key> | donate_total |
<rank> | Vị trí xếp hạng (1, 2, 3, ...) |
<type> | player (tên người chơi) hoặc value (số tiền) |
Ví dụ:
%dotman_top_donate_total_1_player% → Tên người chơi top 1 toàn thời gian
%dotman_top_donate_total_1_value% → Số tiền top 1 toàn thời gian
%dotman_topday_donate_total_1_player% → Tên người chơi top 1 hôm nay
%dotman_topday_donate_total_1_value% → Số tiền top 1 hôm nay
%dotman_topweek_donate_total_1_player% → Tên người chơi top 1 tuần này
%dotman_topmonth_donate_total_1_player% → Tên người chơi top 1 tháng nàyNếu vị trí chưa có người chơi:
player trả về Chưa xếp hạng, value trả về 0.Khung thời gian (TimeFrame)
Dùng cho các sự kiện có thời gian bắt đầu và kết thúc tùy chỉnh (ví dụ: sự kiện Giáng sinh, Tết, ...).
Cú pháp dữ liệu người chơi: %dotman_dataframe_<frame-id>_<key>%
Cú pháp top: %dotman_topframe_<frame-id>_<key>_<rank>_<type>%
| Tham số | Mô tả |
|---|---|
<frame-id> | ID của khung thời gian, định nghĩa trong khungthoigian.yml |
<key> | donate_total |
<rank> | Vị trí xếp hạng |
<type> | player hoặc value |
Ví dụ (khung thời gian giang-sinh-2025):
%dotman_dataframe_giang-sinh-2025_donate_total%
%dotman_topframe_giang-sinh-2025_donate_total_1_player%
%dotman_topframe_giang-sinh-2025_donate_total_1_value%Ví dụ thực tế - Hologram
Dưới đây là ví dụ hologram (dùng plugin DecentHolograms hoặc tương tự) hiển thị đầy đủ các loại placeholder của DotMan:
pages:
- lines:
- content: '&e&lDotMan - Thống kê nạp thẻ'
- content: '&fPoints của bạn: &b&l%playerpoints_points%'
- content: '&8&m---------------------'
- content: '&fTổng số tiền bạn đã nạp'
- content: '&e- Toàn thời gian: &a&l%dotman_data_donate_total%'
- content: '&e- Hôm nay: &a&l%dotman_dataday_donate_total%'
- content: '&e- Tuần này: &a&l%dotman_dataweek_donate_total%'
- content: '&e- Tháng này: &a&l%dotman_datamonth_donate_total%'
- content: '&8&m---------------------'
- content: '&fTop nạp #1'
- content: '&e- Toàn thời gian: &b%dotman_top_donate_total_1_player% &7- &a&l%dotman_top_donate_total_1_value%'
- content: '&e- Hôm nay: &b%dotman_topday_donate_total_1_player% &7- &a&l%dotman_topday_donate_total_1_value%'
- content: '&e- Tuần này: &b%dotman_topweek_donate_total_1_player% &7- &a&l%dotman_topweek_donate_total_1_value%'
- content: '&e- Tháng này: &b%dotman_topmonth_donate_total_1_player% &7- &a&l%dotman_topmonth_donate_total_1_value%'
- content: '&8&m---------------------'
- content: '&fSự kiện Giáng sinh 2025'
- content: '&e- Bạn đã nạp: &a&l%dotman_dataframe_giang-sinh-2025_donate_total%'
- content: '&e- Top 1: &b%dotman_topframe_giang-sinh-2025_donate_total_1_player% &7- &a&l%dotman_topframe_giang-sinh-2025_donate_total_1_value%'