Bỏ qua nội dung

💶 Ghi Donate

Vấn đề

Bạn có một server có thể nhận donate qua một số tiền tệ của bot khác (chẳng hạn như OwOBot), hoặc một đơn vị tính donate nhất định (tính theo điểm).

Với mỗi một mốc donate, bạn sẽ ghi lại số tiền donate ra một khu vực nào đó. Khi người đó đạt một mốc điểm donate nhất định, bạn sẽ cho người đó một role, có vai trò như phần thưởng donate.

Nhưng bạn cũng không thể đăng kí một số bot premium cho một tính năng này, hoặc là phải đương đầu với rắc rối vì mọi việc phải làm bằng tay.

Giải pháp

Chúng tôi mang đến tính năng này hoàn toàn miễn phí, để giúp bạn:

  • Tự động theo dõi các khoản donate (hoàn toàn tự động) từ người dùng tới đội ngũ quản lí máy chủ của bạn.
  • Tự động trao phần thưởng khi đạt một mốc donate nhất định
  • Ghi lại thông tin donate, cũng như có bảng xếp hạng, v.v.

Các lệnh hiển thị thông tin


/donation leaderboard - Bảng xếp hạng ủng hộ

Lệnh này sẽ gửi cho bạn bảng xếp hạng ủng hộ

Tham số lệnh (Parameters)

Không bắt buộc:

  • range: Chỉ định phạm vi cho truy vấn (trong ngày, hoặc trong tháng, hoặc trong năm)
  • limit: Chỉ định giới hạn cho truy vấn (số lượng người trong bảng)

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

Lệnh này sẽ xem top 25 người donate nhiều nhất trong tháng này

command
/donation leaderboard range:This month limit:25

/donation serverstats - Thống kê ủng hộ của máy chủ

Lệnh này sẽ gửi các thống kê về khoản ủng hộ của máy chủ

Tham số lệnh (Parameters)

Không có tham số

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

command
/donation serverstats

/donation userstats - Kiểm tra thông tin ủng hộ

Lệnh này sẽ kiểm tra thông tin ủng hộ của một người dùng

Tham số lệnh (Parameters)

Bắt buộc:

  • user: Chọn người dùng

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

Lệnh này sẽ kiểm tra thông tin ủng hộ của người dùng @tudubucket

command
/donation userstats user:@tudubucket

/donation configuration - Kiểm tra cài đặt

Lệnh này sẽ kiểm tra cấu hình về tính năng trên

Tham số lệnh (Parameters)

Không có tham số

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

command
/donation configuration

Các lệnh cài đặt (dành cho Admin)


/donation enable - Thiết lập bản ghi ủng hộ cho máy chủ

Lệnh này sẽ bắt đầu thiết lập bản ghi ủng hộ cho máy chủ

Tham số lệnh (Parameters)

Bắt buộc:

  • channel: Chỉ định kênh để tự động nhận ủng hộ từ thành viên thông qua loại tiền tệ của bot khác
  • receiver: Chỉ định người dùng, là người nhận ủng hộ

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

Lệnh này sẽ bắt đầu thiết lập bản ghi ủng hộ cho máy chủ, với kênh nhận donate là #donation, và người nhận ủng hộ đầu tiên là @tudubucket (có thể thêm người nhận ủng hộ)

command
/donation enable channel:#donation receiver:@tudubucket

/donation reward - Phần thưởng ủng hộ

Lệnh này sẽ đặt phần thưởng (role) sau khi ủng hộ một số điểm nhất định.

Tham số lệnh (Parameters)

Bắt buộc:

  • action: Hãy ghi hành động (thêm hoặc xóa)
  • role: Chọn vai trò (đóng vai như phần thưởng)
  • threshold: Chỉ định ngưỡng, bot thêm phần thưởng cho người dùng, nếu số tiền ủng hộ lớn hơn ngưỡng này

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

Lệnh này sẽ thêm vai trò @donator khi người dùng đạt được 100.000 điểm ủng hộ

command
/donation reward action:Add role:@donator threshold:100000

/donation threshold - Ngưỡng thông báo ủng hộ

Lệnh này sẽ chỉnh sửa ngưỡng thông báo ủng hộ. Khi một người dùng donate nhiều hơn số lượng được cài đặt ở đây, bot sẽ tự động thông báo tới kênh nhất định.

Tham số lệnh (Parameters)

Bắt buộc:

  • threshold: Chỉ định ngưỡng, nếu số tiền ủng hộ lớn hơn ngưỡng này, chúng tôi sẽ thông báo

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

Lệnh này sẽ chỉnh sửa ngưỡng thông báo ủng hộ trên 100.000 đơn vị donate

command
/donation threshold threshold:100000

/donation message - Chỉnh sửa tin nhắn ủng hộ

Lệnh này sẽ chỉnh sửa tin nhắn ủng hộ khi được gọi.

Bạn có thể kết hợp với BucketScript Functions để thêm tên server, tên người dùng, … vào tin nhắn cảm ơn

Placeholder bổ sung bạn có thể sử dụng:

  • {amount}: Hiển thị số tiền donate

