💰 VaultPayday

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

Payday

🎯 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

Job Activity: Players perform jobs through JobsReborn
Payment Interception: VaultPayday catches payments instead of paying immediately
Balance Accumulation: Earnings build up in a "pending balance"
Time Tracking: Plugin tracks individual playtime across sessions
Payday Event: Every 60 minutes, the full balance is paid out
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

bStats

VaultPayday includes bStats integration with:

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

🛠️ Installation

Download VaultPayday from Modrinth
Install Vault and JobsReborn plugins
Place VaultPayday.jar in your plugins/ folder
Restart your server
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

VaultPayday