PayBot

模组

· 作者 TheRealShiroz

自动充值银行系统(VietQR)& 游戏内货币充值插件,适用于 Minecraft(Paper、Purpur、Folia、Fabric、Quilt、Forge、NeoForge)

0 本站下载 0 关注 更新于 2 周前

最新 7.0.2+paper · 26.3 · Folia / Paper

一键开服(送7天)

? PayBot - 专为服务器设计的充值系统 ?

⚠️ 注意:PayBot 目前处于测试阶段,使用前请慎重考虑!⚠️


• ? 官方插件 (PayBot++)

• ☕ SpigotMC

• ? Hangar


? 简介 (Overview)

PayBot 是一款全面的解决方案,支持 Minecraft 服务器通过 银行转账 (VietQR SePay) 和 游戏/手机充值卡 (TheSieuRe, GachThePro...) 自动化玩家充值和捐赠流程。

该项目采用 100% 服务端多加载器 架构构建,可在当前所有主流服务器平台上流畅运行,从 Minecraft 1.16.5 到 1.21.11+ 以及 Snapshot 26.x 版本均完美支持。


? 核心功能

?️ 1. 完全服务端运行 (100% Server-Side)

  • 无论玩家使用的是 原版 Minecraft (Vanilla) 还是任何启动器(Lunar, Badlion, TLauncher, Prism...),均可直接加入服务器并进行充值。
  • 玩家 无需安装额外的模组 或资源包,即插即用,开箱体验。

? 2. 防作弊与绝对安全的菜单 (GUI)

  • 自动保护充值界面中的物品,杜绝一切偷取或复制道具的操作:
    • ❌ 禁止拖拽、中键点击或使用快捷栏快捷键 (1-9, F) 进行物品交换。
    • ❌ 禁止丢弃物品键 (Q) 和 Shift + 点击将物品从菜单移出至背包。
    • ❌ 实时自动同步,防止玩家因虚拟物品卡顿或利用客户端漏洞获利。

? 3. 支持多种服务器平台

  • 在以下平台运行流畅:Paper, Purpur, Folia, Fabric, Quilt, Forge 和 NeoForge。
  • (注:对于 Bukkit 系服务器,PayBot 针对 Paper、Purpur 和 Folia 进行了最佳优化,以确保性能并完整支持现代功能)。
  • 每个安装版本均针对相应的 Minecraft 版本进行了精确优化,确保服务器运行轻盈稳定。

?️ 4. 便捷的 VietQR 地图显示与防地形遮挡锁定

  • 在手持地图上直接生成清晰的 VietQR 支付码,通过银行应用扫描极快。
  • 集成智能地图锁定功能:固定二维码图像,绝对避免被周围世界地形覆盖而导致二维码模糊不可扫。

⚡ 5. 灵活运行模式:独立运行或搭配 Discord Bot

  • 独立模式 (Standalone):自动处理通过 SePay 的银行充值及直接从服务器处理的充值卡网关。极其简单,无需开启网络端口 或配置繁琐的防火墙。
  • Discord Bot 模式:连接 Discord Bot 以便在专用频道通知交易,方便审核订单,并在玩家重新上线时自动发放奖励。

? 6. 引人注目的色彩与友好界面

  • 全面支持现代颜色代码:从传统的 &、§ 代码到 Hex 十六进制颜色代码 #RRGGBB 以及绚丽的渐变动画色彩。
  • 在所有 Minecraft 版本上均能清晰显示,同步标准统一。

? 7. 性能优化与 Folia 兼容

  • 完全兼容 Folia/Canvas 的多线程机制,处理轻量,不会导致服务器卡顿或 TPS 下降。

? 命令与权限 (Commands & Permissions)

面向玩家 (默认拥有权限)

命令 描述
/napbank 打开通过自动生成的 VietQR 码进行银行充值的 GUI
/napthe 打开充值卡 GUI(选择运营商、面额,输入卡号和序列号)
/rewardclaim [confirm] 查看并在在线时领取充值奖励
/paybotplaceholder 打开游戏内充值统计面板(非必须安装 PAPI)

dành cho Quản trị viên (naptien.admin hoặc OP)

Lệnh Mô tả
/paybot hoặc /paybot setup Mở Master Setup Hub GUI toàn diện: cấu hình SePay, Thẻ cào, Lệnh thưởng, Mốc nạp, CSDL, Discord, Quản lý đơn nạp & Giả lập test trực quan 100%
/paybot reload Nạp lại toàn bộ file config.yml và milestones.yml từ đĩa và áp dụng ngay lập tức tới tất cả subsystem
/topuplist all Xem danh sách và duyệt đơn hàng nạp tiền đang chờ (hoặc quản lý trực tiếp qua GUI /paybot)
/testnapbank [số_tiền] Giả lập nạp bank thành công để kiểm tra lệnh thưởng và hiệu ứng
/testnapthe [nhà_mạng] [mệnh_giá] Giả lập nạp thẻ cào thành công để test hệ thống
/sepaysetup Trình hướng dẫn setup SePay qua chat (legacy fallback)
/cardsetup Trình hướng dẫn cài đặt API gạch thẻ qua chat (legacy fallback)
/chinhsuamenhgianap GUI tùy biến lệnh thưởng theo từng mệnh giá (legacy fallback)


? Biến Thay Thế Trong Lệnh Thưởng (Supported Placeholders)

Khi cấu hình lệnh thưởng (Reward Commands) cho từng mệnh giá nạp (Bank / Thẻ Cào) hoặc Mốc Nạp (Milestones), PayBot hỗ trợ đầy đủ các biến thay thế trên TẤT CẢ các nền tảng (Paper, Folia, Purpur, Fabric, Forge, NeoForge):

Biến Thay Thế Ý Nghĩa / Ví Dụ Thay Thế Hỗ Trợ
%player_name% Tên người chơi nạp tiền (Chuẩn PlaceholderAPI) — VD: TheRealShiroz ✅ Toàn bộ nền tảng
%player% Tên người chơi nạp tiền (Chuẩn phổ biến) ✅ Toàn bộ nền tảng
[playername] Tên người chơi nạp tiền (Chuẩn PayBot gốc) ✅ Toàn bộ nền tảng
{player} Tên người chơi nạp tiền (Chuẩn Bot Discord) ✅ Toàn bộ nền tảng
{playername}, [player] Tên người chơi nạp tiền (Alias tương thích ngược) ✅ Toàn bộ nền tảng
%amount% Số tiền / Mệnh giá nạp — VD: 100000 ✅ Toàn bộ nền tảng
{amount}, [amount] Số tiền / Mệnh giá nạp (Chuẩn Bot / Plugin) ✅ Toàn bộ nền tảng

Ví dụ cấu hình lệnh: p give %player_name% 100
eco give {player} [amount]
broadcast &aNgười chơi &e%player% &ađã nạp &b%amount% VNĐ!
(Hỗ trợ nối nhiều lệnh trên 1 dòng cách nhau bằng dấu chấm phẩy ; hoặc ;;)


? PlaceholderAPI Hỗ Trợ

Hỗ trợ hiển thị trên Scoreboard, TAB, Chat, Hologram (Yêu cầu cài PlaceholderAPI trên server Bukkit/Paper).

  • %paybot_player_topup%: Tổng số tiền đã nạp của người chơi (đã định dạng dấu chấm).
  • %paybot_player_bank%: Tổng tiền nạp qua ngân hàng của người chơi.
  • %paybot_player_card%: Tổng tiền nạp qua thẻ cào của người chơi.
  • %paybot_total_topup%: Tổng doanh thu toàn server (Bank + Card).
  • %paybot_total_players%: Tổng số người chơi đã từng nạp tiền trên server.
  • %paybot_top1_name% .. %paybot_top10_name%: Tên người chơi Top 1 đến Top 10 nạp nhiều nhất.
  • %paybot_top1_amount% .. %paybot_top10_amount%: Số tiền nạp tương ứng của Top 1 đến Top 10.
  • %paybot_db_status%: Trạng thái kết nối CSDL (MySQL hoặc SQLite).

⚖️ Thỏa Thuận Người Dùng & Điều Khoản (User Agreement)

?? Thỏa Thuận Người Dùng (Tiếng Việt)

1. Quyền hạn của người dùng:

  • Bạn được phép tạo video, chụp ảnh màn hình và chia sẻ ở bất cứ đâu, với điều kiện ghi rõ nguồn và dẫn link về trang phát hành chính thức của PayBot.
  • Bạn được phép sử dụng PayBot làm dependency cho các plugin/mod khác khi có ghi công tác giả.
  • Tác giả ưu tiên cập nhật bản tiếng Việt đầy đủ nhất; đối với bản dịch tiếng Anh bạn có thể đối chiếu thêm để tránh thiếu sót.

2. Hành vi bị nghiêm cấm:

  • Tuyệt đối không phân phối lại, bán lại hoặc re-upload plugin/mod này lên bất kỳ nền tảng nào khi chưa được tác giả cho phép.
  • Không được dịch ngược (decompile) hoặc can thiệp mã nguồn với mục đích xấu hoặc xâm phạm bản quyền.

3. Cam kết từ tác giả:

  • Plugin/Mod/Bot không chứa backdoor, không có khả năng phá hoại (raid) server.
  • Hệ thống tuyệt đối không can thiệp, không tráo đổi mã QR hay thông tin tài khoản ngân hàng của chủ server; không có bất kỳ hành vi chiếm đoạt tiền nạp của người chơi.
  • Dữ liệu thu thập chỉ phục vụ mục đích kỹ thuật và đối soát giao dịch (tên người chơi, mệnh giá, mã thẻ cào, mã đơn hàng).

Cập nhật lần cuối: 18/09/2026 (Theo giờ Việt Nam).


?? User Agreement (English)

1. Permitted Uses:

  • You may create videos, capture screenshots, and share them anywhere, provided that you credit PayBot and link back to this official page.
  • You may use this project as a dependency for other plugins/mods with appropriate attribution.

2. Prohibited Uses:

  • Redistributing, reselling, or re-uploading this plugin/mod without explicit authorization is strictly prohibited.
  • Reverse engineering or decompiling for malicious purposes is forbidden.

3. Author Commitments:

  • The plugin/mod/bot contains no backdoors, malware, or server-damaging routines.
  • The author never alters your bank QR details or payment credentials for personal benefit; zero risk of payment redirection.
  • Data collected is limited strictly to transaction processing and fraud prevention.

Last updated: September 18, 2026.


? Công Khai Dữ Liệu Chia Sẻ & Quyền Riêng Tư (Data Disclosure & Privacy)

1. Dịch Vụ Thanh Toán Bên Thứ Ba

PayBot chỉ truyền dữ liệu tới các cổng thanh toán bên thứ ba khi admin server đã chủ động cấu hình:

  • SePay: Nhận thông tin đối soát giao dịch ngân hàng / ví điện tử (qua API Token hoặc Webhook).
  • TheSieuRe / GachThePro: Nhận thông tin thẻ cào (nhà mạng, mã thẻ, số serial, mệnh giá) để xử lý đổi thẻ.
  • Discord Bot (Tùy chọn): Nhận thông báo giao dịch để đồng bộ đơn hàng khi sử dụng tính năng liên kết Discord.

Không có bất kỳ dữ liệu nhạy cảm nào bị chia sẻ ra ngoài khi chưa cấu hình.

2. FastStats 匿名统计 (FastStats Telemetry)

PayBot 集成了 FastStats 性能度量解决方案,以收集匿名的技术运营数据,从而优化性能:

  • 收集的数据:基本的服务器环境信息(Minecraft 版本、服务器/加载器类型、Java 版本、操作系统)。
  • 安全承诺:绝不收集 IP 地址、账户名称、交易记录或任何玩家和管理员的个人信息。
  • 退出方式 (Opt-out):
    • Paper / Folia / Purpur:在 plugins/PayBot/config.yml 或 plugins/faststats/config.properties 中设置 telemetry.enabled: false。
    • Fabric / Forge / NeoForge:在 config/faststats/config.properties 中设置 enabled=false。

?? PayBot - 英文文档

? 核心亮点

?️ 1. 100% 服务端运行(无需客户端模组)

  • 使用纯 Vanilla Minecraft 或任何启动器/客户端(Lunar, Badlion, TLauncher, Prism...)的玩家即可加入并立即充值。
  • 不需要安装客户端模组或资源包。

? 2. 防盗窃与 GUI 物品重复保护

  • 全面的物品栏点击和槽位拖拽保护,完全阻止 100% 的 GUI 盗窃或幽灵物品漏洞利用:
    • ❌ 阻止鼠标拖拽、中键点击(克隆)以及快捷栏按键交换(1-9, F)。
    • ❌ 阻止丢弃键(Q)和从菜单界面进行 Shift+点击快速移动。
    • ❌ 自动立即同步玩家物品栏状态。

? 3. 广泛的跨平台支持

  • 无缝运行于:Paper, Purpur, Folia, Fabric, Quilt, Forge, 和 NeoForge。
  • (注:对于 Bukkit 家族服务器,推荐使用 Paper, Purpur 或 Folia 以充分利用现代多线程和颜色渲染功能)。
  • 针对每个 Minecraft 发行版进行了细粒度构建优化,以实现轻量级和稳定性能。

?️ 4. 游戏内 VietQR 手持地图与防覆盖地图锁定

  • 将清晰的 VietQR 支付代码直接渲染到游戏内的 Minecraft 手持地图上,可通过手机银行应用轻松扫描。
  • 内置智能 地图锁定:永久防止周围世界地形扫描并覆盖二维码图像。

⚡ 5. 双操作模式:独立运行或 Discord Bot

  • 独立模式 (Standalone Mode):直接从 Minecraft 服务器连接到 SePay 和刮刮卡网关。无需开放端口或配置路由器防火墙。
  • Discord Bot 模式:集中式交易管理、Discord Webhook 通知以及安全的离线奖励分发。

? 6. 丰富的色彩与现代设计(Hex 与渐变)

  • 全面支持颜色格式化:传统的 & 和 §,Hex #RRGGBB,以及平滑的 <gradient> 效果。
  • 在所有 Minecraft 版本中保持对称且清晰的排版。

? 7. Folia 兼容性与线程安全

  • 完全符合 Folia 的区域多线程模型,确保 TPS 流畅且零服务器崩溃。

? 命令与权限

玩家命令(默认所有人可用)

命令 描述
/napbank 打开带有自动生成 VietQR 地图的银行存款 GUI
/napthe 打开刮刮卡存款 GUI(电信运营商、面额、PIN 码、序列号)
/rewardclaim [confirm] 登录后查看并领取待处理的离线存款奖励
/paybotplaceholder 游戏内存款统计面板(即使没有 PlaceholderAPI 也能工作)

管理员命令 (naptien.admin 或 OP)

命令 描述
/paybot 或 /paybot setup 打开 主设置中心 GUI:配置 SePay、卡网关、奖励命令、里程碑、数据库、Discord、交易管理器及模拟测试
/paybot reload 即时从磁盘重新加载 config.yml 和 milestones.yml 并将更改应用到所有实时子系统
/topuplist all 查看并批准待处理的存款订单(或使用 /paybot 中的可视化交易管理器)
/testnapbank [amount] 模拟成功的银行存款以验证奖励和效果
/testnapthe [carrier] [denom] 模拟成功的卡片存款以验证奖励和效果
/sepaysetup 交互式 SePay 设置向导(遗留备用方案)
/cardsetup 交互式刮刮卡设置向导(遗留备用方案)

? Discord Bot(可选扩展自动化)

配套的 Discord Bot 作为 Minecraft 和支付提供商之间的可选中间件层:

  • 自动将支付警报和交易收据转发到专用的 Discord 频道。
  • 如果服务器暂时离线,则排队离线奖励并在重新连接时安全交付。

? 数据披露与 FastStats 遥测

PayBot 仅在服务器管理员明确配置时才向第三方服务传输数据:

  • SePay:银行/电子钱包交易对账(通过 API Token 或 Webhook)。
  • TheSieuRe / GachThePro:刮刮卡处理。
  • Discord Bot(可选):交易通知和离线交付同步。

? FastStats 匿名遥测

PayBot 包含 FastStats 以收集不可识别的技术性能指标:

  • 收集的数据:基本运行时环境指标(Minecraft 版本、服务器软件、Java 运行时、操作系统)。
  • 隐私保证:从不追踪或存储任何个人数据、IP 地址、支付记录或玩家身份。
  • 如何退出 (Opt-Out):
    • Paper / Folia / Purpur:在 plugins/PayBot/config.yml 或 plugins/faststats/config.properties 中设置 telemetry.enabled: false。
    • Fabric / Forge / NeoForge:在 config/faststats/config.properties 中设置 enabled=false。

? 链接与支持 / Official Links

  • 作者 / Author: TheRealShiroz
  • Discord 社区:
  • 直接联系:
  • Modrinth 插件:
  • Modrinth 模组:
  • SpigotMC:
  • Hangar:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源