KoraPayments icon

KoraPayments -----

payment plugin

Download Now
Via external site


KoraPayments
Modern Payment Solution for Minecraft Servers​

Nạp bank • Nạp thẻ • Mốc nạp • Khuyến mãi • Discord Webhook • Discord Auto Buy​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✨ Giới thiệu

KoraPayments là plugin thanh toán dành cho Minecraft server, tập trung vào trải nghiệm nạp tiền nhanh, rõ ràng và dễ quản trị.

Plugin hỗ trợ nạp ngân hàng qua QR, nạp thẻ cào, khuyến mãi theo sự kiện, mốc nạp cá nhân, mốc nạp toàn server, lịch sử giao dịch, bảng xếp hạng nạp, Discord Webhook và hệ thống Discord Auto Buy.

KoraPayments được thiết kế cho các server production cần một hệ thống donate/store ổn định, dễ cấu hình và chuyên nghiệp. Plugin tách module rõ ràng giữa nạp bank, nạp thẻ, mốc nạp, giao diện, Discord Store và PlaceholderAPI, giúp việc vận hành và bảo trì trở nên dễ dàng hơn.

⬇️ Tải plugin

Latest Release:
https://github.com/dduong19208/KoraPayments/releases/latest

Sau khi mở trang Releases, hãy tải file:

Code (Text):
KoraPayments-1.3.1.jar
Lưu ý: Không tải source code .zip hoặc .tar.gz nếu bạn chỉ muốn cài plugin vào server. Hãy tải file .jar trong phần Assets của release.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Tính năng nổi bật

Nạp ngân hàng

  • Hỗ trợ provider SePay và PayOS.
  • Tạo giao dịch theo số tiền người chơi nhập.
  • Hỗ trợ giao diện chọn mệnh giá bằng /bank gui.
  • Hiển thị thông tin chuyển khoản và QR thanh toán trong game.
  • Tự kiểm tra giao dịch theo chu kỳ cấu hình.
  • Hỗ trợ giới hạn số tiền tối thiểu, tối đa và timeout giao dịch.
  • Hỗ trợ khuyến mãi riêng cho nạp bank.

Nạp thẻ cào

  • Hỗ trợ provider Card2K và GachTheFast.
  • Có GUI chọn nhà mạng và mệnh giá bằng /napthe gui.
  • Có thể nhập serial và mã thẻ trực tiếp bằng command.
  • Hỗ trợ chiết khấu theo mệnh giá hoặc theo nhà mạng.
  • Hỗ trợ command thưởng sau khi nạp thành công.
  • Hỗ trợ khuyến mãi riêng cho nạp thẻ.

Mốc nạp cá nhân và toàn server

  • Mốc nạp cá nhân cho từng người chơi.
  • Mốc nạp toàn server cho toàn cộng đồng.
  • Bossbar theo dõi tiến độ mốc nạp server.
  • Cơ chế chống clone nhận thưởng mốc server.
  • Admin có thể đổi mốc bossbar đang theo dõi bằng command.

Top nạp và lịch sử giao dịch

  • /topnap hỗ trợ xem top tổng, tuần và tháng.
  • /lichsunap cho người chơi xem lịch sử nạp cá nhân.
  • Admin có thể xem lịch sử nạp của người chơi khác.
  • Có lệnh reset dữ liệu top nạp khi cần.

Discord Webhook

  • Gửi thông báo giao dịch nạp bank, nạp thẻ và nạp thủ công về Discord.
  • Có thể cấu hình màu embed, avatar, username.
  • Có thể bật hoặc tắt từng loại thông báo giao dịch.

Discord Auto Buy / KoraStore

  • Bot Discord đăng embed cửa hàng và menu chọn sản phẩm.
  • Người mua nhập tên nhân vật, thanh toán và plugin tự giao hàng bằng command.
  • Hỗ trợ trạng thái đơn đang chờ người chơi online.
  • Có log đơn thành công, đơn lỗi và feedback sau mua.
  • Có slash command staff để kiểm tra mã đơn.

PlaceholderAPI

KoraPayments tự đăng ký các identifier:

Code (Text):
%kp_*%
%korapayments_*%
Identifier korapayments được dùng làm alias tương thích khi cần tránh trùng identifier.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✅ Yêu cầu

  • Java: Java 17 trở lên
  • Server: Paper / Spigot 1.21.x
  • Folia: Có khai báo folia-supported: true
  • PlaceholderAPI: Tùy chọn, dùng nếu cần placeholder
  • Plugin điểm / coin / economy: Tùy chọn, phụ thuộc command thưởng bạn cấu hình
  • Discord Bot: Chỉ cần nếu bật Discord Auto Buy

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Hướng dẫn cài đặt nhanh

  1. Tải file KoraPayments-1.3.1.jar tại trang Releases.
  2. Dừng server Minecraft.
  3. Chép file .jar vào thư mục plugins/.
  4. Khởi động server để plugin tạo file cấu hình.
  5. Mở thư mục plugins/KoraPayments/.
  6. Cấu hình config.yml, store.yml và languages/vi.yml.
  7. Reload plugin bằng lệnh /kora-admin reload.
  8. Kiểm tra trạng thái bằng lệnh /kora-admin status.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

