Nạp thẻ cào cho server Minecraft

DotMan là plugin nạp thẻ cào tự động cho server Minecraft: Người chơi nạp thẻ ngay trong game qua giao diện /napthe hoặc lệnh nạp nhanh. Thẻ được gửi tới cổng gạch thẻ, nạp thành công thì plugin cộng point và chạy lệnh thưởng.

• Nhà mạng: Viettel, Mobifone, Vinaphone, Vietnamobile, cùng thẻ game Garena, Zing, Vcoin và Gate.
  • Bật/tắt từng loại tại Loại thẻ chấp nhận.
• Cổng gạch thẻ: Card2K, TheSieuRe và GameBank.
  • Bản Premium thêm GachThe1s và GachThe5s.

Chọn cổng gạch thẻ

Đặt cổng gạch thẻ trong mục provider của config.yml:

provider: card2k

provider	File cấu hình	Thông tin cần điền	Ghi chú
card2k	providers/card2k.yml	partner-id, partner-key	MineVN Studio khuyên dùng https://card2k.net/
thesieure	providers/thesieure.yml	partner-id, partner-key	https://thesieure.com/
gamebank	providers/gamebank.yml	merchant_id, api_user, api_password
gachthe1s	providers/gachthe1s.yml	partner-id, partner-key	Premium
gachthe5s	providers/gachthe5s.yml	api-key	Premium

1. Đặt provider rồi chạy /dotman reload, plugin sẽ tạo file cấu hình tương ứng trong thư mục providers.
2. Điền thông tin lấy từ trang quản lý của cổng gạch thẻ vào file đó.
3. Chạy /dotman reload để áp dụng.

Ví dụ với card2k:

partner-id: 'partner_id_của_bạn'
partner-key: 'partner_key_của_bạn'

Đã chạy /dotman configdb?

Sau khi bảo mật cấu hình, cổng gạch thẻ bị khóa trên database và mục provider trong file không còn tác dụng. Xem cách đổi cổng gạch thẻ khi đã khóa.

Loại thẻ chấp nhận

Bật/tắt từng loại thẻ trong config.yml:

card-types:
  viettel: true
  mobifone: true
  vinaphone: true
  vietnammobile: true
  garena: true
  zing: false
  vcoin: true
  gate: false

• Loại thẻ bị tắt sẽ không hiện trong giao diện và không dùng được với lệnh nạp nhanh.
• Loại thẻ đang bật nhưng cổng gạch thẻ báo bảo trì sẽ hiện ở trạng thái "tạm bảo trì".

Mệnh giá và point

Số point người chơi nhận được ứng với từng mệnh giá thẻ:

donate-amounts:
  10000: 10
  20000: 20
  30000: 30
  50000: 50
  100000: 100
  200000: 200
  300000: 300
  500000: 500
  1000000: 1000

• Các mệnh giá hỗ trợ: 10000, 20000, 30000, 50000, 100000, 200000, 300000, 500000, 1000000.
• Point thực nhận đã cộng thêm khuyến mãi:

Point nhận = point theo mệnh giá + (point theo mệnh giá × tỉ lệ khuyến mãi)

• Tỉ lệ khuyến mãi lấy từ lịch khuyến mãi.
  • Nếu là lần nạp đầu tiên, cộng thêm tỉ lệ khuyến mãi nạp lần đầu Premium.
• Ví dụ: Thẻ 100.000đ, khuyến mãi 50% thì nhận 100 + 100 × 0.5 = 150 point.
• Tính thử với cấu hình của bạn bằng công cụ Tính toán point.

Lệnh sau khi nạp thẻ

Lệnh chạy từ console khi nạp thẻ thành công, khai báo theo mệnh giá:

donate-commands:
  10000:
    - 'tell %PLAYER% Bạn vừa nạp %CARD_TYPE% %AMOUNT% VNĐ và nhận được %POINT% %POINT_UNIT%'
  100000:
    - 'tell %PLAYER% Bạn vừa nạp %CARD_TYPE% %AMOUNT% VNĐ và nhận được %POINT% %POINT_UNIT%'

Placeholder	Mô tả
%PLAYER%	Tên người chơi
%CARD_TYPE%	Loại thẻ, ví dụ VIETTEL
%AMOUNT%	Mệnh giá thẻ (VNĐ)
%POINT%	Point theo mệnh giá, chưa cộng khuyến mãi
%POINT_UNIT%	Đơn vị point

Người chơi nạp thẻ

Qua giao diện

1. Gõ /napthe để mở giao diện chọn loại thẻ.
2. Chọn mệnh giá.
3. Nhập số seri và mã thẻ:
   • Mặc định nhập qua Anvil.
   • Đặt use-anvilgui: false trong config.yml để nhập qua khung chat. Khi nhập qua chat, gõ HUY để hủy.

Người chơi Bedrock (qua Floodgate) được hiện giao diện dạng form Premium.

Nạp nhanh bằng lệnh

/napthe <loại thẻ> <mệnh giá> <số seri> <mã thẻ>

Ví dụ:

/napthe viettel 50000 12345678901 123456789012

• Lệnh có gợi ý tab cho loại thẻ và mệnh giá, dùng được trên cả bản 1.8.
• Số seri và mã thẻ tối đa 20 ký tự.

Giới hạn gửi thẻ Premium

• Mỗi lần gửi thẻ cách nhau ít nhất cooldown.transaction giây.
• Gửi thẻ lỗi 3 lần liên tiếp sẽ bị cấm gửi thẻ trong cooldown.card-submit giây.
• Xem cấu hình tại Cooldown.

Giao diện nạp thẻ

Giao diện được cấu hình trong 2 file:

File	Giao diện
menu/napthe/loaithe.yml	Chọn loại thẻ
menu/napthe/menhgia.yml	Chọn mệnh giá

Cách bố trí:

• rows: Số hàng của giao diện, tối đa 6.
• background.fill: Các ô đánh dấu x được tô nền. Số dòng phải bằng rows, mỗi dòng 9 ký tự.
• cards.fill, prices.fill: Các ô đánh dấu x lần lượt được đặt loại thẻ, mệnh giá.
• Các nút khác đặt theo slot (ô đầu tiên là 0).

Các nút trong giao diện chọn loại thẻ:

Nút	Chức năng
close	Đóng giao diện
info	Hiện thông báo, đổi nội dung bằng /dotman thongbao <nội dung>
banking-recommend	Dịch chuyển người chơi tới khu hướng dẫn chuyển khoản. Đặt vị trí bằng /dotman chuyenkhoan tại chỗ đang đứng.
cards.active	Loại thẻ đang hoạt động
cards.disabled	Loại thẻ đang bảo trì
cards.blank	Ô trống khi số loại thẻ ít hơn số ô x

Nội dung mặc định xem tại Config mẫu: menu.

Troubleshooting

Vấn đề	Cách xử lý
Người chơi nhận tin "Hệ thống nạp thẻ đang tạm khóa để bảo trì"	Database đã khóa một cổng gạch thẻ nhưng thiếu thông tin của cổng đó. Xem Bảo mật cấu hình.
Cần kiểm tra một giao dịch	Dùng /dotman tracuugd <mã giao dịch>, xem Lịch sử & thống kê.
Muốn thử công thức tính point	Dùng công cụ Tính toán point, hoặc lệnh /dotman testpoint <số tiền> trong game.