{"id":173451,"date":"2026-06-10T01:47:08","date_gmt":"2026-06-09T22:47:08","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/"},"modified":"2026-06-10T01:47:08","modified_gmt":"2026-06-09T22:47:08","slug":"yupay","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/","title":{"rendered":"YuPay"},"content":{"rendered":"

# \ud83c\udfae YuPay \u2014\u2014 Make Sponsorship Management a Pleasure<\/p>\n

> **Minecraft server sponsorship has never been been this elegant.**
\n>
\n> Direct integration with WeChat Pay & Alipay, redeem code system, refund review, multi-language, full lifecycle event listening \u2014 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.<\/p>\n

—<\/p>\n

## \ud83d\udce6 What Is It<\/p>\n

**YuPay** is a free, modern payment plugin tailored for Minecraft servers. It breaks down the hassle of “sponsorship management” into four steps: **Initiate \u2192 Pay \u2192 Receive \u2192 Record**. Every step is automated, every step traceable.<\/p>\n

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 \u2014 no third-party relay, your funds stay secure in your own hands.<\/p>\n

> \u26a0\ufe0f This plugin is designed for scenarios where “players voluntarily sponsor server operations”. Please ensure usage complies with local laws and payment platform regulations.<\/p>\n

—<\/p>\n

## \u2728 Highlights at a Glance<\/p>\n

| Category | What You Get |
\n|———-|—————|
\n| \ud83d\udcb3 **Payment** | WeChat + Alipay dual channels, Native QR scan payment, automatic fallback |
\n| \ud83d\udcb0 **Economy** | Vault + PlayerPoints dual support, one-click switch |
\n| \ud83c\udf81 **Rewards** | Base rewards, single milestone, total achievements, limited-time sprints \u2014 four trigger layers |
\n| \ud83d\udd11 **Redeem Code** | Create\/redeem\/query\/modify, supports paid codes, complete logs |
\n| \ud83d\udcb5 **Refund** | Players can request refunds, admin approve\/deny, forced refund, partial refund |
\n| \ud83d\udcca **Data** | Leaderboards, order history, page browsing, one-click copy order ID |
\n| \ud83c\udf10 **Multi-language** | Default Chinese + English, server owners can customize any language, different players see different languages |
\n| \ud83d\udd0c **PAPI** | 40+ placeholders, use in scoreboards\/titles\/item lore |
\n| \ud83d\udee1\ufe0f **Security** | Signature verification, IP whitelist, 24h event monitoring, anti-duplicate delivery |
\n| \u26a1 **Performance** | Fully async, HikariCP connection pool, 600% startup speed boost |
\n| \ud83e\udde9 **Extensibility** | Full lifecycle event API for deep integration by developers |<\/p>\n

—<\/p>\n

## \ud83d\udd04 What a Complete Sponsorship Looks Like<\/p>\n

1. Player executes a command, e.g. `\/donate 50 wechat`
\n2. System creates order asynchronously, writes to database
\n3. Calls WeChat\/Alipay API to generate payment QR code
\n4. Depending on your config, sends **clickable link**, **text-art QR** in chat, or **map QR** in inventory
\n5. Player scans and completes payment
\n6. Payment platform calls back to your server
\n7. Plugin verifies signature, confirms receipt, grants rewards (economy + commands)
\n8. Leaderboard and placeholders update in real time
\n9. All logs written, traceable anytime<\/p>\n

Fully automated. You just configure the rewards, YuPay handles the rest.<\/p>\n

—<\/p>\n

## \ud83c\udf81 Four Reward Layers, Mix and Match<\/p>\n

YuPay’s reward system is like a Lego box \u2014 four trigger modes you can combine freely.<\/p>\n

| Layer | Trigger | Example |
\n|——-|———|———|
\n| **Base Reward** | Every successful payment | `give {player} diamond 1` |
\n| **Single Milestone** | Single payment reaches threshold | 50 yuan \u2192 5 gold blocks |
\n| **Total Achievement** | Lifetime total reaches new height | 500 yuan \u2192 SVIP permission group |
\n| **Limited Sprint** | Cumulative within specified time period | 200 yuan in 24h \u2192 enchanted golden apple |<\/p>\n

Each layer’s commands are fully customizable, support variables like `{player}`, `{amount}`, `{points}`, and can integrate with permission\/economy plugins like LuckPerms, CMI, etc.<\/p>\n

> \ud83d\udca1 Adding `-n` (e.g. `\/donate 10 -n`) makes it a **no-reward sponsorship** \u2014 pure server support, no rewards triggered.<\/p>\n

—<\/p>\n

## \ud83d\udd11 Redeem Code System: More Than Just a Voucher<\/p>\n

YuPay’s redeem code module goes far beyond typical “gift codes”:<\/p>\n

– **Free codes**: Players enter to claim \u2014 great for event giveaways
\n– **Paid activation codes**: Players must scan and pay a specified amount before redeeming \u2014 suitable for selling item entitlements, redeeming codes from other platforms, etc.
\n– **Economy rewards**: Automatically grant Vault currency or PlayerPoints upon redemption
\n– **Custom commands**: Each code can bind a set of commands executed on redemption
\n– **Usage limits & expiry**: Independent control per code
\n– **Code PAPI**: Placeholders directly read any code’s status, amount, remaining uses<\/p>\n

Create a paid activation code with a single command:
\n“`
\n\/yp code create –code VIP2026 –amount 50 –economy vault –eco-amount 5000 –commands “lp user {player} parent set vip” –max-uses 100 –expire 30d
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udcb5 Refund System: Bad Debt Terminator<\/p>\n

Refunds are no longer a nightmare. YuPay’s refund process is complete and reassuring:<\/p>\n

– **Players request refund**: Submit application with reason
\n– **Admin reviews**: Approve\/deny in an orderly manner
\n– **Forced refund**: Direct operation for urgent cases, no waiting for review
\n– **Partial refund**: Flexible handling, precise to the cent
\n– **Code refund**: Refund money and rollback usage count, status automatically restored
\n– **Refund callback**: Interfaces with WeChat\/Alipay official refund API, money returns to original payment method
\n– **Complete logs**: Who refunded, how much, when, why \u2014 all clear<\/p>\n

—<\/p>\n

## \ud83c\udf10 Thousand Players, Thousand Languages \u2014 No Language Fights<\/p>\n

A lifesaver for international server operators.<\/p>\n

– Comes with **Simplified Chinese** and **English** complete translations
\n– Server owners can add any language file in `language.mappings`
\n– Players switch preference with `\/yp lang `, stored in database, persists across sessions
\n– New players automatically **detect client language** and match the best translation
\n– Different players on the same server see different language prompts \u2014 truly per-player localization<\/p>\n

—<\/p>\n

## \ud83d\udd0c Complete PAPI Placeholder List<\/p>\n

YuPay provides **40+ built-in PlaceholderAPI placeholders**, covering personal, server, leaderboard, and redeem code dimensions. All monetary values keep two decimal places. Full list below:<\/p>\n

—<\/p>\n

### 1. Personal Dimension (requires player context)<\/p>\n

| Placeholder | Description | Example Return |
\n|————-|————-|—————-|
\n| `%yupay_is_banned%` | Whether the player is banned from sponsoring | `true` \/ `false` |
\n| `%yupay_total%` | Player’s lifetime total sponsorship (yuan) | `158.00` |
\n| `%yupay_total_orders%` | Player’s total orders (including failed) | `7` |
\n| `%yupay_success_orders%` | Player’s successful orders | `5` |
\n| `%yupay_rank%` | Player’s sponsorship rank (off-rank shows text from language file) | `3` or `Not ranked` |
\n| `%yupay_has_paid_in_

> \ud83d\udca1 **Dynamic parameters**: `

—<\/p>\n

### 2. Server Dimension (no player needed)<\/p>\n

| Placeholder | Description | Example Return |
\n|————-|————-|—————-|
\n| `%yupay_server_total%` | Server’s lifetime total sponsorship (yuan) | `12850.75` |
\n| `%yupay_server_total_orders%` | Server’s total orders (including failed) | `312` |
\n| `%yupay_server_success_orders%` | Server’s successful orders | `289` |
\n| `%yupay_server_orders_in_

—<\/p>\n

### 3. Leaderboard Dimension (no player needed)<\/p>\n

Two formats supported (first recommended):<\/p>\n

| Placeholder | Description | Example Return |
\n|————-|————-|—————-|
\n| `%yupay_top__name%` | Player name at rank N | `Steve` |
\n| `%yupay_top__amount%` | Total sponsorship at rank N (yuan) | `2000.00` |
\n| `%yupay_top_name%` | (legacy format) Same as above | `Alex` |
\n| `%yupay_top_amount%` | (legacy format) Same as above | `1500.00` |<\/p>\n

> `` ranges `1` ~ `10`. If rank doesn’t exist, name returns fallback text from language file (default “None”), amount returns `0.00`.<\/p>\n

—<\/p>\n

### 4. Redeem Code Dimension<\/p>\n

Includes global statistics (no player needed) and specific code attributes (where `redeemed` and `can_redeem` require player context).<\/p>\n

#### Global Statistics<\/p>\n

| Placeholder | Description | Example Return |
\n|————-|————-|—————-|
\n| `%yupay_code_total%` | Total number of codes | `25` |
\n| `%yupay_code_active%` | Number of active codes (status ACTIVE) | `18` |<\/p>\n

#### Specific Code Attributes \u2014 replace `` with actual code string (auto-uppercase)<\/p>\n

| Placeholder | Description | Example (code = `VIP2026`) |
\n|-------------|-------------|----------------------------|
\n| `%yupay_code__status%` | Current status of the code | `ACTIVE` |
\n| `%yupay_code__amount%` | Required payment amount (yuan) | `50.00` |
\n| `%yupay_code__economy_type%` | Economy reward type | `vault` |
\n| `%yupay_code__economy_amount%` | Economy reward amount | `5000.00` |
\n| `%yupay_code__used%` | Number of times redeemed | `23` |
\n| `%yupay_code__max_uses%` | Max redeem count (-1 = unlimited) | `100` |
\n| `%yupay_code__expire%` | Expiry timestamp (ms), -1 = never | `1798675199999` |
\n| `%yupay_code__expire_formatted%` | Formatted expiry time | `2026-12-31 23:59` |
\n| `%yupay_code__remark%` | Code remark | `\"VIP activation code\"` |
\n| `%yupay_code__locked%` | Whether locked by a payment (someone is paying) | `true` \/ `false` |
\n| `%yupay_code__redeemed%` | Whether **current player** has redeemed this code | `true` \/ `false` |
\n| `%yupay_code__can_redeem%` | Whether **current player** can redeem now (comprehensive check) | `true` \/ `false` |<\/p>\n

> \ud83d\udca1 `_can_redeem` checks: code status normal, not expired, uses left, not locked by others, and current player hasn't redeemed it.<\/p>\n

---<\/p>\n

### Usage Notes<\/p>\n

- **All monetary placeholders** are in `yuan`, with two decimal places, e.g. `99.50`. Integer amounts also show `.00`.
\n- Dynamic time parameter `

---<\/p>\n

## \ud83e\udde9 Gift for Developers<\/p>\n

If you can write plugins, these events will make your secondary development experience fly:<\/p>\n

| Event | Trigger | Modifiable Parameters |
\n|-------|---------|----------------------|
\n| `PrePaymentEvent` | Before payment | amount, payment method, order ID, cancel flag |
\n| `PaymentOrderCreatedEvent` | Order created successfully | read-only (has QR URL) |
\n| `PaymentCompletedEvent` | Payment success + rewards granted | read-only (full data) |
\n| `PaymentFailedEvent` | Payment failed \/ canceled | read-only |
\n| `RefundCompletedEvent` | Refund completed | read-only |
\n| `RedeemCodeRedeemedEvent` | Code redeemed | read-only |
\n| `RedeemCodeLifetimeEvent` | Code status changed | read-only (old \u2192 new state) |
\n| `PlayerPointsChangedEvent` | Economy changed | read-only |<\/p>\n

All events support sync. You can intercept before order creation, trigger\u8054\u52a8 other systems after payment, sync data on refund \u2014 every detail of the sponsorship lifecycle is observable.<\/p>\n

---<\/p>\n

## \ud83d\udee1\ufe0f Security Is Not Just Talk<\/p>\n

- **Signature verification**: WeChat\/Alipay callbacks are fully signature-verified against forgery
\n- **Anti-duplicate delivery**: Order status check + idempotent handling
\n- **IP whitelist**: Callback interface can restrict access to official payment platform IPs only
\n- **TLS\/HTTPS**: Supports certificate-encrypted communication
\n- **Event monitoring**: `\/yp audit` one-click audit, 24h monitoring of which plugins are listening to YuPay's fund events
\n- **Map virtual lock**: When a payment QR is placed in the inventory, the player is locked in place, cannot drop\/switch items, payment unlocks<\/p>\n

---<\/p>\n

## \u26a1 Blazing Fast Startup<\/p>\n

The rewritten dependency loading system means YuPay no longer requires cumbersome JVM startup parameters. All dependencies are automatically managed, verification speed increased by 600%, out-of-the-box. Drop it into the `plugins` folder, start the server, it's ready.<\/p>\n

---<\/p>\n

## \ud83d\udcca Data at Your Fingertips<\/p>\n

`\/yp history` is one of your most-used commands. Order history supports **page browsing**, click an order ID to **copy it with one click** \u2014 reconciliation efficiency doubled.<\/p>\n

`\/yp top` lets you know at any time who is contributing to the server \u2014 leaderboard data syncs with placeholders in real time.<\/p>\n

`\/yp total` for personal stats, `\/yp total all` for server-wide stats \u2014 all available at your fingertips.<\/p>\n

---<\/p>\n

## \ud83d\ude80 Two-Minute Quick Start Guide<\/p>\n

1. Drop `YuPay.jar` into the `plugins\/` folder
\n2. Start the server, wait for `config.yml` and `messages.yml` to generate
\n3. Open `config.yml`, fill in your WeChat\/Alipay parameters
\n4. Ensure the callback port (default `8080`) is open in your server firewall and security group
\n5. In-game, type `\/donate 0.01` to test a small payment
\n6. Confirm callback works and rewards arrive \u2014 start business \ud83c\udf89<\/p>\n

---<\/p>\n

## \ud83c\udfc6 Why Server Owners Are Using YuPay<\/p>\n

- \u2705 **Stable**: Production-tested, compatible with Spigot\/Paper 1.8 to latest versions
\n- \u2705 **Reliable**: Direct official API connection, no middlemen, money goes to your account directly
\n- \u2705 **Worry-free**: From payment to rewards fully automated, you just configure
\n- \u2705 **Flexible**: Reward logic fully programmable, command aliases freely definable
\n- \u2705 **Secure**: Signature verification + anti-duplicate + IP whitelist + event monitoring
\n- \u2705 **Transparent**: Every order, every refund, every code redemption has logs
\n- \u2705 **Evolving**: Actively maintained, continuously iterated, community-driven<\/p>\n

---<\/p>\n

> \ud83d\udcac **Plugin Discussion Group: 1080918424**
\n>
\n> For issues, feature requests, or just to chat \u2014 welcome. Every improvement of YuPay comes from feedback from server owners.<\/p>\n

> \ud83d\udc9b **Support the Author on AiFaDian**: https:\/\/ifdian.net\/item\/012b6c1c4a0911f18d1b52540025c377
\n>
\n> If YuPay has helped your server, consider buying the author a milk tea ~ Your support is the biggest motivation for the plugin's continued evolution.<\/p>\n

**Stop struggling with sponsorship management. Leave the professional stuff to YuPay, and focus on running your server well.**<\/p>\n

***<\/p>\n

# \ud83d\udcd6 YuPay Operation Manual<\/p>\n

## 1. Environment Requirements<\/p>\n

| Item | Requirement |
\n|------|-------------|
\n| Server | Spigot \/ Paper \/ compatible forks \/ compatible hybrid servers, 1.8 \u2013 1.26+ |
\n| Java | JDK 8 or higher |
\n| Optional dependencies | Vault (economy), PlayerPoints (points), PlaceholderAPI (placeholders), ProtocolLib (map lock) |<\/p>\n

> \ud83c\udf89 **Good news**: You no longer need to manually add JVM startup parameters for Java 9+. YuPay's latest version has built-in smart dependency management \u2014 out-of-the-box.<\/p>\n

## 2. Installation & Startup<\/p>\n

1. Download `YuPay.jar`, place it in the server's `plugins\/` directory
\n2. Start the server, the plugin will automatically generate `config.yml`, `messages.yml`, and SQLite database files
\n3. Edit `plugins\/YuPay\/config.yml`, fill in payment channel configuration parameters
\n4. Depending on your payment method, configure callback URLs in the payment platform backend:
\n - WeChat: `http(s):\/\/your-domain-or-ip:port\/pay\/wechat\/notify`
\n - Alipay: `http(s):\/\/your-domain-or-ip:port\/pay\/alipay\/notify`
\n5. Ensure the callback port (default `8080`) is open in firewall and security group
\n6. Execute `\/yupay reload` or type `reload` in console to apply configuration
\n7. In-game, type `\/donate 0.01` to test a small payment<\/p>\n

## 3. Configuration Quick Reference<\/p>\n

### 3.1 Core Payment Parameters<\/p>\n

| Path | Description | Example |
\n|------|-------------|---------|
\n| `pay.default-method` | Default payment method | `wechat` \/ `alipay` |
\n| `pay.min-amount` | Minimum amount per order (yuan) | `0.01` |
\n| `pay.max-amount` | Maximum amount per order (-1 = unlimited) | `500` |
\n| `pay.max-daily-amount` | Daily cumulative limit (-1 = unlimited) | `1000` |
\n| `pay.order-subject` | Order subject template | `Sponsorship-{player}-{amount}yuan` |<\/p>\n

### 3.2 WeChat Pay Parameters<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `wechat.enabled` | Enable (true\/false) |
\n| `wechat.mchid` | Merchant ID |
\n| `wechat.appid` | Official account \/ Mini Program AppID |
\n| `wechat.serial-no` | API certificate serial number |
\n| `wechat.private-key-path` | Merchant private key (relative to `pems\/` directory) |
\n| `wechat.public-key-path` | Platform public key (relative to `pems\/` directory) |
\n| `wechat.public-key-id` | Platform public key ID |
\n| `wechat.api-v3-key` | API v3 key (32 characters) |
\n| `wechat.notify-url` | Complete callback notification URL |<\/p>\n

### 3.3 Alipay Parameters<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `alipay.enabled` | Enable |
\n| `alipay.mode` | `public_key` or `cert` |
\n| `alipay.app-id` | App ID |
\n| `alipay.merchant-private-key` | Merchant private key (PKCS8, without headers\/footers) |
\n| `alipay.alipay-public-key` | Alipay public key (required for public_key mode) |
\n| `alipay.app-cert-path` | App public key certificate (cert mode) |
\n| `alipay.alipay-cert-path` | Alipay public key certificate (cert mode) |
\n| `alipay.alipay-root-cert-path` | Alipay root certificate (cert mode) |
\n| `alipay.notify-url` | Async notification URL |
\n| `alipay.return-url` | Sync return URL |<\/p>\n

### 3.4 Economy System<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `economy.enabled` | Enable economy rewards |
\n| `economy.type` | `vault` or `playerpoints` |
\n| `economy.rate` | 1 yuan = how many in-game currency\/points |<\/p>\n

### 3.5 QR Code Display<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `qrcode.default-output-mode` | `link` \/ `text` \/ `map` |
\n| `qrcode.text-qr-size` | Text mode QR side length (characters, default 12) |
\n| `qrcode.text-black-char` | Black pixel character (default `\u2588\u2588`) |
\n| `qrcode.api-url` | Image generation API for link mode |<\/p>\n

### 3.6 Callback Server<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `callback.port` | Listening port |
\n| `callback.host` | Bind address (`0.0.0.0` = all interfaces) |
\n| `callback.io-threads` | IO thread count |
\n| `callback.worker-threads` | Worker thread count |
\n| `callback.allowed-ips` | IP whitelist (CIDR format, empty = allow all) |
\n| `callback.access-log` | Enable access logging |<\/p>\n

### 3.7 Database<\/p>\n

| Path | Description |
\n|------|-------------|
\n| `database.type` | `sqlite` (standalone) or `mysql` (multi-server sync) |
\n| `database.mysql.*` | MySQL connection parameters |
\n| `database.connection-pool.*` | HikariCP connection pool parameters |
\n| `database.table-names.prefix` | Table prefix to avoid conflicts |
\n| `database.table-names.*` | Individual business table names (can be customized) |<\/p>\n

## 4. Complete Reward Configuration Guide<\/p>\n

### 4.1 Base Reward (on-success)<\/p>\n

Executed on every successful payment \u2014 suitable for \"base reward every sponsorship\".<\/p>\n

```yaml
\ncommands:
\n on-success:
\n - \"give {player} diamond 1\"
\n - \"effect give {player} minecraft:speed 30 1\"
\n```<\/p>\n

Available variables: `{player}` (player name), `{amount}` (amount), `{points}` (economy points earned)<\/p>\n

### 4.2 Single Milestone (on-single-achieved)<\/p>\n

Triggered when a single payment reaches a set amount. **Sort amounts from low to high**, multiple tiers allowed.<\/p>\n

```yaml
\ncommands:
\n on-single-achieved:
\n - amount: 50
\n commands:
\n - \"say {player} reached 50 yuan in a single sponsorship!\"
\n - \"give {player} minecraft:gold_block 5\"
\n - amount: 100
\n commands:
\n - \"give {player} minecraft:diamond_block 3\"
\n - \"lp user {player} parent set vip\"
\n```<\/p>\n

### 4.3 Total Achievement (on-total-achieved)<\/p>\n

Triggered when lifetime total reaches a new height. **Each tier triggers only once** \u2014 anti-duplicate mechanism built-in.<\/p>\n

```yaml
\ncommands:
\n on-total-achieved:
\n - total: 100
\n commands:
\n - \"lp user {player} parent set vip\"
\n - total: 1000
\n commands:
\n - \"lp user {player} parent set ultimate\"
\n - \"give {player} minecraft:beacon 1\"
\n```<\/p>\n

### 4.4 Limited Sprint Reward (on-recent-achieved)<\/p>\n

Triggered when cumulative amount within a specified time period (milliseconds) reaches the target. Great for holiday events, weekend leaderboard pushes, etc.<\/p>\n

```yaml
\ncommands:
\n on-recent-achieved:
\n - time: 86400000 # 24 hours
\n total: 200
\n commands:
\n - \"give {player} minecraft:enchanted_golden_apple 5\"
\n - time: 604800000 # 7 days
\n total: 500
\n commands:
\n - \"give {player} minecraft:elytra 1\"
\n```<\/p>\n

### 4.5 Refund Trigger Commands (on-refund)<\/p>\n

Executed after a successful refund \u2014 can be used to notify admins, log events.<\/p>\n

```yaml
\ncommands:
\n on-refund:
\n - \"say {player}'s order {order} has been refunded {amount} yuan\"
\n```<\/p>\n

## 5. Command System<\/p>\n

### 5.1 Player Commands<\/p>\n

| Command | Function | Default Aliases |
\n|---------|----------|----------------|
\n| `\/donate [payment] [output] [-n]` | Initiate sponsorship | `\/pay`, `\/zanzhu` |
\n| `\/ytop` | Sponsorship leaderboard Top10 | `\/paytop`, `\/yt` |
\n| `\/ytotal [player|all]` | Query total sponsorship | `\/paytotal`, `\/ytt` |
\n| `\/yp history [page]` | My sponsorship history | `\/yupay history` |
\n| `\/yp lang [language]` | Switch personal language preference | |
\n| `\/yp code redeem ` | Redeem a code | |
\n| `\/yp cancel` | Cancel current map payment | |<\/p>\n

> \ud83d\udca1 The `-n` flag means \"no-reward sponsorship\" \u2014 pure server support, no reward commands or economy items triggered.<\/p>\n

### 5.2 Admin Commands<\/p>\n

| Command | Function |
\n|---------|----------|
\n| `\/yp reload` | Hot reload configuration |
\n| `\/yp set

### 5.3 Key Permission Nodes<\/p>\n

| Permission Node | Operations |
\n|----------------|------------|
\n| `yupay.command.pay` | Initiate sponsorship |
\n| `yupay.command.top` | View leaderboard |
\n| `yupay.command.total` | Query total sponsorship |
\n| `yupay.command.history` | View order history |
\n| `yupay.reload` | Reload config |
\n| `yupay.ban` | Manage blacklist |
\n| `yupay.convert` | Currency conversion |
\n| `yupay.audit` | Event listener audit |
\n| `yupay.admin` | Includes all above admin permissions |<\/p>\n

## 6. Redeem Code System In-Depth<\/p>\n

### 6.1 Code Creation Command Details<\/p>\n

Code creation uses named parameters in `--param value` format, freely combinable:<\/p>\n

```bash
\n# Free welfare code (unlimited uses, never expires)
\n\/yp code create --code FREEGIFT --max-uses -1 --economy vault --eco-amount 100 --remark \"New player gift\"<\/p>\n

# Paid activation code (pay 50 yuan to redeem, 100 uses, expires after 30 days)
\n\/yp code create --code PREMIUM --amount 50 --economy vault --eco-amount 5000 --max-uses 100 --expire 30d --commands \"lp user {player} parent set vip\"<\/p>\n

# Command-only code (no economy, no payment)
\n\/yp code create --code WELCOME --commands \"give {player} diamond 5; say {player} Welcome back!\"
\n```<\/p>\n

**Parameter quick reference:**<\/p>\n

| Parameter | Description | Example |
\n|-----------|-------------|---------|
\n| `--code` | Code string (auto-uppercase) | `VIP2026` |
\n| `--amount` | Required payment amount (0 = free) | `50` |
\n| `--economy` | Economy type (vault \/ playerpoints \/ none) | `vault` |
\n| `--eco-amount` | Economy reward amount | `5000` |
\n| `--max-uses` | Max redeem count (-1 = unlimited) | `100` |
\n| `--expire` | Expiry time (`30d` \/ `24h` \/ `2026-12-31` \/ `never`) | `30d` |
\n| `--commands` | Commands to execute on redemption (semicolon-separated) | `\"cmd1; cmd2\"` |
\n| `--remark` | Remark description | `\"VIP activation code\"` |<\/p>\n

### 6.2 Code Status Explanation<\/p>\n

| Status | Meaning |
\n|--------|---------|
\n| `ACTIVE` | Usable |
\n| `DEPLETED` | Uses exhausted (automatic) |
\n| `EXPIRED` | Expired (automatic) |
\n| `DISABLED` | Manually disabled by admin |<\/p>\n

### 6.3 Code PAPI Placeholders<\/p>\n

Using code `VIP2026` as example:<\/p>\n

| Placeholder | Example Return |
\n|-------------|----------------|
\n| `%yupay_code_total%` | Total number of codes |
\n| `%yupay_code_active%` | Number of active codes |
\n| `%yupay_code_VIP2026_status%` | `ACTIVE` |
\n| `%yupay_code_VIP2026_amount%` | `50.00` |
\n| `%yupay_code_VIP2026_used%` | `23` |
\n| `%yupay_code_VIP2026_max_uses%` | `100` |
\n| `%yupay_code_VIP2026_expire_formatted%` | `2026-12-31 23:59` |
\n| `%yupay_code_VIP2026_can_redeem%` | `true` \/ `false` |
\n| `%yupay_code_VIP2026_locked%` | `true` \/ `false` |
\n| `%yupay_code_VIP2026_redeemed%` | Whether current player has redeemed |<\/p>\n

## 7. Refund System In-Depth<\/p>\n

### 7.1 Refund Method Comparison<\/p>\n

| Method | Command Example | Use Case |
\n|--------|-----------------|----------|
\n| Direct refund | `\/yp refund ORDER001 50` | Confirmed refund needed, quick processing |
\n| Forced refund | `\/yp refund ORDER001 50 -f` | Skip amount check, refund directly |
\n| Partial refund | `\/yp refund ORDER001 30` | Refund part of the amount |
\n| Approval workflow | `\/yp refund request ORDER001` \u2192 wait for approve | Scenarios requiring approval |
\n| Code refund | `\/yp refund -r ` | Refund code payment + restore usage count |<\/p>\n

### 7.2 Refund Approval Workflow<\/p>\n

1. Player or admin submits refund request: `\/yp refund request [amount]`
\n2. Admin views pending list: `\/yp refund pending`
\n3. Approve or reject: `\/yp refund approve ` \/ `reject`
\n4. Upon approval, actual refund automatically executes; upon rejection, requester is notified<\/p>\n

### 7.3 What Happens After Refund<\/p>\n

- Payment platform (WeChat\/Alipay) receives refund request, money returns to original payment method
\n- Plugin updates order refund status (`FULL_REFUND` \/ `PARTIAL_REFUND`)
\n- If code refund: code usage count -1, status restored to `ACTIVE`
\n- Executes commands configured in `commands.on-refund`
\n- Triggers `RefundCompletedEvent` for other plugins to react
\n- Complete refund logs written to database<\/p>\n

## 8. Multi-Language System<\/p>\n

### 8.1 Adding a Language<\/p>\n

Add under `language.mappings` node in `config.yml`:<\/p>\n

```yaml
\nlanguage:
\n mappings:
\n zh_cn:
\n file: \"messages.yml\"
\n aliases: [zh, cn, chinese]
\n client-locales: [\"zh_cn\", \"zh_*\"]
\n en:
\n file: \"messages_en.yml\"
\n aliases: [english, eng]
\n client-locales: [\"en_*\"]
\n ja:
\n file: \"messages_ja.yml\"
\n aliases: [japanese, jp]
\n client-locales: [\"ja_*\"]
\n```<\/p>\n

Then create `plugins\/YuPay\/messages_ja.yml`, translating based on `messages.yml`. Plugin will automatically fill in missing keys.<\/p>\n

### 8.2 Switching Language<\/p>\n

- Players switch manually: `\/yp lang en` (supports aliases, e.g. `english`)
\n- First join auto-detects client language and matches best translation
\n- Language preference stored in database, remembered across sessions<\/p>\n

## 9. Database Selection Guide<\/p>\n

| Server Scale | Recommended Type | Reason |
\n|--------------|------------------|--------|
\n| Single small server | SQLite | Zero configuration, out-of-the-box |
\n| Multi-server network | MySQL | Unified data, cross-server sync |
\n| Large network | MySQL + connection pool | High concurrency support, connection reuse |<\/p>\n

## 10. Troubleshooting Common Issues<\/p>\n

### Callback server fails to start
\n- Check if port is occupied
\n- Confirm firewall\/security group has opened the port
\n- Check console error logs<\/p>\n

### Payment successful but rewards not received
\n- Check order `status` in database \u2014 should be `SUCCESS`
\n- Confirm `economy.enabled` and `commands.enabled` are both `true`
\n- Check console for economy plugin load errors<\/p>\n

### Map QR code not showing
\n- Confirm ProtocolLib matching server version is installed
\n- Check if `qrcode.default-output-mode` is set to `map`
\n- If ProtocolLib missing, mode auto-falls back to `link`<\/p>\n

### WeChat Pay says public key file not found
\n- Check existence of `plugins\/YuPay\/pems\/` directory
\n- Confirm `wechat.public-key-path` is correct
\n- Go to WeChat Merchant Platform \u2192 API Security \u2192 API Certificates \u2192 download platform certificate<\/p>\n

### Configuration lost after plugin upgrade
\n- YuPay has built-in smart config upgrader \u2014 automatically backs up old file (`.bak` suffix) and merges new keys
\n- Manual backup before upgrade for extra peace of mind<\/p>\n

## 11. Database Tables<\/p>\n

| Table Name | Stored Content |
\n|------------|----------------|
\n| `yu_payments` | All payment orders, including refund status |
\n| `yu_total_levels` | Cumulative reward tier records |
\n| `yu_banned_players` | Sponsorship blacklist |
\n| `yu_player_lang` | Player language preferences |
\n| `yu_redeem_codes` | Redeem code master table |
\n| `yu_redeem_logs` | Redemption records |
\n| `yu_refund_logs` | Refund operation logs |
\n| `yu_refund_requests` | Refund review requests |<\/p>\n

## 12. Uninstallation Steps<\/p>\n

1. Execute `\/yp reload` (ensure in-memory config is flushed)
\n2. Stop the server
\n3. Delete `plugins\/YuPay.jar`
\n4. For complete removal, delete `plugins\/YuPay` folder (including database)<\/p>\n

---<\/p>\n

> \ud83d\udcac Plugin Discussion Group: **1080918424**
\n> Don't struggle alone \u2014 bring your logs and config screenshots to the group, the author and helpful server owners are there.<\/p>\n

> \ud83d\udc9b **Support the Author on AiFaDian**: https:\/\/ifdian.net\/item\/012b6c1c4a0911f18d1b52540025c377
\n>
\n> If YuPay has helped your server, consider buying the author a milk tea ~ Your support is the biggest motivation for the plugin's continued evolution.
\n```<\/p>\n","protected":false},"excerpt":{"rendered":"

YuPay is a modern, feature-rich payment and donation plugin designed for Minecraft servers (compatible with 1.8.x-1.26.x). It seamlessly integrates WeChat Pay and Alipay<\/p>\n","protected":false},"featured_media":173452,"template":"","meta":{"_minecraft_slug":"yupay","_minecraft_project_id":"ND76NcgJ","_minecraft_author":"vicuna","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":108,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yupay.zip","_minecraft_size_bytes":20116159,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-15T19:48:56.344344Z","_minecraft_date_created":"2026-02-09T23:45:44.054981Z","_minecraft_date_modified":"2026-05-12T05:42:11.301707Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yupay","_minecraft_icon_attachment_id":173452,"_minecraft_imported_at":"2026-06-09T22:47:08+00:00","_minecraft_import_hash":"16c99d5cfaeb5b282b45206dd10fe69b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,126,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-173451","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nYuPay - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"YuPay - Minecraft\" \/>\n<meta property=\"og:description\" content=\"YuPay is a modern, feature-rich payment and donation plugin designed for Minecraft servers (compatible with 1.8.x-1.26.x). It seamlessly integrates WeChat Pay and Alipay\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"19 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/\",\"name\":\"YuPay - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp\",\"datePublished\":\"2026-06-09T22:47:08+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/yupay\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"YuPay\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"YuPay - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/","og_locale":"en_US","og_type":"article","og_title":"YuPay - Minecraft","og_description":"YuPay is a modern, feature-rich payment and donation plugin designed for Minecraft servers (compatible with 1.8.x-1.26.x). It seamlessly integrates WeChat Pay and Alipay","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"19 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/","name":"YuPay - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp","datePublished":"2026-06-09T22:47:08+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/yupay\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/yupay-icon-37c8c1164f11c5b3fc0dc087aa372960d02d4bb6_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/yupay\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"YuPay"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/173451","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/173452"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=173451"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=173451"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=173451"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=173451"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}