Placeholder API

Mục lục

• Dữ liệu người chơi
• Top nạp
• Khung thời gian (TimeFrame)

---

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ày

Nế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%'