YuPay — Modern In-Game Payment/Donation Plugin for Minecraft 1.8.x-1.21.x

Overview

YuPay is a modern, feature-rich payment and donation plugin designed for Minecraft servers (compatible with 1.21.x). It seamlessly integrates WeChat Pay and Alipay, providing a complete sponsorship management system with versatile reward mechanisms.

✨ Core Features

Multiple Payment Gateways
- WeChat Pay: Full integration with WeChat Native Pay API.
- Alipay: Supports Face-to-Face Pay with both public key and certificate modes.
- Smart Routing: Configurable default payment method with automatic fallback.
Dual Economy Support
- Vault Compatibility: Works with all Vault-based economy plugins (Essentials, CMI, etc.).
- PlayerPoints: Native support for the PlayerPoints point system.
- Flexible Switching: Change economy systems via configuration files.
High-Performance Database
- Dual Database Support: SQLite (lightweight, no setup) & MySQL (multi-server sync).
- Connection Pool: Optimized with HikariCP for high performance.
- Smart Indexing: Automatically creates indexes for faster queries.
Smart Callback Server
- Unified Callback Endpoint: Single port handles all payment callbacks.
- Auto-Registration: Callback handlers are registered based on configuration.
- Thread-Safe: Callback processing runs off the main server thread.
Rich Command System
- Custom Aliases: Set easy-to-remember command aliases.
- Permission Management: Granular permission nodes for each command.
- Tab Completion: User-friendly argument suggestions.
- Multi-Language Messages: Fully customizable messages via config.
Multi-Layered Reward System
- Base Rewards: Execute commands upon successful payment.
- Tiered Instant Rewards: Trigger different rewards based on single payment amount.
- Cumulative Achievement Rewards: Permanent rewards for reaching total donation milestones (anti-duplication).
- Periodic Cumulative Rewards: Time-based cumulative donation rewards.
Comprehensive Statistics
- Personal Donation Query: Players can check their total donations in real time.
- Donation Leaderboard: Top 10 donor ranking.
- Server-Wide Stats: Admins can view total server donation amounts.
- Offline Player Support: Query donation history for offline players.
PlaceholderAPI Integration
- Real-Time Data: 20+ placeholders for chat, scoreboards, and more.
- Leaderboard Display: Placeholders to show top donors.
- Personal Ranking: Display a player's donation rank on the server.
Professional Security Design
- Signature Verification: Full signature validation for WeChat Pay and Alipay.
- Duplicate Payment Protection: Order status checks prevent duplicate rewards.
- Secure Communication: Supports HTTPS callbacks; certificate mode for enhanced security.
Excellent User Experience
- QR Code Display: Automatically generated payment QR codes; clickable links.
- Sound Feedback: Audio cues for payments and reward execution.
- Real-Time Feedback: Asynchronous order creation prevents player lag.
- Detailed Logging: Comprehensive logs for troubleshooting.
High Customizability
- Modular Configuration: Independent configs for payments, economy, database, etc.
- Flexible Rewards: Custom commands triggered by various conditions.
- Fully Customizable Messages: All messages editable with color code support.
- Table Prefix: Avoid database table conflicts with other plugins.
Developer Friendly
- Clean Architecture: Layered code structure for clarity.
- Extensible Design: Easy to add new payment methods or features.
- Detailed Comments: Well-commented code for easy customization.
- Robust Error Handling: Comprehensive exception handling and logging.
Easy Management
- Hot-Reload Support: Reload configs without restarting the server.
- Command Aliases: Multiple aliases for admin commands.
- Permission Groups: Logical permission grouping for easy management.
- Console Friendly: Detailed startup logs and status messages.
Performance Optimized
- Asynchronous Processing: Database ops, network calls, and callbacks run async.
- Connection Pooling: Efficient database connection reuse.
- Caching Mechanism: Reduces redundant database queries.
- Resource Cleanup: Automatically releases resources on plugin disable.
Multi-Scenario Ready
- Small Servers: SQLite + Vault + WeChat Pay for lightweight deployment.
- Medium Networks: MySQL + Vault + dual payment gateways.
- Large Networks: MySQL cluster + PlayerPoints + full feature set.
- Event Campaigns: Flexible reward system supports various promotions.

💰 Payment Flow

Player runs /pay <amount> [payment method] in-game.
Plugin asynchronously creates an order and saves it to the database.
Calls the payment API to generate a payment link/QR code.
QR code/link is sent to the player.
Player completes payment via WeChat or Alipay.
Payment platform sends a callback to the plugin server.
Plugin verifies the signature and processes the payment.
Rewards are delivered and order status is updated.

🎁 Reward Trigger Mechanism

Immediate Execution: Base rewards are executed right after payment.
Conditional Triggers: Rewards are triggered based on amount, cumulative total, time period, etc.
Anti-Duplication: Cumulative rewards track triggered tiers to prevent re-issuing.
Async Execution: Reward commands run asynchronously to avoid server lag.

📊 Data Management

Database Table Design

Payment Records (yupayments): Stores all payment orders (pending, completed, etc.), searchable by player, time, status.
Cumulative Tier Records (yu_total_levels): Tracks which cumulative reward tiers each player has already unlocked.

Statistics Features

Real-time personal donation totals and history.
Server-wide donation leaderboards.
Time-period-based cumulative statistics (e.g., this month, this year).
Real-time data display via PlaceholderAPI.

🚀 Deployment Advantages

Quick Setup: Drop into the plugins folder, configure payment parameters, set up the economy and rewards, and start.
Easy Maintenance: Hot-reload configs, detailed error logs, and easy troubleshooting.

💡 Ideal For

Server Owners: Needing a stable, reliable donation system.
Community Managers: Looking to incentivize players and boost engagement.
Event Organizers: Requiring flexible reward systems for campaigns.
Developers: Seeking to extend or integrate payment functionality.

📈 Business Value

For Servers

Increase Revenue: Streamlined payment process improves conversion.
Improve Retention: Reward systems encourage long-term player engagement.
Boost Activity: Leaderboards foster healthy competition.
Reduce Overhead: Automated management lowers operational costs.

For Players

Convenient Payments: Familiar QR code scanning.
Instant Rewards: Rewards delivered immediately after payment.
Transparent Progress: Real-time tracking of donations and rankings.
Clear Goals: Cumulative rewards provide long-term objectives.

🏆 Summary

YuPay is more than just a payment plugin—it's a complete sponsorship management and player motivation system. Whether you run a small server or a large network, YuPay delivers a professional, reliable, and feature-rich payment solution.

Key Advantages:

Stable & Reliable: Production-tested and carefully designed.
Feature-Complete: Covers the entire workflow from payment to rewards to stats.
Easy to Use: Detailed documentation and configuration examples.
Highly Extensible: Modular design supports customization.
Continuously Updated: Built with modern development practices for easy maintenance.

If you're looking for a professional, reliable, and powerful payment plugin for your Minecraft server, YuPay is the perfect choice!

Plugin Discussion & Support Group: QQ1080918424

YuPay

📖About YuPay