Cấu hình Hệ thống & Biểu phí

Hướng dẫn quản lý giá booking, lương, khung giờ đêm, thông báo, màu form và tiền tố lệnh qua /config.

Lệnh /config là nơi chủ máy chủ thiết lập giá dịch vụ, lương player, khung giờ đêm, phí, cùng các cài đặt về bảng tự phục vụ, thông báo, tự đóng ticket và màu form.

Quyền hạn yêu cầu: Owner.

1. Mở Bảng Cấu Hình (`/config`)

/config

Chọn mục trong danh sách ở đầu bảng, rồi sửa bằng các nút bên dưới.

Mục	Gồm	Chi tiết
Giá & phí	Giá, lương, khung giờ đêm, bill Cam / Game, phụ phí	Mục 2 bên dưới
Panel khách	Bảng tự phục vụ của khách	Panel khách
Thông báo	Bật / tắt lời cảm ơn, tin nhắn riêng và câu báo vào / rời room voice cho cả máy chủ	Thông báo
Tự đóng ticket	Tự đóng ticket theo bill và nhắc ticket không hoạt động	Ticket
Quản lý ticket	Nhắc ticket chưa ai nhận sau một khoảng thời gian	Ticket
Ca làm việc	Supporter vào ca mới nhận được ticket, ra ca có thống kê ticket và bill	Ticket
Màu sắc	Màu viền container cho 13 vai trò UI hoặc toàn bộ giao diện	Mục 4 bên dưới
Sao lưu dữ liệu	Sao lưu và khôi phục autores, profile, shop, cấu hình	Mục 5 bên dưới

Mỗi mục (trừ Sao lưu dữ liệu) có nút Về mặc định. Bot hỏi lại trước khi làm và chỉ đưa mục đang mở về mặc định, các mục khác giữ nguyên.

2. Mục Giá & Phí

Mục này chia thành 6 nhóm, mỗi nhóm có một nút mở biểu mẫu:

Nút	Gồm
Giá ngày & đêm	Giá và lương mỗi giờ cho bill ngày và bill đêm
Khung giờ đêm	Giờ bắt đầu / kết thúc đêm (giờ Việt Nam) và số phút lệch
Bill Cam & Game	Giá mỗi giờ và phần trăm máy chủ giữ lại cho bill Cam / Game
Phí & Donate	Phí server riêng, phí thêm người, phần trăm phí donate
Lương & cash	5 ô: % phí đổi lương → cash, % phí đổi cash → lương, % phí chuyển lương cho khách, lương supporter mỗi bill và số kỳ treo trước khi gộp quỹ
Phí give cash	2 ô: % phí cash → lương và player → khách cho lệnh `give`. Để trống = không thu phí

Biểu mẫu điền sẵn giá trị hiện tại; chỉ cần sửa ô muốn đổi rồi gửi.

Ô tiền nhận 25000, 25.000, 25k, 2tr.
Ô giờ nhận 22:00, 22h30 hoặc 6.
Để trống giá bill Cam / Game là tắt loại bill đó.
Để trống phí cash → lương thì dùng phí lương → cash; để trống các ô còn lại trong Lương & cash là tắt tính năng tương ứng.

Chọn Role Player (give cash) tại phần Lương player & supporter để xác định player cho hai mức phí give.

Bảng hiển thị khung giờ đêm thực tế và cảnh báo khi cấu hình dễ gây nhầm (ví dụ lương cao hơn giá).

3. Giá Trị Mặc Định

