Motional HubDocs
Bắt đầu sử dụng

Cấu hình cơ bản

Hướng dẫn chi tiết về cấu hình ban đầu và các thiết lập quan trọng cho Discord Booking Bot

Trang này hướng dẫn bạn cấu hình chi tiết các kênh log, giao diện, bảng giá, biểu phí và các cài đặt bảo mật cho Booking Bot.

1. Thiết lập kênh Log và Welcome

Các kênh log giúp bạn theo dõi toàn bộ biến động tài chính, hành vi của staff và giao dịch trong cửa hàng.

Cấu trúc Category Log gợi ý

DANH SÁCH KÊNH
Booking Logs
log-cash
log-bills
log-commands
log-shop
log-reset
log-star
log-box

Các lệnh thiết lập nhanh kênh Log

Bạn có thể tạo toàn bộ các kênh log tự động bằng lệnh /settings log-all hoặc chỉ định thủ công từng kênh bằng các lệnh sau:

  • Kênh log câu lệnh: /settings log-commands #tên-kênh
  • Kênh log giao dịch: /settings log-cash #tên-kênh
  • Kênh log hóa đơn: /settings log-bills #tên-kênh
  • Kênh log cửa hàng: /settings log-shop #tên-kênh
  • Kênh log reset: /settings log-reset #tên-kênh
  • Kênh log star: /settings log-star #tên-kênh
  • Kênh log Lucky Box: /settings log-box #tên-kênh
  • Kênh chào mừng: /settings log-welcome embed:tên-embed #tên-kênh (không được tạo bởi log-all)

2. Cấu hình bảng giá và lương mặc định

Thiết lập biểu phí bằng lệnh /settings server. Các thông số bao gồm:

Thông sốMô tảVí dụ
Giá book ngàyGiá trị khách hàng phải trả cho mỗi giờ booking ban ngày25,000 VNĐ (Nhập: 25k)
Lương player ngàySố tiền chi trả cho player tương ứng mỗi giờ booking ban ngày22,000 VNĐ (Nhập: 22k)
Giá book đêmGiá trị khách hàng phải trả cho mỗi giờ booking ban đêm30,000 VNĐ (Nhập: 30k)
Lương player đêmSố tiền chi trả cho player tương ứng mỗi giờ booking ban đêm27,000 VNĐ (Nhập: 27k)
Phí về serverKhoản phí dịch vụ khấu trừ cố định gửi về server trên mỗi bill5,000 VNĐ (Nhập: 5k)
Phí thêm 1 ngườiPhí cộng thêm khi bill có tùy chọn thêm người5,000 VNĐ (Nhập: 5k)
Phí donateTỷ lệ phần trăm server thu từ tổng số tiền khách donate cho player5 (Server nhận 5%)

Bảng giá và lương chỉ thay đổi biểu phí hiển thị cho các hóa đơn mới. Các hóa đơn đã tạo trước đó sẽ giữ nguyên giá trị tại thời điểm tạo. Bạn nên thực hiện reset doanh thu trước khi cập nhật bảng giá lớn để tránh sai sót bảng lương.


3. Tùy chỉnh giao diện hiển thị

Thay đổi Prefix hệ thống

Bạn có thể cấu hình ký tự tiền tố (prefix) cho các câu lệnh text của bot:

prefix !     # Đổi prefix thành !
prefix $     # Đổi prefix thành $

Mẹo thiết lập Prefix: Nếu chưa cấu hình hoặc không biết prefix hiện tại của server, bạn có thể ping trực tiếp @BotName kèm theo lệnh để đổi prefix. Ví dụ: @BookingBot prefix ! để gán prefix mới là !.

Phân biệt loại lệnh:

  • Các câu lệnh bắt đầu bằng dấu gạch chéo /Slash Command.
  • Các câu lệnh viết thường không có dấu / ở đầu (ví dụ: cash, marry) là Prefix Command (chạy bằng tiền tố của server).

Thiết lập màu sắc Embed

Thay đổi màu viền của các thông điệp Embed được gửi bởi bot (sử dụng mã hex dạng 0xrrggbb):

color success 0x10b981      # Thiết lập màu thành công (Xanh lá)
color error 0xef4444        # Thiết lập màu thông báo lỗi (Đỏ)
color default 0x3b82f6      # Thiết lập màu mặc định (Xanh dương)
color all 0x7c3aed          # Cập nhật tất cả các loại màu trên thành màu Tím

Tùy chỉnh Emoji hệ thống

Cấu hình các emoji hiển thị kèm các trạng thái của bot:

emoji success     # Emoji hiển thị khi thực hiện thành công
emoji error       # Emoji hiển thị khi xảy ra lỗi
emoji cash 💰        # Emoji biểu thị tiền tệ

4. Thiết lập React Bill

Hai cách dùng — chi tiết tại Lệnh cho Supporter.

Cách 1: /react profile (kênh player-only)

  • Bước 1: Đăng ký kênh player nhận React Bill:
    /settings react_channel #tên-kênh
  • Bước 2: Gán profile player (prefix ar set):
    ar set Player1 | @Tên_Discord_Player
  • Bước 3: Trong ticket, chạy /react profile <tiêu đề>. Player react ở kênh react_channel; ticket hiện danh sách và cho xem profile.

Cách 2: {prefix}react (kênh hiện tại)

Trong ticket (hoặc kênh staff), gõ react <tiêu đề>. Bảng React Bill xuất hiện ngay tại kênh đó, không cần react_channel.


Checklist hoàn thành cấu hình

Hãy rà soát danh sách dưới đây sau khi hoàn tất các thiết lập:

  • Tất cả các role Discord đã được tạo và sắp xếp đúng thứ tự phân cấp.
  • Role của Bot nằm ở vị trí cao nhất để tránh lỗi phân quyền.
  • Toàn bộ kênh log hoạt động đã được gán thông qua /settings log-all.
  • Bảng giá và lương đã được cấu hình chính xác qua /settings server.
  • Kênh nhận React Profile (react_channel) đã được đăng ký nếu dùng /react profile.
  • Hệ thống Anti-Raid đã được kích hoạt (nếu bot thuộc nhóm có tính năng này).

Tính năng theo yêu cầu / whitelist bot

Tính năng theo yêu cầuTính năng này chỉ khả dụng trên một số bot, được làm riêng theo yêu cầu.

Anti-Raid (nếu bot thuộc nhóm trả phí):

/antiraid setup
/antiraid member rate:5 second:10 enable:true
/antiraid message rate:10 second:5 enable:true
/antiraid advanced punishment_type type:quarantine
/antiraid whitelist_role role:@Supporter
Tính năng theo yêu cầuCác câu lệnh sau là tính năng đặc thù và chỉ khả dụng trên một số bot, được làm riêng theo yêu cầu: Hệ thống quản lý Part-time: Lệnh cấu hình chung /settings parttime, và các lệnh gán nhân sự /parttime add, /parttime remove.

Kênh log part-time không được tạo bởi /settings log-all. Cấu hình riêng:

/settings parttime
/settings log-parttime #tên-kênh

On this page