💰 VaultPayday

An SA:MP-inspired payday system that transforms your Minecraft server's economy

🎯 What is VaultPayday?

VaultPayday brings the beloved SA:MP payday system to Minecraft! Instead of instant job payments, players accumulate earnings that are paid out every 60 minutes of playtime, creating engaging progression and rewarding active participation.

⭐ Key Features

• 🕐 60-Minute Payday Cycles - Authentic SA:MP-inspired gameplay
• 💼 JobsReborn Integration - Seamless payment interception system
• 📊 Progress Tracking - Visual progress bars and status updates
• 🚀 High Performance - Supports 200-300 concurrent players
• 🔧 Zero Configuration - Works perfectly out of the box
• 🌍 Multi-World Support - Enable/disable per world
• 📱 PlaceholderAPI - 25+ custom placeholders
• 🛡️ VIP Multipliers - Permission-based earning bonuses

🎮 How It Works

1. Job Activity: Players perform jobs through JobsReborn
2. Payment Interception: VaultPayday catches payments instead of paying immediately
3. Balance Accumulation: Earnings build up in a "pending balance"
4. Time Tracking: Plugin tracks individual playtime across sessions
5. Payday Event: Every 60 minutes, the full balance is paid out
6. Cycle Reset: Process repeats, keeping players engaged

📋 Commands

Player Commands

• /payday - Check progress and pending balance

Admin Commands

• /vaultpayday reload - Reload configuration
• /vaultpayday reset <player> - Reset player's progress
• /vaultpayday settime <player> <minutes> - Set playtime
• /vaultpayday info <player> - View player details
• /vaultpayday stats - Server statistics

🛡️ Permissions & Multipliers

Basic Permissions

• vaultpayday.check - Use /payday command (default: true)
• vaultpayday.admin - Access admin commands (default: op)
• vaultpayday.bypass - Skip payday system (default: false)

VIP Multipliers

• vaultpayday.multiplier.vip - 1.5x earnings
• vaultpayday.multiplier.premium - 2.0x earnings
• vaultpayday.multiplier.elite - 2.5x earnings

📊 PlaceholderAPI Integration

25+ custom placeholders for scoreboards, holograms, and other plugins:

• %vaultpayday_time_remaining% - Minutes until next payday
• %vaultpayday_pending_balance% - Current pending balance
• %vaultpayday_progress_percentage% - Progress percentage
• %vaultpayday_progress_bar% - Visual progress bar
• %vaultpayday_status% - Current status
• And 20+ more advanced placeholders!

⚙️ Configuration

150+ configuration options including:

# Basic settings
payday_interval_minutes: 60

# Performance tuning
performance:
  time_update_interval: 60
  max_players_per_cycle: 50

# VIP system
multipliers:
  enabled: true
  permission_multipliers:
    vip: 1.5
    premium: 2.0

# Notifications
notifications:
  message_type: 'chat'  # chat, actionbar, title, disabled
  show_progress: true

# World restrictions
advanced:
  worlds:
    blacklisted_worlds: ['creative', 'lobby']

🚀 Performance

Built for enterprise-level performance:

• ✅ 200-300 concurrent players supported
• ✅ <1ms command response time
• ✅ <50MB memory usage at capacity
• ✅ Zero main thread blocking operations
• ✅ Asynchronous database operations
• ✅ Smart caching with automatic cleanup

🔌 Dependencies

Required

• Vault - Economy API integration
• JobsReborn - Job system integration

Optional

• PlaceholderAPI - For custom placeholders

📋 Compatibility

Platform	Version	Status
Paper	1.20.x - 1.21.x	✅ Fully Supported
Spigot	1.20.x - 1.21.x	✅ Fully Supported
Purpur	1.20.x - 1.21.x	✅ Compatible

Java Version: 21+ (Recommended)

📊 Live Statistics

VaultPayday includes bStats integration with:

• 📈 12 custom analytics charts
• 🔒 GDPR compliant & anonymous
• 📊 Performance metrics for optimization
• 📊 Real-time statistics updated automatically

🛠️ Installation

1. Download VaultPayday from Modrinth
2. Install Vault and JobsReborn plugins
3. Place VaultPayday.jar in your plugins/ folder
4. Restart your server
5. Done! Plugin works immediately with defaults

🎉 Why Choose VaultPayday?

• 🎯 Authentic SA:MP Experience - True to the original concept
• 🚀 Enterprise Performance - Handles hundreds of players
• 🔧 Zero Setup Required - Works out of the box
• 📚 Complete Documentation - Detailed guides and examples
• 💬 Active Support - Community and direct developer support
• 📈 Proven Track Record - Used by servers worldwide

🌟 Community

• Issues & Bug Reports: GitHub Issues
• Feature Requests: GitHub Discussions

---

Transform your server's economy and bring SA:MP nostalgia to Minecraft!

Made with ❤️ by devupdates