Mục	Ý nghĩa	Mặc định
Giá ngày (giờ)	Giá mỗi giờ ban ngày	25.000
Lương ngày (giờ)	Lương player mỗi giờ ban ngày	20.000
Giá đêm (giờ)	Giá mỗi giờ ban đêm	30.000
Lương đêm (giờ)	Lương player mỗi giờ ban đêm	25.000
Giờ / Phút bắt đầu đêm	Mốc bắt đầu đêm, giờ Việt Nam	22:00
Giờ / Phút kết thúc đêm	Mốc kết thúc đêm	06:00
Phút lệch trước giờ đêm	Tính đêm sớm hơn mốc bắt đầu. Lệch 30 với mốc 22:00 thì đêm từ 21:30	0
Giá bill Cam / Game (giờ)	Giá mỗi giờ cho bill Cam, Game	Chưa cài
% server bill Cam / Game	Phần máy chủ giữ lại	0%
Phí server riêng	Cộng khi player về server riêng	10.000
Phí thêm người	Cộng cho mỗi người thêm	5.000
Phí donate (%)	Phần máy chủ giữ lại khi donate	10%
% nhận khi đổi lương → cash	Player đổi 100.000 lương nhận bao nhiêu % thành cash	Chưa cài (tắt)
% phí đổi cash → lương	Phí khi đổi cash sang lương (để trống = theo phí đổi lương → cash)	Theo lương → cash
% phí chuyển lương cho khách	Phần trừ vào số lương chuyển	Chưa cài (tắt)
Lương supporter mỗi bill	Supporter nhận cho mỗi bill họ lên	Chưa cài (tắt)
Số kỳ treo trước khi gộp quỹ	Sau X kỳ đã chốt, Admin được chọn từng khoản đủ hạn để xem trước và gộp quỹ; không tự thu tiền	Chưa cài (tắt); nhập 1–520
% phí cash → lương (give)	Phí trừ trong cash khách give cho player	Chưa cài (0%)
% phí player → khách (give)	Phí trừ trong cash player give cho khách	Chưa cài (0%)

Để đưa các giá trị này về mặc định, bấm Về mặc định trong mục Giá & phí.

Tùy biến màu viền container (Components V2) của bot theo nhận diện thương hiệu của máy chủ. Bạn có thể chọn chỉnh riêng từng mục trong 13 vai trò màu giao diện hoặc chọn Tất cả (all) để đổi đồng bộ:

13 vai trò UI gồm:
- Nhóm trạng thái & hệ thống: Thành công (success), Báo lỗi (error), Thông tin (info), Cảnh báo (warning), Màu chính (primary).
- Nhóm sự kiện: Giveaway bắt đầu (giveawayStart), Giveaway kết thúc (giveawayEnd).
- Nhóm bảng màu cơ bản: Xanh lá (green), Đỏ (red), Blurple (blurple), Vàng (yellow), Cam (orange), Xanh dương (blue).

Thao tác	Dùng để
Menu Chọn mục màu	Chọn 1 trong 13 vai trò hoặc chọn `Tất cả các màu (all)` để mở ô nhập màu tương ứng
Sửa màu (Modal)	Nhập mã màu hex dạng `#RRGGBB` (ví dụ `#5865F2`, hỗ trợ cả màu đen `#000000`). Bỏ trống ô nhập và bấm Lưu để đưa mục đó về màu mặc định gốc
Sửa Màu (Nút bấm)	Mở form nhanh chỉnh 2 màu cốt lõi (`Thành công` & `Báo lỗi`)
Xem Thử	Gửi tin nhắn mẫu kiểm tra màu đang áp dụng
Về mặc định	Đưa toàn bộ 13 màu của máy chủ về bảng màu mặc định ban đầu

Vùng bảo vệ và ngoại lệ: Các giao diện có hình ảnh banner canvas cố định (bảng xếp hạng Top Cash, Top Nợ, Cửa hàng, Túi đồ, thông báo hoàn bill/donate), các mẫu template tự tạo (EmbedV2), câu trả lời tự động (AutoResponder) và thẻ cá nhân của player giữ màu sắc thiết kế riêng, không bị ghi đè khi đổi màu máy chủ.

5. Mục Sao Lưu Dữ Liệu

Lưu lại autores, profile, shop, LuckyBox, cấu hình booking và template của server. Không lưu tiền, lương, bill hay thông tin thanh toán.

