Bỏ qua nội dung

🎫 Custom Role

Vấn đề

Bạn muốn tạo 1 vai trò (role) cho một người dùng trong máy chủ (server) của bạn, có thể là 1 role có thời hạn, để thay cho một lời cảm ơn, hoặc một quyền lợi gì đó.

Tuy nhiên, bạn luôn phải…

  • Cập nhật người dùng & thông tin của role mỗi khi chủ của role yêu cầu
  • Nhớ thời gian để ngừng role của một người (Ví dụ: bạn tặng 1 role tùy chỉnh cho 1 người đã nâng cấp máy chủ cho bạn, tuy nhiên sau đó người này đã hủy bỏ nâng cấp và bạn phải tự xóa role đó)

Mọi thứ đều yêu cầu bạn phải thực hiện, bởi vì một người dùng không được phép tự quản lí role bằng quyền Quản lí Vai trò (Manage Roles) của Discord, hoặc là họ sẽ cho server của bạn nổ tung ☠

Giải pháp

Custom Role mà một tính năng đưa ra những giải pháp để:

  • Giúp bạn quản lí những role tùy chỉnh của member một cách nhanh chóng
  • Giúp người sở hữu role có thể tự tùy chỉnh role một cách an toàn đối với server (thêm/xóa member, đổi tên/màu/icon của role, tất cả trong lệnh /customrole user manage)
  • Tạo 1 role tùy chỉnh có thời gian được gia hạn bởi admin (/customrole admin create)
  • Cho phép chủ role tự chỉnh, hoặc phải gửi yêu cầu để admin duyệt trước
  • Nếu như việc gia hạn đã kết thúc (/customrole admin terminate hoặc tự động hết hạn), bot sẽ tự xóa role, hoặc xóa tất cả member của role đó, tùy theo cài đặt của bạn (/customrole configuration)

Lệnh chung


/customrole search - Tìm kiếm role tùy chỉnh

Tìm kiếm thông tin một Custom Role được gán cho một thành viên

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn một Custom Role, hoặc chỉ định một Custom Role ID

Ví dụ sử dụng lệnh

Lệnh này sẽ tìm kiếm thông tin một role tùy chỉnh mang tên @bucket

command
/customrole search role:@bucket

Các lệnh dành cho người dùng


/customrole user manage - Quản lý role của bạn

Lệnh này sẽ mở menu để chủ role tự quản lý Custom Role của mình:

  • Thêm/Xóa thành viên
  • Đổi tên, màu (màu chính/màu phụ), icon
  • Bật/tắt cho phép role được ping

Tùy theo quyền admin cấp cho role, thay đổi sẽ được áp dụng ngay, hoặc được gửi thành yêu cầu để Quản trị viên duyệt.

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn một Custom Role, hoặc chỉ định một Custom Role ID

Ví dụ sử dụng lệnh

Lệnh này sẽ mở menu quản lý role @bucket

command
/customrole user manage role:@bucket

/customrole user info - Xem thông tin role

Lệnh này sẽ xem thông tin của một Custom Role (chủ role, thành viên, thời hạn, quyền)

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn một Custom Role, hoặc chỉ định một Custom Role ID

Ví dụ sử dụng lệnh

command
/customrole user info role:@bucket

Các lệnh dành cho quản trị


/customrole admin create - Tạo Role tùy chỉnh

Lệnh này sẽ tạo và gán một Custom Role (không có quyền) cho một thành viên

Tham số lệnh (Parameters)

Bắt buộc:

  • below_role: Custom Role mới sẽ nằm dưới role này
  • author: Chỉ định chủ của role tùy chỉnh
  • name: Chỉ định tên role
  • max_users: Số người dùng tối đa có thể được gán vào role này
  • expire_after: Hỗ trợ ngày ở dạng ngắn (ví dụ: 2mon1d2h), nhập ‘0’ để đặt là vĩnh viễn, ‘1’ để cho đến khi bỏ boost