Tham số lệnh (Parameters)

Bắt buộc:

  • message: Tin nhắn hiển thị khi có donate mới.

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

Lệnh này sẽ chỉnh tin nhắn ủng hộ thành Cảm ơn bạn {user} đã ủng hộ cho {server_name} {amount}!, và react thêm emoji 😋 vào tin nhắn cảm ơn

command
/donation message message:Cảm ơn bạn {user} đã ủng hộ cho máy chủ {server_name} {amount}{react_reply: 😋 }!

/donation receiverole - Đặt vai trò cho người nhận

Lệnh này sẽ đặt vai trò cho người nhận. Có nghĩa rằng, nếu bạn gửi tiền tệ của bot khác cho người có vai trò (role) này, thì bot sẽ công nhận đó là khoản donate.

Tham số lệnh (Parameters)

Bắt buộc:

  • role: Chọn vai trò

Không bắt buộc:

  • delete: Có đóng vai trò lệnh này như để xóa role nhận này hay không. Mặc định: không

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

Lệnh này sẽ đặt role @Staff trở thành role có thể được nhận donate.

command
/donation receiverole role:@Staff

/donation receiver - Thêm/Xóa người nhận

Lệnh này sẽ Thêm/Xóa người nhận. Có nghĩa rằng, nếu bạn gửi tiền tệ của bot khác cho người này, thì bot sẽ công nhận đó là khoản donate.

Tham số lệnh (Parameters)

Bắt buộc:

  • action: Hãy ghi hành động (thêm hoặc xóa)
  • receiver: Chỉ định người dùng, người sẽ là người nhận ủng hộ

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

Lệnh này sẽ thêm người dùng @tudubucket là người nhận ủng hộ

command
/donation receiver action:Add receiver:@tudubucket

Lệnh này sẽ xóa người dùng @tudubucket khỏi danh sách người nhận ủng hộ

command
/donation receiver action:Remove receiver:@tudubucket

/donation announcement - Đặt kênh thông báo ủng hộ

Lệnh này sẽ đặt kênh thông báo ủng hộ khi có ủng hộ tới.

Tham số lệnh (Parameters)

Bắt buộc:

  • channel: Chỉ định kênh, sẽ là kênh thông báo ủng hộ

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

Lệnh này sẽ đặt kênh thông báo là kênh #donator khi có ủng hộ tới.

command
/donation announcement channel:#donator

/donation channel - Thêm/Xóa kênh nhận ủng hộ

Lệnh này sẽ thêm/xóa kênh nhận ủng hộ

Tham số lệnh (Parameters)

Bắt buộc:

  • action: Hãy ghi hành động (thêm hoặc xóa)
  • channel: Chọn kênh

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

Lệnh này sẽ thêm kênh #general làm kênh nhận ủng hộ

command
/donation channel action:Add channel:#general

/donation add - Thêm số tiền ủng hộ

Lệnh này sẽ thêm số tiền ủng hộ vào số dư của người dùng

Tham số lệnh (Parameters)

Bắt buộc:

  • user: Chọn người dùng
  • amount: Hãy ghi số sượng

Không bắt buộc:

  • announce: Có nên thông báo về việc này hay không, mặc định: có
  • reason: Hãy nhập lý do cho hành động này, mặc định: không có
  • silent: Cho biết lệnh này có nên được thực hiện ở chế độ im lặng hay không, mặc định: không

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

Lệnh này sẽ thêm 50.000 điểm cho @tudubucket, với lí do thích thì cho

command
/donation add user:@tudubucket amount:50000 reason:thích thì cho

/donation subtract - Trừ số dư ủng hộ

Lênh này sẽ trừ số tiền ủng hộ khỏi số dư của người dùng

Tham số lệnh (Parameters)

Bắt buộc:

  • user: Chọn người dùng
  • amount: Hãy ghi số sượng

Không bắt buộc:

  • reason: Hãy nhập lý do cho hành động này
  • silent: Cho biết lệnh này có nên được thực hiện ở chế độ im lặng hay không

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

Lệnh này sẽ trừ 100.000 điểm của @tudubucket, với lí do láo

command
/donation add user:@tudubucket amount:100000 reason:láo

/donation autoreceive - Bật/tắt ghi ủng hộ tự động

Lệnh này sẽ bật, hoặc tắt tính năng ghi lại ủng hộ tự động cho máy chủ (không vô hiệu hóa tính năng)

Tham số lệnh (Parameters)

Bắt buộc:

  • action: Chọn hành động, tắt hoặc bật

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

Lệnh này sẽ tắt tính năng nhận donate tự động (bạn sẽ phải thêm khoản donate bằng lệnh /donation add)

command
/donation autoreceive action:False

/donation disable - Vô hiệu hóa tính năng

Lệnh này sẽ vô hiệu hóa bản ghi ủng hộ cho máy chủ này

Tham số lệnh (Parameters)

Không bắt buộc:

  • delete: Xóa dữ liệu ủng hộ của máy chủ, mặc định: không

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

Lệnh này sẽ tắt tính năng donate, nhưng không xóa dữ liệu

command
/donation disable delete:False