Tạo bản sao lưu: bấm nút, bot giữ 5 bản mới nhất.
Khôi phục: chọn bản → chọn phần cần khôi phục (hoặc Tất cả) → xem số mục sẽ thêm / ghi đè → Xác nhận khôi phục.
Khôi phục không xóa gì: mục bạn tạo sau khi sao lưu vẫn được giữ. Mục trùng tên sẽ trở về như trong bản sao lưu.
Bản sao lưu chỉ dùng cho chính server đó. Muốn chuyển sang server khác, liên hệ developer.

6. Mục Chung: Đổi Tiền Tố Lệnh

Mặc định các lệnh văn bản dùng tiền tố b..

Gõ /config, mở mục Chung, bấm Đổi Prefix rồi nhập tiền tố mới. Bấm Về mặc định để trở lại tiền tố gốc.

Vẫn đổi được bằng lệnh văn bản:

b.setprefix !
b.setprefix reset

Tiền tố dài 1–5 ký tự, không có khoảng trắng. Sau khi đổi, các lệnh dùng tiền tố mới (ví dụ !help, !salary).

7. Gia Hạn Bot (`/renew`)

Quyền hạn yêu cầu: quyền Administrator của Discord.

/renew

Bot tạo hóa đơn gia hạn kèm mã VietQR. Chuyển khoản xong bot tự gia hạn; bấm Kiểm tra thanh toán nếu muốn kiểm tra ngay. Lệnh này vẫn dùng được khi bot đã hết hạn.

8. Chào Mừng & Tự Động Gán Role (`/welcome`)

Quyền hạn yêu cầu: Admin hoặc Owner.

/welcome

Bảng cấu hình chào mừng thành viên mới gồm 2 mục:

Tin nhắn chào mừng

Thiết lập kênh gửi tin nhắn, bật / tắt và chỉnh sửa mẫu tin nhắn chào mừng (EmbedV2) hoặc gửi tin nhắn xem thử.

Tự động gán role (Auto-role)

Tự động gán các vai trò (role) đã chọn cho thành viên mới khi vừa tham gia máy chủ:

Chọn vai trò: Sử dụng menu chọn vai trò, hỗ trợ tối đa 25 vai trò. Chọn danh sách rỗng sẽ tự động tắt tính năng.
Bật / Tắt: Quản lý trạng thái hoạt động. Nút Bật bị vô hiệu hoá khi chưa chọn vai trò nào.
Về mặc định: Nút ở cuối bảng cho phép xoá toàn bộ vai trò đã chọn và đưa trạng thái về tắt.
Thứ bậc và phân quyền Discord:
- Người thao tác cấu hình phải có quyền Manage Roles (hoặc là Chủ máy chủ / Server Owner) và có vị trí vai trò cao hơn các vai trò được chọn. Quyền Administrator không bỏ qua thứ bậc vai trò.
- Bot phải có quyền Manage Roles và có thứ bậc vai trò cao hơn các vai trò được chọn. Khi gán role, bot sẽ tự động bỏ qua các vai trò bot không đủ quyền quản lý hoặc đã bị xoá.
Xác minh thành viên (Membership Screening): Nếu máy chủ bật tính năng duyệt quy tắc cộng đồng của Discord, bot sẽ hoãn gán role và chỉ thực hiện gán sau khi thành viên hoàn tất bước xác minh.
Bảo vệ Anti-Raid & Cách ly hồi tố:
- Khi hệ thống Anti-Raid bật cơ chế cách ly hồi tố (retro-quarantine), bot sẽ tạm hoãn gán role trong suốt khoảng thời gian cửa sổ theo dõi lượt tham gia.
- Nếu thành viên bị đưa vào diện cách ly hoặc máy chủ đang xảy ra raid, bot sẽ chặn không gán role và không tự động gán bù sau raid hoặc sau khi gỡ cách ly.
Lưu ý vận hành: Hàng đợi tác vụ hoãn gán role được duy trì trong bộ nhớ tạm (RAM). Nếu bot khởi động lại (restart) trong thời gian chờ, các tác vụ này sẽ bị hủy và bot không quét/gán bù cho các thành viên đó.