AirdropPlugin - Advanced Minecraft Survival Enhancement
Overview
AirdropPlugin is a comprehensive Minecraft plugin that adds an immersive airdrop system to survival servers. The plugin creates dynamic, time-limited events where valuable loot drops from the sky, protected by hostile mobs and requiring strategic teamwork to claim.

Core Features
⚡ Airdrop System

• Automatic Drops: Configurable intervals (default: every 60 minutes)
• Dramatic Sequence:
  • Plane crash sound effects for all players
  • Falling block animations with particle effects
  • Dynamic chest drop with impact explosions
  • Night time effect during approach

War Zones

• Danger Areas: 35-block radius protection zones around airdrops
• Visual Boundaries: Animated particle borders with red dust effects
• Mob Containment: Advanced AI prevents mobs from leaving the zone
• Player Tracking: Real-time boss bar with distance and status information

Guardian Mobs

• Intelligent AI: Mobs patrol around airdrops and hunt players
• Scaling Difficulty: Mob count scales with online players (3-25 mobs)
• Enhanced Abilities: Custom names, improved stats, enchanted equipment
• Elite & Boss Variants: Special mobs with unique abilities and rewards

Hacking System

• Two-Phase Security: Players need both access codes AND hacking tools
• Interactive GUI: 20-number sequence puzzle with 2-minute time limit
• Dynamic Rewards: Codes and tools drop from different mobs
• Failure Consequences: Wrong attempts block the airdrop for 3 minutes

Dual Storage System

• Local File Storage: JSON-based data persistence with automatic backups
• MySQL Database: Professional database integration with connection pooling
• Live Migration: Switch between storage types without data loss
• Cache System: Optimized performance with intelligent caching

Advanced Visual Effects

• Hologram Support: Integration with DecentHolograms plugin
• Custom Particles: Unique effects for drops, explosions, and interactions
• 3D Sound Design: Directional audio with distance-based volume
• Boss Bars: Dynamic information display with real-time updates

Gameplay Flow

1. Announcement Phase (60 minutes before)
   
   • Global announcement with coordinates
   • Falling block preview animations
   • World time changes to night
2. Drop Sequence (10-second countdown)
   
   • Dramatic plane crash sound effects
   • Chest falls from 100 blocks height
   • Massive explosion on impact
   • War zone activation
3. Combat Phase
   
   • Guardian mobs spawn with AI behaviors
   • Players battle for access codes and tools
   • Real-time war zone tracking
   • Strategic mob hunting required
4. Hacking Phase
   
   • Interactive number sequence puzzle
   • 2-minute time pressure
   • Failed attempts block the airdrop
   • Success unlocks the chest
5. Reward & Cleanup
   
   • Valuable loot distribution
   • 10-second ender dragon death animation
   • Massive explosion finale
   • Automatic cleanup

️ Technical Features
Performance Optimized

• Asynchronous database operations
• Efficient particle and sound management
• Memory-conscious mob tracking
• Automatic cleanup systems

Developer Friendly

• Comprehensive debug modes
• Extensive logging system
• Modular architecture
• Event-driven design

Server Administration

• Complete admin GUI interface
• Real-time statistics monitoring
• Storage management tools
• Live configuration reloading

Customization Options
Configurable Systems

• Spawn intervals and lifetimes
• Mob types and difficulty scaling
• Loot tables and quantities
• Sound and visual effects
• Storage and backup settings

Multi-Language Support

• Complete message system
• Configurable text displays
• Color-coded feedback
• Admin and player interfaces

Integration & Compatibility
Plugin Dependencies

• Required: Spigot/Paper 1.20.1+
• Optional: DecentHolograms (enhanced visuals)
• Optional: PlaceholderAPI (advanced integration)

Database Support

• Local: File-based JSON storage
• MySQL: Professional database integration
• Backup: Automated backup systems
• Migration: Seamless data transfer

Server Impact
Resource Usage

• Lightweight core operations
• Configurable mob limits
• Efficient cleanup systems
• Memory optimization

Player Experience

• Engaging PvPvE gameplay
• Strategic cooperation requirements
• High-value rewards
• Immersive audiovisual experience

This plugin transforms regular survival gameplay into exciting, time-limited events that encourage player interaction, strategic thinking, and teamwork while maintaining server performance and stability.