YuPay 1.2 → 1.2.1 Changelog

🎉 Overview

This update focuses on feature enhancements and user experience improvements. It introduces a no‑reward donation mode, global blacklist, dynamic PAPI placeholders, in‑game configuration changes, and numerous hardcoded message cleanups, making the plugin more maintainable and flexible.

---

✨ New Features

1. No‑Reward Donation Mode (-n / --no-reward)

• Players can donate without receiving any economy or command rewards by adding -n to the command, e.g., /pay 100 -n.
• Order identification: No‑reward orders have a FREE_ prefix in the order ID.
• Use case: Pure support for the server without affecting game economy.

2. Global Blacklist

• Use the keyword all to ban or unban all players at once.
• Commands:
  • /yupay ban all [reason] – disables donations for everyone.
  • /yupay unban all – removes the global ban.
• Use case: Quickly stop all donations in case of emergencies.

3. Dynamic PAPI Placeholders

• New placeholders:
  • %yupay_top_<rank>_name% and %yupay_top_<rank>_amount% – supports both new (top_1_name) and old (top1_name) formats.
  • %yupay_is_banned%
  • %yupay_total_orders%, %yupay_success_orders%
  • %yupay_orders_in_<time>%, %yupay_success_orders_in_<time>%, %yupay_amount_in_<time>%
  • Server‑wide equivalents: %yupay_server_total_orders%, %yupay_server_success_orders%, %yupay_server_orders_in_<time>%, %yupay_server_success_orders_in_<time>%, %yupay_server_amount_in_<time>%
• All time placeholders accept milliseconds as <time>.

4. Enhanced Dynamic Configuration Editing

• New configuration options economy.enabled and commands.enabled.
• /yupay set now supports:
  • economy-enabled true/false – toggle economy rewards.
  • commands-enabled true/false – toggle command rewards.
  • min-amount, max-amount, max-daily-amount – adjust amount limits on the fly.
• New /yupay config command to view current configuration (admin only).

5. Message System Cleanup

• All hardcoded text has been moved to messages.yml.
• New message keys added:
  • pay-success-no-reward – success message for no‑reward donations.
  • config-header, config-footer, config-line – config display interface.
  • set-invalid-boolean – error for invalid boolean input.
  • Updated ban-usage and unban-usage to include all.
  • Database‑related logs now use consistent db-* keys.

6. Database Enhancements

• New methods in PaymentDAO:
  • getOrderCountByUUID(), getOrderCountByUUIDInTime()
  • getServerOrderCount(), getServerOrderCountInTime(), getServerAmountInTime()

---

🔧 Optimizations & Improvements

Code Structure

• Unified QR code generation into QRCodeUtils.
• Merged MessageUtils methods into MessageManager.
• Streamlined no‑reward flag handling in PayCommand and YupayCommand.

Version Compatibility

• Config version upgraded to 5.
• Messages version upgraded to 5.
• Vault is now a soft dependency (removed from depend list).

Logging

• Database operations now use centralized message keys.
• Blacklist actions log detailed information.

---

🐛 Bug Fixes

• Fixed no‑reward mode still triggering economy and command rewards.
• Fixed map QR code display issues on some server versions.
• Fixed global ban not preventing players from donating.

---

📋 Configuration Changes

New config.yml Options

economy:
  # Whether economy rewards are enabled
  enabled: true

commands:
  # Whether command rewards are enabled
  enabled: true

New messages.yml Keys

pay-success-no-reward: "&a&l✅ &fDonation successful! You chose no-reward mode and received no bonuses."

config-header: "&6&m⎯⎯⎯&r &e&l⚙ YuPay Configuration &6&m⎯⎯⎯&r"
config-footer: "&6&m⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯&r"
config-line: "&e{key}&7: &f{value}"

set-invalid-boolean: "&cPlease enter true or false"

---

📖 Upgrade Guide

Automatic Update

1. Stop your server.
2. Replace the JAR with YuPay-1.2.1-SNAPSHOT.jar.
3. Start the server. The plugin will automatically update config files while preserving your custom values.
4. Check the console log for confirmation.

Manual Update (if automatic fails)

1. Back up your config.yml and messages.yml.
2. Delete the old config files.
3. Start the server to generate fresh configs.
4. Restore your custom settings manually from the backups.

---

💬 Support

For any questions or feedback, join our community:

QQ Group: 1080918424

---

Version: 1.2.1-SNAPSHOT
Release Date: March 20, 2026