Cẩm nang Nâng cấp từ V1 lên V2

Hướng dẫn chuyển đổi dành cho các máy chủ đang sử dụng Booking Bot V1 nâng cấp lên V2.

Tài liệu này dành cho chủ máy chủ và ban quản trị đang vận hành Booking Bot V1 và có kế hoạch nâng cấp lên Booking Bot V2.

1. V1 Và V2 Khác Nhau Thế Nào?

Hạng mục	Booking Bot V1	Booking Bot V2
Quản lý bill	Chỉ lưu giờ	Mỗi lần book là một bill riêng có mã `bill-id`
Phân loại dịch vụ	Không phân tách	Phân loại Cam hoặc Game trên bill
Hoàn tiền	Nhập lại số giờ, loại giờ thủ công	`/refundbill bill-id:<mã>`, hoàn được từng player
Khách hàng	Chờ supporter gõ lệnh	Khách tự book, donate, nạp cọc bằng nút bấm trong ticket
Chuyển khoản	Supporter tự kiểm tra tài khoản	Mã VietQR theo từng bill, bot tự lên bill khi tiền về
Nạp cọc	Supporter cộng tay	Khách tự nạp bằng QR, bot tự cộng
Phòng voice	Staff tự tạo phòng	Nút tạo phòng trên bill, tự xóa sau 5 phút trống, nhắc qua kênh Ping Bill
Bảng tổng lương	Ưu tiên giờ ngày	Xếp theo tổng số giờ (ngày + đêm + Cam + Game), tách riêng giờ đêm
QR Bank lương	Gửi qua tin nhắn	Lưu tập trung qua mục Kênh Bank QR của player của `/payment-config`, bank lương theo phiên bằng `/bankqr`
Quyền xem ticket	Gỡ quyền thủ công	Đi theo vai trò hiện tại; có tự đóng ticket theo bill
Sau khi lên bill	Không có	Lời cảm ơn cho khách, tin báo cho player
Hồ sơ player	Tin trả lời tự động	Thẻ hồ sơ có album, thống kê, đánh giá, nút Book / Donate
Thiết lập ban đầu	Nhiều lệnh riêng lẻ	Một lệnh `/setup`
Dòng tiền	Quyền tài chính chưa tách	Quyền Cash tách riêng

2. Bảng Đối Chiếu Câu Lệnh

Nghiệp vụ	Ở V1	Ở V2	Ghi chú
Thiết lập nhanh	(Không có)	`/setup`	Từng bước: vai trò, giá, tiền tố, kênh log
Vai trò và quyền	`/settings roles`	`/setuprole`
Đổi quyền từng lệnh	(Không có)	`/setuprole` ➔ mục Quyền lệnh	Đổi theo vai trò server hoặc bot
Giá, lương, phí	`/settings server`	`/config`	Sửa bằng biểu mẫu
Màu sắc embed / container	(Không có)	`/config` ➔ mục Màu sắc	Chỉnh 13 UI roles hoặc all
Bật khách tự phục vụ	(Không có)	`/config` ➔ mục Panel khách	Bảng hiện trong ticket, gọi bằng `/panel`
Kênh log	`/settings logs`	`/logger`	11 loại log
Tài khoản nhận tiền	`/settings qr`	`/payment-config`
Lên bill book	`/book` (`book_đêm`)	`/book` (`bill_đêm`)	Thêm Cam / Game, phí, giá riêng, ẩn danh
Trừ cọc	`Trừ cọc`	`Cash`	Cách xử lý giữ nguyên
Trừ lương	`Trừ lương`	`Lương`	Cách xử lý giữ nguyên
Hoàn bill	Hoàn giờ thủ công	`/refundbill` (`/hoanbill`)	Theo mã `bill-id`
Hoàn donate	Hoàn tiền thủ công	`/refunddonate` (`/hoandonate`)	Theo mã `bill-id`
Xem lương	`b.luong` / `b.tinhluong`	`b.salary` / `b.salarycalc`	Tên cũ vẫn dùng được
Tổng lương	`b.tongluong`	`b.totalsalary`	Xếp theo tổng số giờ
Hộp quà	`b.box`	`/luckybox` + `b.unbox`
Đọc văn bản	`b.speak`	`b.tts`	`b.speak` vẫn dùng được
Tạo tin nhắn Embed	`b.embed`	`/embedv2`
Thông tin bot	`b.info`	`b.botinfo`
Cách khớp Autoresponder	`b.ar include`	`b.ar matchmode`	Lệnh cũ vẫn chạy
Xem Autoresponder	`b.ar info`	`b.ar view`
Đổi số hồ sơ	`b.ar changenumber`	`b.ar rename`

