Cấu hình Hệ thống & Biểu phí
Hướng dẫn quản lý biểu phí booking, tính lương, khung giờ đêm và bảng tương tác khách hàng qua lệnh /config.
Lệnh /config là trung tâm điều hành tài chính của Booking Bot V2. Lệnh này cho phép Server Owner thiết lập toàn bộ chính sách giá dịch vụ, công thức chi trả lương cho player, tỷ lệ hoa hồng máy chủ và gửi bảng điều khiển tự động cho khách hàng.
1. Các Thông Số Cấu Hình Cốt Lõi
Hệ thống V2 chuẩn hóa toàn bộ biểu phí máy chủ thành một bảng điều hành tập trung, bao gồm các thông số chính sau:
| Tên tham số | Ý nghĩa vận hành | Đơn vị tính |
|---|---|---|
pricePerHour | Giá khách hàng thanh toán cho 1 giờ booking thông thường | VNĐ hoặc Tiền tệ máy chủ |
pricePerNightHour | Giá khách hàng thanh toán cho 1 giờ booking vào khung giờ đêm | VNĐ hoặc Tiền tệ máy chủ |
salaryPerHour | Tiền lương thực nhận của player cho 1 giờ booking thông thường | VNĐ hoặc Tiền tệ máy chủ |
salaryPerNightHour | Tiền lương thực nhận của player cho 1 giờ booking vào khung giờ đêm | VNĐ hoặc Tiền tệ máy chủ |
serverFeePerBooking | Phí khấu trừ cố định nộp về quỹ máy chủ trên mỗi hóa đơn | VNĐ hoặc Tiền tệ máy chủ |
extraPersonFee | Phụ phí cộng thêm khi khách hàng yêu cầu book thêm người | VNĐ / người |
donateCutPercentage | Tỷ lệ phần trăm máy chủ khấu trừ khi player nhận tiền donate (ví dụ: 10 = 10%) | Phần trăm (%) |
nightStartHour | Mốc giờ bắt đầu tính chế độ giờ đêm (mặc định: 0 - tương ứng 00:00) | Giờ (0 - 23) |
nightEndHour | Mốc giờ kết thúc chế độ giờ đêm (mặc định: 6 - tương ứng 06:00 sáng) | Giờ (0 - 23) |
minDepositAmount | Mức tiền nạp cọc tối thiểu để mở tài khoản phục vụ đặt lịch | VNĐ hoặc Tiền tệ máy chủ |
2. Giao Diện Quản Trị Trực Quan (/config view)
Thay vì phải gõ từng lệnh phức tạp, Booking Bot V2 cung cấp giao diện quản trị thông minh:
/config viewĐặc điểm giao diện:
- Bảng thông tin tự động nhóm các tham số theo từng danh mục: Biểu Phí Dịch Vụ, Chính Sách Lương, Khung Giờ Đêm, Tỷ Lệ Chiết Khấu.
- Đi kèm hệ thống Nút bấm tương tác: Khi bấm vào nút Chỉnh sửa biểu phí, bot sẽ mở một cửa sổ Form (Modal) cho phép bạn điền trực tiếp các con số mới và lưu ngay tức thì.
3. Cấu Hình Từng Tham Số Bằng Câu Lệnh (/config set)
Nếu muốn thay đổi nhanh một giá trị mà không cần mở form:
/config set key:<Tên-Tham-Số> value:<Giá-Trị-Mới>Ví dụ thực tế:
# Cập nhật giá booking ngày lên 50.000 VNĐ/giờ
/config set key:pricePerHour value:50000
# Cập nhật lương player ngày lên 35.000 VNĐ/giờ
/config set key:salaryPerHour value:35000
# Đặt tỷ lệ khấu trừ donate của server là 5%
/config set key:donateCutPercentage value:54. Gửi Bảng Tương Tác Khách Hàng (/config selfservice send)
Đây là một trong những tính năng nổi bật nhất của phiên bản V2: Panel Khách Hàng Tự Phục Vụ (Self-Service Client Panel).
Cú Pháp Gửi Panel
/config selfservice send channel:<#Kênh-Công-Khai>Trải Nghiệm Của Khách Hàng Trên Panel
Khi lệnh được thực thi, bot sẽ gửi một tin nhắn Embed chuyên nghiệp vào kênh chỉ định kèm 4 nút bấm tương tác:
- Nút "Đặt Lịch Ngay": Mở form chọn player, số giờ chơi, loại hình (Game/Cam), khung giờ và tự động tính toán tổng tiền.
- Nút "Ủng Hộ (Donate)": Mở form chọn player muốn gửi tiền tặng kèm lời nhắn yêu thương.
- Nút "Nạp Cọc / Số Dư": Tạo mã VietQR thanh toán tự động hoặc hiển thị thông tin chuyển khoản để nạp tiền vào tài khoản.
- Nút "Tra Cứu Hồ Sơ": Hiển thị số dư hiện có, số giờ đã trải nghiệm và lịch sử các hóa đơn gần nhất của khách hàng.
Lưu ý khi bật tính năng Nạp cọc trên Panel: Bạn cần hoàn tất thiết lập phương thức thanh toán hoặc cấu hình ngân hàng qua lệnh /payment-config trước khi bật nút Nạp cọc để bot có thể tạo mã VietQR tự động. Chi tiết xem tại Cổng thanh toán & Nạp cọc.
5. Đổi Prefix Câu Lệnh (/setprefix)
Mặc định các câu lệnh dạng văn bản (text command) của bot sử dụng tiền tố b.. Chủ máy chủ có thể đổi sang tiền tố khác bất kỳ lúc nào:
/setprefix prefix:!Sau khi đổi, các lệnh sẽ được kích hoạt bằng tiền tố mới (ví dụ: !help, !salary).