Không bắt buộc:

  • color: Chỉ định màu của role
  • secondary_color: Màu phụ của role, để trống cho màu mặc định
  • edit_name: Cho phép chủ của role thay đổi tên role của họ
  • edit_icon: Cho phép chủ của role thay đổi icon của họ
  • edit_color: Cho phép chủ của role thay đổi màu của họ
  • manage_role_members: Cho phép chủ của role thêm/xóa thành viên của role
  • make_role_mentionable: Cho phép chủ của role làm cho role của họ có thể được nhắc đến bởi các thành viên khác

Các quyền bên trên có 4 lựa chọn: Có, Gửi Yêu cầu cho Quản trị viên duyệt, Không, Mặc định.

Ví dụ sử dụng lệnh

Lệnh này sẽ tạo 1 role @bucket dưới role @Custom Roles, với chủ của role là @tudubucket, có tối đa 3 người, hết hạn sau 1 tháng, và có màu ở dạng hex là #C0CDFF

command
/customrole admin create below_role:@Custom Roles author:@tudubucket name:bucket max_users:3 expire_after:1mon color:#c0cdff

/customrole admin manage - Quản lý role (admin)

Lệnh này sẽ mở menu quản lý một Custom Role với đầy đủ quyền của admin:

  • Đổi tên, màu, icon, bật/tắt ping
  • Sửa số người tối đa, thời hạn (gia hạn/rút ngắn)
  • Chuyển chủ role cho người khác
  • Ghi đè quyền của chủ role cho riêng role này
  • Thêm/Xóa thành viên

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn một Custom Role, hoặc chỉ định một Custom Role ID

Ví dụ sử dụng lệnh

command
/customrole admin manage role:@bucket

/customrole admin terminate - Ngừng role tùy chỉnh

Lệnh này sẽ chấm dứt một Custom Role đang được gia hạn

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn một Custom Role, hoặc chỉ định một Custom Role ID

Không bắt buộc:

  • delete_role: Xóa role hay không, mặc định: không

Ví dụ sử dụng lệnh

Lệnh này sẽ ngừng Custom Role @bucket, nhưng không xóa role

command
/customrole admin terminate role:@bucket delete_role:False

/customrole admin migrate - Chuyển sang role tùy chỉnh

Lệnh này sẽ di chuyển một role hiện tại bạn đang quản lí sang role tùy chỉnh của bot

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chỉ định một role
  • author: Chỉ định chủ của role tùy chỉnh
  • max_users: Số người dùng tối đa có thể được gán vào role này
  • expire_after: Hỗ trợ ngày ở dạng ngắn (ví dụ: 2mon1d2h), nhập ‘0’ để đặt là vĩnh viễn, ‘1’ để cho đến khi bỏ boost

Ví dụ sử dụng lệnh

Lệnh này sẽ di chuyển một role hiện tại bạn đang quản lí là @bucket sang role tùy chỉnh của bot, với chủ role là @tudubucket, tối đa 3 người dùng, và sẽ không bao giờ hết hạn

command
/customrole admin migrate role:@bucket author:@tudubucket max_users:3 expire_after:0

/customrole admin color-palette - Bảng màu

Lệnh này sẽ chỉnh bảng màu cho Custom Role (tối đa 25 màu). Bạn có thể bật chế độ chỉ cho phép chủ role dùng màu trong bảng.

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/customrole admin color-palette

/customrole configuration - Cài đặt Custom Role

Lệnh này sẽ mở menu cài đặt Custom Role của server:

  • Quyền mặc định của owner: Quyền mặc định cho tất cả Custom Role
  • Cảnh báo hết hạn: Gửi cảnh báo cho chủ role trước khi role hết hạn
  • Hành động khi hết hạn: Xóa tất cả thành viên, chỉ xóa owner, hoặc xóa role
  • Yêu cầu phê duyệt: Kênh để admin duyệt yêu cầu, và số yêu cầu tối đa cùng lúc

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/customrole configuration

/customrole list - Danh sách Custom Role

Lệnh này sẽ liệt kê các Custom Role trong server

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/customrole list