3. Tính Năng Chỉ Có Ở V2

Khách tự phục vụ: tự React, Book, Donate, Nạp cọc bằng nút bấm trong ticket. Xem Panel khách.
Thanh toán VietQR: bill tự lên và cọc tự cộng khi tiền về; gọi nhanh QR bằng qr <số tiền>. Xem Cổng thanh toán.
Dùng cọc khi lên bill BankQR: khách còn cọc thì bot hỏi trả bằng cọc trước.
Phòng voice theo bill: tạo bằng nút trên bill, nhắc qua kênh Ping Bill khi player chưa vào, tự xóa sau 5 phút trống.
QR Bank lương: bank lương cho player theo tổng lương bằng /payment-config (mục Kênh Bank QR của player) và /bankqr. Xem QR Bank lương.
Lời cảm ơn và tin báo bill: tự gửi sau mỗi bill; mỗi người tự bật / tắt. Xem Thông báo.
Tự đóng ticket theo bill: có nhắc trước, nút gia hạn và giữ ticket. Xem Ticket.
Hồ sơ player thế hệ mới: thẻ Modern / Classic, album ảnh, thống kê, đánh giá. Xem Hồ sơ player.
Danh hiệu King / Queen: trao khi chốt kỳ lương. Xem King / Queen.
Bảng xếp hạng theo chu kỳ: lọc theo ngày, tuần, tháng, khoảng ngày. Xem Bảng xếp hạng.
Quỹ máy chủ và rà soát cọc không dùng: /fund, b.topcash.
Book ẩn danh: tên khách hiện là "Ai đó" trên tin công khai.
Đánh giá sao (Feedback) và Lucky Box có tỉ lệ rơi cấu hình được.

Booking Bot V2 có lớp bảo vệ cơ bản qua lệnh /antiraid: phát hiện vào ồ ạt, chống spam, chống link quảng cáo, khóa kênh khẩn cấp và cảnh báo khi kênh, vai trò bị xóa hàng loạt. Tính năng mặc định tắt; chủ máy chủ bật khi cần. Xem Anti-Raid.

Bot không tự ban hay kick thành viên. Máy chủ lớn nên dùng thêm AutoMod của Discord.

5. Những Gì Giữ Nguyên

/book và /donate: vẫn chọn khách, player, số giờ / số tiền và cách thanh toán như cũ.
Cửa hàng và túi đồ: b.shop, b.buy, /item, b.gift, b.inventory.
Tiền cọc: b.cash, b.addcash, b.subcash, b.give, b.topcash, b.topdebt.
Autoresponder cơ bản: tạo, sửa, xóa, xem tin trả lời tự động.
Kết hôn và giveaway.

6. Quy Trình Chuyển Đổi

Bước 1: Chốt Kỳ Trên Bot V1

Trước khi chuyển, lưu lại bảng tổng lương và số dư cọc của các thành viên trên bot V1.

Bước 2: Chuyển Dữ Liệu

Kỹ thuật viên Motional Hub thực hiện việc chuyển dữ liệu sang V2: số dư cọc của khách, dữ liệu của player và cấu hình máy chủ.

Bước 3: Chạy `/setup` Trên V2

Chủ máy chủ chạy /setup để gán vai trò và tạo kênh log, rồi mở /setuprole, /logger, /config để kiểm tra.

Bước 4: Bật Tự Phục Vụ

Tạo bảng ticket bằng /ticket setup, cài QR bằng /payment-config, bật nút bằng /config ➔ mục Panel khách.

Hỗ trợ trực tiếp: quá trình chuyển đổi luôn có kỹ thuật viên Motional Hub hỗ trợ tại Discord Hỗ Trợ.