YuPay

# 🎮 YuPay —— Make Sponsorship Management a Pleasure > **Minecraft server sponsorship has never been been this elegant.** > > Direct integration with WeChat Pay & Alipay, redeem code system, refund review, multi-language, full lifecycle event listening — everything you need, YuPay delivers it all at once. Free, no middlemen, no tricks. 100% of the revenue goes straight to your account. The only fees are those charged by Alipay and WeChat. --- ## 📦 What Is It **YuPay** is a free, modern payment plugin tailored for Minecraft servers. It breaks down the hassle of "sponsorship management" into four steps: **Initiate → Pay → Receive → Record**. Every step is automated, every step traceable. Server operators use it to collect sponsorships, players use it to scan and pay. Both sides enjoy a worry-free experience. Supports direct API integration with WeChat Pay and Alipay — no third-party relay, your funds stay secure in your own hands. > ⚠️ This plugin is designed for scenarios where "players voluntarily sponsor server operations". Please ensure usage complies with local laws and payment platform regulations. --- ## ✨ Highlights at a Glance | Category | What You Get | |----------|---------------| | 💳 **Payment** | WeChat + Alipay dual channels, Native QR scan payment, automatic fallback | | 💰 **Economy** | Vault + PlayerPoints dual support, one-click switch | | 🎁 **Rewards** | Base rewards, single milestone, total achievements, limited-time sprints — four trigger layers | | 🔑 **Redeem Code** | Create/redeem/query/modify, supports paid codes, complete logs | | 💵 **Refund** | Players can request refunds, admin approve/deny, forced refund, partial refund | | 📊 **Data** | Leaderboards, order history, page browsing, one-click copy order ID | | 🌐 **Multi-language** | Default Chinese + English, server owners can customize any language, different players see different languages | | 🔌 **PAPI** | 40+ placeholders, use in scoreboards/titles/item lore | | 🛡️ **Security** | Signature verification, IP whitelist, 24h event monitoring, anti-duplicate delivery | | ⚡ **Performance** | Fully async, HikariCP connection pool, 600% startup speed boost | | 🧩 **Extensibility** | Full lifecycle event API for deep integration by developers | | 📚 Wiki / DOC | (https://vicuna-main.github.io/YuPluginHub) | --- ## 🔄 What a Complete Sponsorship Looks Like 1. Player executes a command, e.g. `/donate 50 wechat` 2. System creates order asynchronously, writes to database 3. Calls WeChat/Alipay API to generate payment QR code 4. Depending on your config, sends **clickable link**, **text-art QR** in chat, or **map QR** in inventory 5. Player scans and completes payment 6. Payment platform calls back to your server 7. Plugin verifies signature, confirms receipt, grants rewards (economy + commands) 8. Leaderboard and placeholders update in real time 9. All logs written, traceable anytime Fully automated. You just configure the rewards, YuPay handles the rest. --- ## 🎁 Four Reward Layers, Mix and Match YuPay's reward system is like a Lego box — four trigger modes you can combine freely. | Layer | Trigger | Example | |-------|---------|---------| | **Base Reward** | Every successful payment | `give {player} diamond 1` | | **Single Milestone** | Single payment reaches threshold | 50 yuan → 5 gold blocks | | **Total Achievement** | Lifetime total reaches new height | 500 yuan → SVIP permission group | | **Limited Sprint** | Cumulative within specified time period | 200 yuan in 24h → enchanted golden apple | Each layer's commands are fully customizable, support variables like `{player}`, `{amount}`, `{points}`, and can integrate with permission/economy plugins like LuckPerms, CMI, etc. > 💡 Adding `-n` (e.g. `/donate 10 -n`) makes it a **no-reward sponsorship** — pure server support, no rewards triggered. --- ## 🔑 Redeem Code System: More Than Just a Voucher YuPay's redeem code module goes far beyond typical "gift codes": - **Free codes**: Players enter to claim — great for event giveaways - **Paid activation codes**: Players must scan and pay a specified amount before redeeming — suitable for selling item entitlements, redeeming codes from other platforms, etc. - **Economy rewards**: Automatically grant Vault currency or PlayerPoints upon redemption - **Custom commands**: Each code can bind a set of commands executed on redemption - **Usage limits & expiry**: Independent control per code - **Code PAPI**: Placeholders directly read any code's status, amount, remaining uses Create a paid activation code with a single command: ``` /yp code create --code VIP2026 --amount 50 --economy vault --eco-amount 5000 --commands "lp user {player} parent set vip" --max-uses 100 --expire 30d ``` --- ## 💵 Refund System: Bad Debt Terminator Refunds are no longer a nightmare. YuPay's refund process is complete and reassuring: - **Players request refund**: Submit application with reason - **Admin reviews**: Approve/deny in an or