# 360 Credit Union Bot - Hướng dẫn sử dụng Bot Discord quản lý credit, item (thẻ bài), reward, lương chức vụ. Prefix lệnh: `!`. Ví dụ tham số: `@user` là mention người dùng, `@Role` là mention role, `#channel` là mention kênh, `` là mã do người dùng đặt. ## 1. Phân quyền | Nhóm | Là ai | Làm được gì | |---|---|---| | Member | Mọi người trong server | Tra số dư, xem túi, redeem, tip, xem bảng xếp hạng, lãnh lương | | Support | Role được thêm bằng `!supportrole add` | Mọi quyền Member + react emoji tặng credit + `!pay`, `!fine`, `!flee`, `!report` | | Valid Role | Role được thêm bằng `!validrole add` | Mọi quyền Support + `!remove`, `!rw`, `!luong`, `!redeem cancel`. Không hiển thị trên `!top` / `!toptop` | | Admin | Có quyền Administrator của Discord (hiện tại role Moderator đang có quyền Administrator nên cũng thuộc nhóm này) | Duyệt redeem, cấu hình bot, renew, clear role, tagrole | - Chưa set `!validrole` thì các lệnh Valid Role bị chặn. Admin cần set trước: `!validrole add @Role`. - Bot kiểm tra quyền Administrator của Discord, không kiểm tra tên role. Moderator dùng được toàn bộ lệnh Admin. - Trong Discord: `!help` (member), `!help support`, `!help admin`, `!help `. `!help admin` và `!help support` chỉ hiện với người có quyền. ## 2. Credit và Item | Key | Loại | Alias gõ lệnh | Giới hạn nhận qua react / tuần | |---|---|---|---| | coin | Credit | `coin`, `coins`, `c` | 30 | | gem | Credit | `gem`, `gems`, `g` | 15 | | mpking | Item (thẻ bài) | `mpking` | Không giới hạn | | tapolice | Item (thẻ bài) | `tapolice` | Không giới hạn | | fpqueen | Item (thẻ bài) | `fpqueen` | Không giới hạn | | obprince | Item (thẻ bài) | `obprince` | Không giới hạn | Credit hiển thị ở `!money`, `!top`. Item hiển thị ở `!bag`, `!toptop`. ## 3. Lệnh dành cho Member ### !money Xem số dư credit của bạn hoặc người khác. ``` !money !money @TA-Police ``` ### !bag Xem toàn bộ credit và item trong Túi Càn Khôn. ``` !bag !bag @TA-Police ``` ### !reward Xem danh sách reward hiện có và giá đổi. ``` !reward ``` ### !redeem Mở bảng reward với các nút bấm. Chọn reward, chọn cách thanh toán (nếu có nhiều lựa chọn), bot tạo request trạng thái PENDING chờ admin duyệt. Tiền chỉ bị trừ khi admin approve. ``` !redeem ``` - Nên xem `!reward` trước để biết giá. - Giá OR: chọn 1 trong các loại tiền. Giá AND: phải trả đủ tất cả. - Reward có giá ưu đãi cho Server Tag 360: bật Server Tag trong Discord để được tính giá thấp hơn. - Reward tài liệu (Google Drive): bot hỏi File ID và email, sau khi duyệt bot tự cấp quyền xem file cho email đó. - Reward có thanh toán Zelle: xem `!zelle`. ### !zelle Hiện mã QR Zelle để thanh toán USD trực tiếp. Sau khi chuyển tiền, bấm Xác nhận và nhập tên Zelle của bạn để admin đối chiếu. Tên này chỉ admin nhìn thấy. ``` !zelle ``` ### !tip Tặng credit hoặc item của bạn cho member khác. Số lượng phải là số nguyên dương, bạn phải đủ số dư, không thể tip cho chính mình. ``` !tip @TA-Police 3 coin !tip @TA-Police 3 mpking ``` ### !top và !toptop `!top`: bảng xếp hạng credit. `!toptop`: bảng xếp hạng item. Valid Role không xuất hiện trong bảng. ``` !top !toptop ``` ### !lanhluong Mở giao diện nút bấm để lãnh lương theo chức vụ. - Chọn chức vụ (hoặc chọn nhóm trước nếu chức vụ nằm trong nhóm). - Chọn kỳ lương: 1 buổi / 1 tuần / 1 tháng / 1 khóa (chỉ hiện kỳ đã được set giá). - Yêu cầu ở trạng thái PENDING chờ admin duyệt. ``` !lanhluong ``` ### !help ``` !help !help redeem !help support !help admin ``` ## 4. Nút bấm tương tác Các nút bot tự gắn vào tin nhắn, không phải lệnh gõ. Mỗi nút ghi rõ nhóm được bấm (mặc định là Member). ### Nút Unsubscribe (Auto-renew role) Với reward có bật gia hạn hàng tháng, bot đăng thông báo trong channel renew vào ngày 27 (9h sáng) và ngày 30 (3h sáng). Ngày 1 hàng tháng bot tự trừ tiền người đang giữ role. Nếu không muốn gia hạn, bấm Unsubscribe trong thông báo: tháng sau bạn bị gỡ role và không bị trừ tiền. Ai không đủ tiền sẽ bị gỡ role. Admin không bị trừ. ### Nút Calculate Position Size Khi alerter đã được cấu hình đăng alert (ticker, entry, tp) trong channel, bot gắn nút Calculate Position Size. Bấm nút để tự tính số share nên mua theo vốn và mức rủi ro của bạn. ### Nút Approve / Reject (duyệt redeem) - Admin Dưới mỗi thông báo request redeem (kể cả thanh toán bằng Zelle), bot gắn nút Approve và Reject. Admin bấm nút để duyệt hoặc từ chối ngay, không cần gõ `!approve` hay `!reject`. Chỉ người có quyền Administrator mới bấm được. ### Nút Xem tên Zelle - Admin Khi member bấm Xác nhận và nhập tên Zelle (từ `!zelle` hoặc khi redeem trả bằng Zelle), thông báo gửi cho admin có nút Xem tên Zelle. Admin bấm nút thì tên hiện ra và chỉ riêng admin nhìn thấy. Dùng để đối chiếu với giao dịch Zelle trước khi duyệt. ## 5. Lệnh dành cho Support Role Gồm mọi lệnh Member, cộng thêm: ### React Emoji React emoji credit/item (🪙, 💎, các emoji thẻ bài) vào tin nhắn của member để tặng 1 credit/item cho tác giả tin nhắn. - Mỗi tin nhắn chỉ được tặng tối đa 1 lần cho mỗi loại tiền. - Người nhận bị giới hạn theo tuần (coin 30, gem 15). Quá giới hạn bot báo "Weekly Limit Reached". - Không tặng cho bot. - Bỏ react không tự trừ điểm. Nếu react nhầm, dùng `!remove` (Valid Role). ### !pay Phát credit/item cho 1 member hoặc cho cả 1 role. ``` !pay @TA-Police 5 coin !pay @TA-Police 5 mpking !pay @MP 1 gem ``` ### !fine Phạt (trừ) credit của member. Chỉ dùng cho credit (coin, gem). Nếu số phạt lớn hơn số dư, bot chỉ trừ tối đa số đang có. ``` !fine @TA-Police 5 coin ``` ### !flee Phạt (trừ) thẻ bài của member. Chỉ dùng cho item. ``` !flee @TA-Police 5 mpking ``` ### !report Thống kê credit và item lưu thông trong tuần. | Chỉ số | Ý nghĩa | |---|---| | Minted | Phát hành: react emoji, `!pay` | | Burned | Tiêu thụ: redeem thành công, `!remove`, `!fine`, `!flee` | | Total (Net) | Tổng đang lưu thông trong server | | Active Holders | Số member đang giữ credit/item | ``` !report ``` ## 6. Lệnh dành cho Valid Role Gồm mọi lệnh Support, cộng thêm: ### !remove Thu hồi credit/item. Dùng khi react nhầm vì bỏ react không tự trừ điểm. ``` !remove @TA-Police 2 coin !remove @TA-Police 2 mpking ``` ### !rw (quản lý reward) Label và mô tả phải đặt trong dấu ngoặc kép. Thêm reward: ``` !rw add "