DotMan Docs
Setup

Cấu hình cổng gạch thẻ và ngân hàng

Cấu hình cổng gạch thẻ

Đang cập nhật tài liệu...

Cấu hình ngân hàng

Cấu hình trong file banking.yml.

Bật chức năng ngân hàng

Đổi enabled: false thành enabled: true để bật.

Chọn loại ngân hàng

Đặt type là tên ngân hàng muốn sử dụng.

Phương thứcNgân hàng hỗ trợ
Trực tiếpMBBANK
PayOSMBBANK, BIDV, ACB, OCB, KLB

MBBANK (trực tiếp)

Đặt type: MBBANK và điền thông tin đăng nhập:

Thông tinMô tả
usernameTên đăng nhập tài khoản ngân hàng
passwordMật khẩu tài khoản ngân hàng
accountSố tài khoản để tra cứu lịch sử giao dịch
account-qrSố tài khoản để tạo mã QR (có thể dùng nickname; nếu không có thì để giống account)
account-nameTên chủ tài khoản, ví dụ: NGUYEN VAN A
intervalThời gian quét lịch sử giao dịch (giây), mặc định 5

Lưu ý

Cần tắt 2FA (xác minh 2 bước) trên app ngân hàng trước khi sử dụng.

Nếu không thể kết nối đến ngân hàng, có thể dùng proxy:

banking.yml
proxy:
  enabled: true
  use-socks: false
  host: '127.0.0.1'
  port: 1080

PayOS

Bật PayOS bằng cách đặt payos.enabled: true. Khi dùng PayOS, không cần nhập usernamepassword ngân hàng.

Lấy thông tin tại Kênh thanh toán - Thông tin kênh thanh toán trên my.payos.vn:

Thông tinMô tả
payos.client-idClient ID
payos.api-keyAPI Key
payos.checksum-keyChecksum Key
payos.url-successURL chuyển hướng khi giao dịch hoàn tất
payos.url-cancelURL chuyển hướng khi giao dịch bị hủy
account-qrSố tài khoản hiển thị trong game (PayOS OpenAPI)
account-nameTên chủ tài khoản hiển thị trong game

Payment Service

Payment Service hỗ trợ thêm ngân hàng ACB và một số ngân hàng khác. Khi dùng Payment Service, không cần nhập thông tin đăng nhập ngân hàng.

banking.yml
payment-service:
  enabled: true
  url: 'http://localhost:3000/payments'
Liên hệ MineVN Studio để được hướng dẫn cấu hình Payment Service.

Cấu hình point

Số point người chơi nhận khi nạp qua ngân hàng được tính theo công thức:

Point nhận = point-base + point-extra + (point-base × khuyến mãi)
Thông tinMô tảMặc định
point-baseSố point tiêu chuẩn trên mỗi 1000 VNĐ1
point-extraSố point nhận thêm trên mỗi 1000 VNĐ khi nạp qua ngân hàng0.5

Ví dụ: Với point-base: 1, point-extra: 0.5, khuyến mãi 50%:

Point nhận = 1 + 0.5 + (1 × 0.5) = 2 point / 1000 VNĐ

Lệnh sau khi nạp

Lệnh luôn chạy

Danh sách lệnh thực thi mỗi khi nạp thành công:

banking.yml
commands:
  - 'tell %PLAYER% Bạn vừa nạp %AMOUNT% VNĐ và nhận được %POINT% %POINT_UNIT%'

Lệnh theo mốc nạp tối thiểu

Hệ thống chọn mốc gần nhất không vượt quá số tiền nạp. Ví dụ: khai báo mốc 10k, 15k, 20k - nạp 17k sẽ chạy lệnh mốc 15k.

banking.yml
minimum-donate-commands:
  10000:
    - 'tell %PLAYER% Bạn vừa nạp %AMOUNT% VNĐ'
  50000:
    - 'tell %PLAYER% Bạn vừa nạp %AMOUNT% VNĐ'
  100000:
    - 'tell %PLAYER% Bạn vừa nạp %AMOUNT% VNĐ'

Placeholder dùng được trong lệnh:

PlaceholderMô tả
%PLAYER%Tên người chơi
%AMOUNT%Số tiền nạp
%POINT%Số point nhận được
%POINT_UNIT%Đơn vị point

Cài đặt khác

Thông tinMô tảMặc định
min-amountSố tiền nạp tối thiểu (VNĐ)10000
transaction-expiryThời gian hết hạn giao dịch (giây)600
bossbar.enabledHiển thị bossbar đếm ngược thời gian chuyển khoảntrue
bossbar.titleNội dung bossbar, hỗ trợ %TIME%-
Nếu dùng Casso free (giới hạn 30 giao dịch/tháng), nên đặt min-amount: 500000 để tăng doanh thu.

Sau khi cấu hình xong, dùng lệnh /dotman reload hoặc restart server để áp dụng.

Để bảo vệ thông tin đăng nhập ngân hàng khỏi bị sửa đổi trái phép, xem Bảo mật cấu hình.

On this page