Lên bill Book & Donate

Bên cạnh bảng tự phục vụ của khách, Supporter dùng lệnh /book và /donate để lên bill cho khách, book nhiều player cùng lúc và đặt giá riêng cho từng bill.

Khách Tự Book Và Donate Trong Chat

Khi Owner bật Book hoặc Donate trong /config ➔ Panel khách, khách có thể tự tạo bill và thanh toán bằng lệnh chat:

b.book @Player 2h
b.buk @Player 2
b.book @Player1 @Player2 2h
b.donate @Player 100k
b.dnt @Player 100k
b.dnt @Player1 @Player2 100k
b.buk ab51 2h
b.buk ab51 @Player2 2h
b.dnt ab51 100k
@bot book @Player 2h
@bot donate @Player 100000

Các lệnh không có / ở trên là lệnh prefix; chọn Prefix trên thanh điều hướng để ví dụ dùng tiền tố máy chủ bạn. @bot là mention thật của bot trên Discord. Hỗ trợ alias b.buk cho b.book và b.dnt cho b.donate.

• Người gửi lệnh là khách trả tiền. Hỗ trợ chọn 1 đến 10 player (tự động gộp player trùng), mỗi người phải có vai trò Player trở lên trong server.
• Có thể gõ tên thay cho mention, trộn chung với mention được: bot tìm tên profile (autores) đã gắn user trước, không có thì tìm thành viên có tên hiển thị hoặc username trùng khớp (không phân biệt hoa thường). Tên phải khớp đầy đủ; nếu không tìm thấy, profile chưa gắn user hoặc có nhiều player cùng tên, bot từ chối cả lệnh và báo tên bị lỗi, khi đó hãy mention trực tiếp. Bản xem trước hiện ab51 → @Player để khách kiểm tra đúng người. Số giờ hoặc số tiền áp dụng cho từng player trong danh sách.
• Book nhận số giờ nguyên dương: 2 hoặc 2h. Không nhập nguyên chuỗi 2/2h.
• Donate nhận số tiền nguyên dương theo VNĐ hoặc hậu tố k: 100000 hoặc 100k.

• Bot hiện bản xem trước bằng Discord Components V2: danh sách player, số giờ/tiền mỗi người, phí server, số tiền cọc đã dùng và khoản còn lại cần thanh toán. Khách chọn Cọc, Cọc + Lương hoặc Cọc + BankQR theo số dư và cấu hình server.
• Khách có thời hạn 10 phút để xác nhận. Khấu trừ cọc an toàn (atomic hold); nếu hủy hoặc mã QR hết hạn, tiền cọc được hoàn lại ngay. Bấm lại không tạo thêm bill hoặc trừ tiền lần nữa.

BankQR cần tích hợp/cấu hình payment-config khả dụng, không chặn theo subscription. Chưa tích hợp thì bot cảnh báo setup; Cọc, Lương và việc mở bản xem trước vẫn theo quyền/nghiệp vụ hiện có. Xem Cổng thanh toán.

Tin nhắn sau khi tự book

Với b.book, b.buk, mention bot hoặc prefix đã cấu hình, bot gửi bill mới trong kênh sau khi thanh toán bằng Cọc/Lương thành công. Nếu chọn BankQR, bot gửi QR mới trước; bill được gửi sau khi thanh toán được đối soát. Chỉ sau khi gửi bill hoặc QR thành công, bot mới xóa bảng xác nhận cũ; tin nhắn lệnh của khách được giữ lại.

Hủy phiên book sẽ xóa bảng xác nhận và báo riêng tư. Nếu không xóa được, bot thay bảng bằng trạng thái đã xử lý và bỏ các nút thao tác. Giá hoặc số dư cọc đổi thì bot cập nhật ngay bảng xác nhận để khách kiểm tra và xác nhận lại; nếu cập nhật thất bại, giá cũ vẫn được giữ trong phiên và bot không thanh toán theo giá mới chưa hiển thị.

