🎫 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 terminatehoặ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/customrole search role:@bucketCá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/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
/customrole user info role:@bucketCá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àyauthor: Chỉ định chủ của role tùy chỉnhname: Chỉ định tên rolemax_users: Số người dùng tối đa có thể được gán vào role nàyexpire_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 rolesecondary_color: Màu phụ của role, để trống cho màu mặc địnhedit_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 rolemake_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
/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
/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/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 roleauthor: Chỉ định chủ của role tùy chỉnhmax_users: Số người dùng tối đa có thể được gán vào role nàyexpire_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/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
/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
/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
/customrole list