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

1. 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.

2. 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.

3. 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.

4. 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.

5. 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.

6. 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.

7. 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.

8. 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.

9. 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.

10. 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.

11. 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.

12. 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.

13. 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.

14. 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.

15. 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

1. Player runs /pay <amount> [payment method] in-game.
2. Plugin asynchronously creates an order and saves it to the database.
3. Calls the payment API to generate a payment link/QR code.
4. QR code/link is sent to the player.
5. Player completes payment via WeChat or Alipay.
6. Payment platform sends a callback to the plugin server.
7. Plugin verifies the signature and processes the payment.
8. 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