Nếu bill đã tạo nhưng không gửi được vào kênh, phiên vẫn khóa để tránh trừ tiền lần nữa; bảng cũ được bỏ nút. Kiểm tra bill/QR và liên hệ supporter trước khi tạo lệnh mới. Nếu Discord chặn cả xóa và sửa, bảng cũ có thể vẫn hiện nút nhưng phiên đã xử lý không thể thanh toán lần hai. Thay đổi này chỉ áp dụng cho tự book bằng tin nhắn; Donate và wizard trên panel/profile giữ luồng hiện tại.

1. Lên Bill Book Bằng Lệnh /book

Quyền hạn yêu cầu: Supporter trở lên.

/book khách:<@Khách> player:<@Player1> số-giờ:<Số> thanh-toán:<Phương-Thức> [tùy chọn...]

Các Tham Số

Cách tính tiền: giá mỗi giờ × số giờ × số player, cộng phí server riêng và phí thêm người (nếu có). Bill Cam / Game cần nhập giá hoặc đã cài giá sẵn trong /config.

Ví Dụ

# Book 1 player, trừ cọc
/book khách:@NguyenVanA player:@GamerX số-giờ:2 thanh-toán:Cash

# Book 2 player, bill Game ban đêm, thanh toán Bank
/book khách:@KhachVIP player:@GamerX số-giờ:3 thanh-toán:Bank player2:@GamerY loại-bill:Game bill_đêm:True

# Book ẩn danh với giá riêng, khách quét QR
/book khách:@KhachVip player:@GamerX số-giờ:1 thanh-toán:BankQR ẩn_danh:True giá:100000

2. Sau Khi Lên Bill

1. Bill: hiển thị số giờ, đơn giá, lương player, phụ phí và mã bill-id.
2. Nút thao tác trên bill:
   • Create Room: tạo phòng voice riêng cho khách và player. Xem Phòng voice theo bill.
   • Refund Bill: hoàn bill.
3. Ghi nhận: cộng giờ và lương cho player, gửi bill vào kênh log Bill.
4. Thông báo: khách nhận lời cảm ơn, player nhận tin báo có bill mới. Xem Thông báo.

3. Lên Bill Donate (/donate)

/donate khách:<@Khách> player:<@Player1> số-tiền:<Số-Tiền> thanh-toán:<Phương-Thức> [tùy chọn...]

• player2 đến player10: donate cho nhiều player cùng lúc.
• server-fees: phần trăm máy chủ giữ lại cho bill này. Bỏ trống thì lấy theo mục Phí donate trong /config.
• ẩn_danh: True: ẩn tên khách trên tin công khai.
• Hỗ trợ BankQR giống /book.

4. React Bill

Supporter mở một react bill để các player đang rảnh tham gia, khách chọn player theo hồ sơ:

/react profile tiêu-đề:Book tối nay khách:@Khách
b.react Book tối nay

• khách: bắt buộc với /react profile. Bảng react không hiện khách là ai; bot chỉ dùng thông tin này để player đã ẩn khách đó không react được. Dạng gõ chat b.react không chọn khách nên không lọc player đã ẩn khách.
• bill: Oncam, Random hoặc Game.
• số_người_random: số người được chọn ngẫu nhiên khi loại bill là Random.

Hai bảng của một phiên react

Áp dụng cho /react profile và react khách tạo từ bảng tự phục vụ:

• React Bill ở kênh react dành cho player: React Bill, Huỷ React, Dừng React. Nút Tới React Profile mở đúng bảng trong thread/kênh khách.
• React Profile trong thread/kênh khách: Tới React Bill mở đúng bài gọi player; menu bên dưới dùng để chọn hồ sơ.
• Show All hiện các hồ sơ chưa được công bố trong phiên, không gửi lại những hồ sơ đã hiện.
• Auto Show tự hiện hồ sơ khi player react: nút xanh lá khi bật, xám khi tắt. Khách của phiên và Supporter được đổi; khách đổi thì lựa chọn được lưu cho những phiên sau, Supporter đổi chỉ áp dụng phiên hiện tại.
• Refresh Player gửi danh sách mention chỉ mình người bấm thấy, giúp Discord client tải tên khi đang hiển thị dạng @id. Kết quả tải tên phụ thuộc Discord client.
• Dừng React nằm riêng hàng cuối bảng khách. Khách của phiên hoặc Supporter được dừng; liên kết giữa hai bảng vẫn giữ để tra cứu.

