Advanced Payment System for Minecraft Servers​

Introduction​

Features​

• Modern GUI Interface: Beautiful payment confirmation GUIs with customizable designs
• Advanced Payment System: Send money with confirmation dialogs and sound effects
• Balance Top System: Real-time leaderboard with player heads and formatted amounts
• Transaction History: Complete payment history tracking with search functionality
• Security Features: Account pausing, payment toggles, and anti-fraud protection
• Performance Optimized: Lightweight design with async processing and caching
• Database Support: SQLite and MySQL database options
• Admin Tools: Comprehensive admin commands for account management
• Sound Effects: Customizable sound notifications for payments
• Multi-Platform: Compatible with Paper, Spigot, and Purpur servers
• Folia Support: Full compatibility with Folia server software

Installation​

Step 1: Download and Install​

1. Download the UltraPAY.jar file from BuiltByBit marketplace
2. Upload the .jar file to your server's plugins folder
3. Ensure Vault plugin is installed (required dependency)
4. Restart your server

Step 2: License Activation​

1. Purchase a license from BuiltByBit marketplace
2. Join our Discord server: https://discord.gg/shyamstudio
3. Get your license key from the Discord server
4. Add your license key to the config.yml file:

License: "YOUR-LICENSE-KEY-HERE"

• Save the config file and restart your server
• Check console for successful activation:

[UltraPAY] License verified successfully!
[UltraPAY] UltraPAY has been enabled!

Commands​

Player Commands​

Admin Commands​

Command Aliases​

• /balance → /bal
• /baltop → /btop
• /payhistory → /transaction
• /ultrapay → /upay

Permissions​

Player Permissions​

ultrapay.pay: true          # Allow sending payments
ultrapay.balance: true      # Allow checking balances
ultrapay.baltop: true       # Allow viewing baltop
ultrapay.toggle: true       # Allow toggling payments/GUI
ultrapay.history: true      # Allow viewing own payment history

Admin Permissions​

ultrapay.admin: op          # Full admin access
ultrapay.reload: op         # Reload configuration
ultrapay.pause: op          # Pause/unpause accounts
ultrapay.history.others: op # View other players' history

Configuration​

Main Configuration (config.yml)​

# License key from Discord server
License: "YOUR-LICENSE-KEY-HERE"

# Database settings
database:
  type: sqlite  # Options: sqlite, mysql
  # MySQL settings (only used if type is mysql)
  host: localhost
  port: 3306
  database: ultrapay
  username: root
  password: password

# Payment Confirmation GUI
payment_confirmation:
  enabled: true  # Enable/disable GUI confirmation

# Display options
display:
  use_chat: true
  use_action_bar: false
  use_formatted_amounts: true  # Format amounts (1k instead of 1000)

# Economy settings
minimum_payment: 0.01

# Sound effects
sounds:
  payment_success: "ENTITY_PLAYER_LEVELUP"
  payment_failed: "ENTITY_VILLAGER_NO"

# Baltop refresh interval (seconds)
REFRESH_BALTOP: 300

Message Configuration (messages.yml)​

• Payment success/failure messages
• Balance display messages
• Admin command responses
• Error messages
• GUI toggle messages

payment:
  sent: "%prefix%&#a8e6cf✓ &#ffffff𝐏𝐚𝐲𝐦𝐞𝐧𝐭 𝐒𝐞𝐧𝐭 &#34eb9b➤ &#ffffff$&#a8e6cf%amount% &#ffffff→ &#34eb9b%receiver%"

Features in Detail​

Payment System​

• Amount Formatting: Supports K, M, B, T suffixes (e.g., 1k = 1000)
• Confirmation GUI: Optional GUI confirmation for payments
• Sound Effects: Customizable success/failure sounds
• Anti-Self Payment: Prevents players from paying themselves
• Minimum Amount: Configurable minimum payment threshold

Balance Top (Baltop)​

• Real-time Updates: Automatic refresh every 5 minutes (configurable)
• Player Heads: Shows actual player skins in the GUI
• Pagination: Navigate through multiple pages of top players
• Player Position: Shows your current position in the leaderboard
• Refresh Button: Manual refresh option

Transaction History​

• Complete Tracking: Records all payments sent and received
• Search Function: Filter transactions by player name
• Pagination: Browse through transaction history
• Admin Access: Admins can view any player's history

Security Features​

• Account Pausing: Admins can temporarily suspend player accounts
• Payment Toggle: Players can disable receiving payments
• GUI Toggle: Players can disable confirmation GUI
• License Protection: Secure license verification system

Database Support​

SQLite (Default)​

• File-based: Stores data in plugins/UltraPAY/database.db
• No Setup Required: Works out of the box
• Lightweight: Perfect for small to medium servers

MySQL (Optional)​

database:
  type: mysql
  host: your-mysql-host
  port: 3306
  database: ultrapay_db
  username: your_username
  password: your_password

Compatibility​

Component	Compatibility
Minecraft Version	1.20.4 - 1.21.*
Server Software	Paper, Spigot, Purpur
Required Plugins	Vault
Optional Plugins	Essentials (overrides /pay command)
Folia Support	Full Support

Troubleshooting​

Common Issues​

• Ensure Vault is installed and enabled
• Check that you have the correct Minecraft version
• Verify license key is correctly set

• Check if player has sufficient funds
• Verify target player exists and has joined before
• Ensure accounts are not paused

• Check if GUI is enabled in config
• Verify player has correct permissions
• Try reloading the plugin

• For MySQL: Check connection details
• For SQLite: Ensure write permissions to plugin folder
• Check server logs for detailed error messages

Getting Help​

• Discord Server: https://discord.gg/shyamstudio
• Create a ticket for technical support
• Check documentation for common solutions

• Check server console for errors
• Verify all dependencies are installed
• Test with default configuration
• Provide server version and plugin version

Advanced Configuration​

Custom GUI Layouts​

• Item materials and names
• Lore text and formatting
• Slot positions
• Navigation buttons
• Color schemes

Performance Optimization​

• Async Processing: All database operations run asynchronously
• Caching System: Player data and baltop cached for performance
• Configurable Refresh: Adjust baltop refresh intervals
• Memory Management: Automatic cleanup of old cache entries

Integration with Other Plugins​

• Vault Economy: Full integration with any Vault-compatible economy plugin
• Essentials Override: Automatically replaces Essentials /pay command
• Permission Plugins: Works with any permission plugin (LuckPerms, etc.)