DotMan

Giao diện

Khung thời gian Premium ​

Khung thời gian (TimeFrame) là một sự kiện có thời gian bắt đầu và kết thúc tùy chỉnh, ví dụ Giáng sinh, Tết, Quốc khánh.

Tổng nạp của người chơi trong khung thời gian được theo dõi riêng, dùng cho:

Cấu hình ​

Tạo nhanh bằng công cụ

Dùng công cụ Tạo khung thời gian để chọn thời gian bằng lịch và kiểm tra ID. Công cụ cũng tạo sẵn placeholder và mẫu mốc nạp cho từng khung.

Khai báo trong file khungthoigian.yml:

yaml
giang-sinh-2026:              # ID của khung thời gian
  name: 'Giáng sinh 2026'     # Tên hiển thị
  from: 23/12/2026 00:00      # Thời gian bắt đầu
  to: 30/12/2026 23:59        # Thời gian kết thúc
Thông tinMô tả
IDTên mục, dùng trong placeholder và mốc nạp
nameTên hiển thị của sự kiện
from, toThời gian bắt đầu, kết thúc, định dạng dd/MM/yyyy HH:mm

Quy tắc đặt ID

  • Không chứa dấu gạch dưới (_).
  • Phải duy nhất, kể cả với các ID đã xóa khỏi file.
    • Dữ liệu được lưu theo ID, dùng lại ID cũ sẽ bị lẫn dữ liệu của sự kiện trước.
  • Nên kèm năm vào ID, ví dụ tet-2027, giang-sinh-2026.
  • Chỉ các giao dịch trong khoảng from tới to được tính vào khung thời gian.
    • to tính tới đúng phút đó, ví dụ 23:59 là hết lúc 23:59:00. Muốn trọn ngày cuối, đặt 00:00 của ngày hôm sau.
  • Dữ liệu khung thời gian lưu riêng, không ảnh hưởng tới dữ liệu toàn thời gian, ngày, tuần, tháng.

Placeholder ​

PlaceholderTrả về
%dotman_dataframe_<id>_donate_total%Tổng nạp của người chơi trong khung thời gian
%dotman_topframe_<id>_donate_total_<hạng>_player%Tên người chơi ở hạng <hạng>
%dotman_topframe_<id>_donate_total_<hạng>_value%Tổng nạp của người chơi ở hạng <hạng>
%dotman_masterdataframe_<id>_donate_total%Tổng nạp của cả server trong khung thời gian

Ví dụ với khung giang-sinh-2026:

%dotman_dataframe_giang-sinh-2026_donate_total%
%dotman_topframe_giang-sinh-2026_donate_total_1_player%
%dotman_topframe_giang-sinh-2026_donate_total_1_value%

Xem thêm tại Placeholder API, hoặc tạo nhanh bằng công cụ Tạo placeholder.

Mốc nạp theo khung thời gian ​

Đặt type: frame-<id> trong mocnap.yml hoặc mocnaptong.yml (có thể tạo bằng công cụ Tạo mốc nạp & thưởng top):

yaml
mocnap:
- type: frame-giang-sinh-2026
  amount: 500000
  commands:
    - 'tell %player% Bạn đã nạp đủ 500k trong sự kiện Giáng sinh!'