Các liên kết mở tin nhắn trực tiếp, không cấp thêm quyền xem thread/kênh. Khi nhiều player, phần danh sách chữ có thể rút gọn; menu vẫn có tối đa 5 nhóm, mỗi nhóm 25 player. Hồ sơ player và nút Book/Donate giữ nguyên. Dạng b.react thường không có bảng profile đối ứng.

5. Player Ẩn Khách

Player tự chọn những khách mình không muốn nhận bill.

Player dùng: gõ b.tinhluong, bấm Settings, rồi bấm Ẩn Khách. Bảng ẩn khách chỉ mình bạn thấy. Chọn khách trong danh sách, rồi ghi lí do (bắt buộc, ít nhất 5 ký tự). Mỗi player ẩn được tối đa 25 khách. Chọn lại một khách đã ẩn để sửa lí do.

Sau khi ẩn:

• Player bấm React Bill trên react bill của khách đó sẽ bị từ chối. Áp dụng cho react tạo bằng /react profile và react khách tự tạo từ bảng tự phục vụ.
• Supporter vẫn lên bill chỉ định player đó được. Khi bấm Create Room, tin trong kênh Ping Bill gọi Supporter và báo player nào không nhận bill của khách này, để Supporter báo lại khách.

6. Các Lệnh Tra Cứu Nhanh

Trên thẻ b.star của mình, bấm Edit Image để đổi ảnh bằng link Discord; để trống để dùng lại avatar. Ảnh được cắt từ giữa theo tỉ lệ khung và giữ đúng tỉ lệ gốc, không kéo méo. Ảnh ngang cắt bớt hai bên, ảnh dọc cắt bớt trên/dưới; nên đặt phần cần giữ ở giữa ảnh.

Tra cứu kỳ bằng b.tl 10/11/2026 hoặc b.totalsalary 10/11/2026; cú pháp b.tl 46 2026 vẫn được hỗ trợ. Kỳ đã chốt dùng dữ liệu chốt kỳ, kỳ đang mở dùng số liệu hiện tại.

Nhập một ngày để xem cả kỳ lương chứa ngày đó, không chỉ số liệu riêng ngày đó. Hỗ trợ DD/MM/YYYY, DD-MM-YYYY hoặc DD/MM (năm hiện tại theo giờ Việt Nam). Không nhập ngày thì xem kỳ đang mở. Cú pháp tuần/năm cũ như 46 2026 vẫn tra theo thông tin kỳ đã lưu, không đổi sang tuần lịch ISO. Nếu có nhiều kỳ cùng chứa ngày đã nhập, chọn kỳ có ngày bắt đầu mới nhất.

Đổi lương sang cash và chuyển lương cho khách

Server bật trong /config → Giá & phí → Lương & cash. Để trống là tắt.

• Đổi Cash: mở b.salarycalc → Settings → Đổi Cash, nhập số lương. Nhận số cash theo % server đặt (ví dụ 90%: đổi 100.000 lương nhận 90.000 cash).
• Chuyển Lương: Settings → Chuyển Lương, chọn khách và nhập số lương. Phí trừ vào số chuyển (ví dụ phí 10%: chuyển 100.000, khách nhận 90.000 cash).
• Mỗi lần tối thiểu 1.000. Bot hiện số tiền trước, bấm Xác nhận trong 5 phút mới trừ lương.
• Số lương đổi hoặc chuyển được tính vào mục Đã dùng của bảng lương và báo cáo chốt kỳ.

Chỉnh Giờ Và Donate Của Khách