⚙️ Cấu hình nhanh

Chọn ngôn ngữ

Code (Text):
language: "vi"
Ngôn ngữ có sẵn: vi, en, es, fr, de, pt, ru, zh, ja, ko, th, id, ms, tl, hi, ar, tr, pl.

Nạp ngân hàng bằng SePay

Code (Text):
napbank:
provider: "sepay"
min-amount: 2000
timeout-seconds: 600
poll-every-seconds: 10

sepay:
api-token: "TOKEN_CUA_BAN"
bank-code: "MBBank"
bank-name: "MB Bank"
account-number: "SO_TAI_KHOAN"
account-name: "TEN_CHU_TAI_KHOAN"
payment-format: "{playername} TENCUM {ordercode}"
Lưu ý: Không bỏ {ordercode} khỏi payment-format, vì plugin cần mã này để đối soát giao dịch.

Nạp thẻ bằng GachTheFast

Code (Text):
napthe:
provider: "gachthefast"

gachthefast:
api:
partner_id: "PARTNER_ID"
partner_key: "PARTNER_KEY"
wallet_id: "WALLET_ID"
Lệnh thưởng sau khi nạp bank hoặc nạp thủ công

Code (Text):
reward-command: "p give {player} {points}"
conversion-rate: 1
Công thức mặc định:

Code (Text):
points = số_tiền / 1000 * conversion-rate
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Lệnh chính

  • /bank <số_tiền> - Tạo giao dịch nạp ngân hàng.
  • /bank gui - Mở GUI chọn mệnh giá nạp bank.
  • /bank cancel - Hủy giao dịch bank đang chờ.
  • /napthe gui - Mở GUI nạp thẻ.
  • /napthe <loại> <mệnh_giá> [serial] [mã_thẻ] - Nạp thẻ bằng command.
  • /confirmcard - Xác nhận gửi thẻ đang nhập.
  • /cancelcard - Hủy phiên nhập thẻ.
  • /topnap [all|week|month] [trang] - Xem bảng xếp hạng nạp.
  • /lichsunap - Xem lịch sử nạp cá nhân.
  • /mocnap canhan - Xem hoặc nhận mốc nạp cá nhân.
  • /mocnap server - Xem hoặc nhận mốc nạp toàn server.
  • /mocnap bossbar [on|off|toggle|status] - Tùy chỉnh bossbar cá nhân.
  • /kora-admin hoặc /kp-admin - Lệnh quản trị plugin.
  • /taokenhbanhang [publish|reload|status] - Quản lý Discord Auto Buy storefront.

Quyền hạn

  • korapayments.default - Cho phép người chơi dùng các lệnh nạp, top, lịch sử và mốc nạp.
  • korapayments.admin - Cho phép quản trị plugin, reload, nạp thủ công, reset dữ liệu và quản lý store.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

PlaceholderAPI nhanh

Code (Text):
%kp_donate_total%
%kp_donate_total_today%
%kp_donate_total_week%
%kp_donate_total_month%
%kp_donate_server_total%
%kp_donate_total_top_player_1%
%kp_donate_total_top_amount_1%
%kp_mocnapserver%
%kp_transactions%
Có thể thêm modifier raw number:

Code (Text):
_raw
_number
_plain
_unformatted
_noformat
Ví dụ:

Code (Text):
%kp_donate_total_raw%
%kp_donate_server_total_number%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Bảo mật vận hành

Không public các thông tin thật sau:

  • sepay.api-token
  • payos.client-id
  • payos.api-key
  • payos.checksum-key
  • card2k.partner_id
  • card2k.partner_key
  • gachthefast.partner_id
  • gachthefast.partner_key
  • wallet_id
  • discord-webhook.url
  • store.yml chứa bot-token

Nếu bạn vô tình public token, hãy thu hồi token cũ và tạo token mới ngay.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Checklist test sau khi cài

  • /kora-admin status hiển thị đúng provider và PlaceholderAPI.
  • /bank 10000 tạo được giao dịch, QR và nội dung chuyển khoản.
  • /bank cancel hủy được giao dịch đang chờ.
  • /napthe gui mở được GUI chọn thẻ.
  • /topnap mở được bảng xếp hạng.
  • /lichsunap hiển thị lịch sử cá nhân.
  • /mocnap server hiển thị mốc server.
  • Nếu bật Discord webhook, giao dịch test gửi được embed về Discord.
  • Nếu bật Store, /taokenhbanhang status không báo thiếu bot token hoặc channel.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Hỗ trợ

Trước khi báo lỗi, hãy dùng:

Code (Text):
/kora-admin status
Khi gửi lỗi, vui lòng cung cấp:

  • Version server
  • Java version
  • Provider đang dùng
  • Log lỗi liên quan
  • Các bước để tái hiện lỗi

GitHub Repository:
https://github.com/dduong19208/KoraPayments

Latest Release:
https://github.com/dduong19208/KoraPayments/releases/latest

KoraPayments
Giải pháp thanh toán hiện đại, tiện lợi và chuyên nghiệp cho máy chủ Minecraft.​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 15
First Release: Jun 4, 2026
Last Update: Jun 4, 2026
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings