? 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 仅在服务器管理员明确配置时才向第三方服务传输数据:
? 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:
? PayBot - Hệ Thống Nạp Tiền Dành Cho Server ?
⚠️ Lưu ý: PayBot đang ở giai đoạn thử nghiệm, vui lòng cân nhắc trước khi sử dụng! ⚠️
• ? Official Addon (PayBot++)
• ☕ SpigotMC
• ? Hangar
? Giới Thiệu (Overview)
PayBot là giải pháp toàn diện hỗ trợ máy chủ Minecraft tự động hóa quy trình nạp tiền và donate từ người chơi thông qua Chuyển khoản Ngân Hàng (VietQR SePay) và Thẻ cào điện thoại/game (TheSieuRe, GachThePro...).
Dự án được xây dựng với kiến trúc 100% Server-Side Multi-Loader, vận hành mượt mà trên tất cả các nền tảng server phổ biến hiện nay từ Minecraft 1.16.5 đến 1.21.11+ và các phiên bản Snapshot 26.x.
? Tính Năng Nổi Bật
?️ 1. Hoạt Động Hoàn Toàn Phía Server (100% Server-Side)
- Người chơi dùng Minecraft nguyên bản (Vanilla) hay bất cứ launcher nào (Lunar, Badlion, TLauncher, Prism...) đều vào server và nạp tiền được ngay.
- Người chơi không cần cài thêm mod hay resource pack, vào là trải nghiệm được luôn.
? 2. Chống Gian Lận & Giữ An Toàn Tuyệt Đối Cho Menu (GUI)
- Tự động bảo vệ các vật phẩm trong giao diện menu nạp tiền, chặn đứng mọi thao tác lấy trộm hay dupe đồ:
- ❌ Chặn kéo rê chuột, bấm chuột giữa hoặc dùng phím tắt Hotbar (1-9, F) để tráo đồ.
- ❌ Chặn phím vứt đồ (Q) và Shift + Click rút đồ từ menu về túi.
- ❌ Tự động đồng bộ ngay lập tức để người chơi không bị kẹt đồ ảo hay lợi dụng hack client.
? 3. Hỗ Trợ Đa Dạng Các Nền Tảng Server
- Chạy mượt mà trên: Paper, Purpur, Folia, Fabric, Quilt, Forge và NeoForge.
- (Lưu ý: Đối với hệ máy chủ Bukkit, PayBot tối ưu tốt nhất cho Paper, Purpur và Folia để đảm bảo hiệu năng và hỗ trợ đầy đủ các tính năng hiện đại).
- Từng bản cài đặt được tối ưu chuẩn xác cho phiên bản Minecraft tương ứng, giúp server vận hành nhẹ nhàng, ổn định.
?️ 4. Bản Đồ VietQR Tiện Lợi & Khóa Hiển Thị Chống Đè Địa Hình
- Tạo mã VietQR thanh toán rõ nét trực tiếp trên tấm Bản Đồ cầm tay, quét mã siêu nhanh bằng ứng dụng ngân hàng.
- Tích hợp tính năng khóa bản đồ thông minh: Giữ cố định hình ảnh QR, tuyệt đối không bị địa hình thế giới xung quanh quét đè làm mất nét mã.
⚡ 5. Linh Hoạt Vận Hành: Chạy Độc Lập Hoặc Kèm Discord Bot
- Chế độ Độc lập (Standalone): Tự động xử lý nạp ngân hàng qua SePay và cổng thẻ cào trực tiếp từ server. Cực kỳ đơn giản, không cần mở port mạng hay cấu hình firewall rườm rà.
- Chế độ Discord Bot: Kết nối với bot Discord để thông báo giao dịch vào kênh riêng, duyệt đơn tiện lợi và tự động trao quà khi người chơi vào lại game.
? 6. Màu Sắc Bắt Mắt & Giao Diện Thân Thiện
- Hỗ trợ đầy đủ các mã màu hiện đại: từ mã màu truyền thống
&, § cho tới mã màu Hex #RRGGBB và dải màu chuyển động Gradient cực đẹp.
- Hiển thị sắc nét, đồng bộ chuẩn chỉnh trên tất cả các phiên bản Minecraft.
? 7. Tối Ưu Hiệu Năng & Tương Thích Folia
- Tương thích hoàn toàn với cơ chế đa luồng của Folia/Canvas, xử lý nhẹ nhàng, không gây giật lag hay tụt TPS server.
? Lệnh & Quyền Hạn (Commands & Permissions)
Dành Cho Người Chơi (Mặc định có quyền)
| Lệnh |
Mô tả |
/napbank |
Mở GUI nạp tiền ngân hàng qua mã VietQR tự động |
/napthe |
Mở GUI nạp thẻ cào (chọn nhà mạng, mệnh giá, nhập mã & serial) |
/rewardclaim [confirm] |
Xem và nhận phần thưởng nạp tiền khi online trở lại |
/paybotplaceholder |
Mở bảng thống kê nạp tiền ingame (không bắt buộc cài 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. Thống Kê Ẩn Danh FastStats (FastStats Telemetry)
PayBot tích hợp giải pháp đo lường hiệu năng FastStats nhằm thu thập số liệu vận hành kỹ thuật ẩn danh phục vụ tối ưu hiệu năng:
- Dữ liệu thu thập: Thông tin môi trường máy chủ cơ bản (phiên bản Minecraft, loại server/loader, phiên bản Java, hệ điều hành).
- Cam kết bảo mật: Tuyệt đối không thu thập địa chỉ IP, tên tài khoản, lịch sử giao dịch hay bất kỳ thông tin cá nhân nào của người chơi và quản trị viên.
- Cách tắt (Opt-out):
- Paper / Folia / Purpur: Đặt
telemetry.enabled: false trong plugins/PayBot/config.yml hoặc plugins/faststats/config.properties.
- Fabric / Forge / NeoForge: Đặt
enabled=false trong config/faststats/config.properties.
?? PayBot - English Documentation
? Key Highlights
?️ 1. 100% Server-Side (No Client Mod Required)
- Players using pure Vanilla Minecraft or any launcher/client (Lunar, Badlion, TLauncher, Prism...) can join and top up immediately.
- No client-side mod or resource pack is needed.
? 2. Anti-Theft & GUI Item Dupe Protection
- Comprehensive inventory click and slot drag protection, blocking 100% of GUI theft or ghost item exploits:
- ❌ Blocks mouse drag, middle click (clone), and hotbar key swaps (1-9, F).
- ❌ Blocks drop key (Q) and shift-click quick move from menu interfaces.
- ❌ Automatically resynchronizes player inventory state immediately.
? 3. Broad Multi-Platform Support
- Runs seamlessly on: Paper, Purpur, Folia, Fabric, Quilt, Forge, and NeoForge.
- (Note: For Bukkit-family servers, Paper, Purpur, or Folia is recommended to take full advantage of modern multithreading and color rendering).
- Granular builds optimized per Minecraft release for lightweight and stable performance.
?️ 4. In-Game VietQR Handheld Map & Anti-Overwrite Map Lock
- Renders clear VietQR payment codes directly onto an in-game Minecraft Handheld Map, easily scannable via mobile banking apps.
- Built-in intelligent Map Lock: Permanently prevents surrounding world terrain from scanning and overwriting the QR image.
⚡ 5. Dual Operating Modes: Standalone or Discord Bot
- Standalone Mode: Connects directly to SePay and scratch card gateways from the Minecraft server. No open port or router firewall config needed.
- Discord Bot Mode: Centralized transaction management, Discord Webhook notifications, and safe offline reward distribution.
? 6. Rich Colors & Modern Design (Hex & Gradient)
- Full support for color formatting: traditional
& and §, Hex #RRGGBB, and smooth <gradient> effects.
- Symmetrical and clean typography across all Minecraft releases.
? 7. Folia & Thread-Safety Compliance
- Fully compliant with Folia's regional multithreading model, ensuring smooth TPS and zero server crashes.
? Commands & Permissions
Player Commands (Default for everyone)
| Command |
Description |
/napbank |
Opens the bank deposit GUI with an auto-generated VietQR map |
/napthe |
Opens the scratch card deposit GUI (telco, denomination, pin, serial) |
/rewardclaim [confirm] |
View and claim pending offline deposit rewards upon logging in |
/paybotplaceholder |
In-game deposit statistics panel (works even without PlaceholderAPI) |
Admin Commands (naptien.admin or OP)
| Command |
Description |
/paybot or /paybot setup |
Opens the Master Setup Hub GUI: configure SePay, Card gateways, Reward commands, Milestones, Database, Discord, Transaction manager & Simulation test |
/paybot reload |
Instantly reloads config.yml and milestones.yml from disk and applies changes to all live subsystems |
/topuplist all |
View and approve pending deposit orders (or use the visual Transaction Manager in /paybot) |
/testnapbank [amount] |
Simulate a successful bank deposit to verify rewards and effects |
/testnapthe [carrier] [denom] |
Simulate a successful card deposit to verify rewards and effects |
/sepaysetup |
Interactive SePay setup wizard (legacy fallback) |
/cardsetup |
Interactive scratch card setup wizard (legacy fallback) |
? Discord Bot (Optional Extended Automation)
The companion Discord Bot serves as an optional middleware layer between Minecraft and payment providers:
- Automatically forwards payment alerts and transaction receipts to dedicated Discord channels.
- Queues offline rewards if the server is temporarily offline and delivers them safely when reconnected.
? Data Disclosure & FastStats Telemetry
PayBot only transmits data to third-party services when explicitly configured by the server administrator:
- SePay: Banking / e-wallet transaction reconciliation (via API Token or Webhook).
- TheSieuRe / GachThePro: Scratch card processing.
- Discord Bot (Optional): Transaction notifications and offline delivery synchronization.
? FastStats Anonymous Telemetry
PayBot includes FastStats to collect non-identifiable technical performance metrics:
- Collected Data: Basic runtime environment metrics (Minecraft version, server software, Java runtime, OS).
- Privacy Assurance: No personal data, IP addresses, payment records, or player identities are ever tracked or stored.
- How to Opt-Out:
- Paper / Folia / Purpur: Set
telemetry.enabled: false in plugins/PayBot/config.yml or plugins/faststats/config.properties.
- Fabric / Forge / NeoForge: Set
enabled=false in config/faststats/config.properties.
? Liên Kết & Hỗ Trợ / Official Links
- Tác giả / Author:
TheRealShiroz
- Discord Community:
- Direct Contact:
- Modrinth Plugin:
- Modrinth Mod:
- SpigotMC:
- Hangar:
评论 0
登录后参与评分
还没有评论,来抢沙发吧