☢️ NuclearZone - Complete Plugin Guide

🌟 Overview

NuclearZone is the most advanced radiation simulation plugin for Minecraft Paper 1.21+ servers. It transforms ordinary Minecraft worlds into immersive post-apocalyptic environments where players must navigate dangerous radioactive zones using strategy, preparation, and protective equipment.

Unlike simple damage plugins, NuclearZone creates a complete ecosystem of radiation exposure, protection systems, and atmospheric effects that challenge players while maintaining fun and balanced gameplay.

🎯 Core Features

🔬 Realistic Radiation System

• Gradual Accumulation: Radiation builds up over time (8.0 per tick), not instantly
• Slow Recovery: Radiation decreases slowly when outside zones (0.5 per tick)
• Critical Threshold: Damage only occurs at 100% radiation level
• Lethal Consequences: Players can die from radiation poisoning (3.5 HP/second)
• Scientific Accuracy: Based on real-world radiation exposure principles

🛡️ Complete Protection System

• Radiation Armor: Full diamond armor sets provide 100% protection
• Custom Armor: Create unique protection gear through configuration
• Anti-Radiation Items: 5 consumable items that reduce radiation levels:
  • Vodka: Reduces 25% radiation
  • Anti-Rad Pills: Reduces 50% radiation
  • Rad-Away Water: Reduces 10% radiation
  • Potassium Iodide: Reduces 75% radiation
  • Full Cleanse: Removes 100% radiation
• 3D Model Support: Custom model data for unique visual designs

🎨 Stunning Visual Effects

• Modern Particles: Utilizes Minecraft 1.21+ particle systems
• SPORE_BLOSSOM_AIR: Green floating particles for radiation atmosphere
• ELECTRIC_SPARK: Electrical discharge effects for danger
• ASH & WHITE_ASH: Radioactive fog and atmospheric haze
• SOUL_FIRE_FLAME: Zone boundary markers with green fire
• Performance Optimized: Maximum 15 particles per zone for lag-free experience

🔊 Fully Customizable Audio

• Complete Sound Control: Replace any sound with your preferences
• 5 Themed Sound Packs: Horror, Sci-Fi, Zombie, Inferno, Underwater
• Dynamic Audio Levels: Different sounds for various radiation stages
• Volume & Pitch Control: Fine-tune every audio aspect
• Critical Health Alerts: Special sounds when health drops below 2 HP

🎮 Gameplay Mechanics

🌍 Zone Management

• Flexible Creation: Zones from 1 to 1000 block radius
• Multiple Zones: Support up to 50 simultaneous radiation zones
• Easy Administration: Simple commands for creation and removal
• Visual Boundaries: Clear particle effects mark danger areas
• Performance Monitoring: Automatic optimization based on server TPS

⚡ Radiation Effects

1. Zone Entry: Player enters radiation zone without protection
2. Accumulation: Radiation builds at 8.0% per second (configurable)
3. Visual Feedback: Particle effects and status messages
4. Critical Level: At 100% radiation, damage begins
5. Lethal Damage: 3.5 HP per second until death or escape
6. Recovery: Slow healing at 0.5% per second outside zones

🎯 Strategic Gameplay

• Preparation Required: Players must plan before entering zones
• Resource Management: Protection gear becomes valuable
• Risk vs Reward: High-danger zones for valuable resources
• Team Cooperation: Group exploration with shared protection
• Emergency Items: Anti-radiation consumables for emergencies

🌐 Multi-Language Support

NuclearZone supports 10 complete languages:

• 🇺🇸 English - Full documentation and interface
• 🇷🇺 Russian - Полная поддержка русского языка
• 🇨🇳 Chinese - 完整的中文支持
• 🇩🇪 German - Vollständige deutsche Unterstützung
• 🇫🇷 French - Support complet en français
• 🇪🇸 Spanish - Soporte completo en español
• 🇮🇹 Italian - Supporto completo in italiano
• 🇵🇹 Portuguese - Suporte completo em português
• 🇧🇾 Belarusian - Поўная падтрымка беларускай мовы
• 🇰🇿 Kazakh - Қазақ тілінің толық қолдауы

Each language includes complete message translations, command descriptions, and detailed parameter explanations.

🎛️ Commands & Permissions

📋 Player Commands

🔧 Admin Commands

🔐 Permission Hierarchy

• nuclearzone.player - Basic player permissions
• nuclearzone.vip - VIP status with additional features
• nuclearzone.moderator - Moderator tools and commands
• nuclearzone.admin - Full administrative access
• nuclearzone.* - Wildcard for all permissions

⚙️ Configuration System

📊 100+ Configuration Options

Radiation Settings

radiation:
  damage-per-second: 3.5        # Damage at 100% radiation (1.75 hearts)
  accumulation-rate: 8.0        # Fast radiation buildup
  recovery-rate: 0.5            # Slow radiation recovery
  max-level: 100                # Maximum radiation level
  check-interval: 20            # Check frequency (ticks)

Visual Effects

radiation:
  particle-interval: 5          # Particle update frequency
  particle-intensity: 0.8       # Particle density (performance-friendly)
  radiation-fog-enabled: true   # Atmospheric fog effects
  glow-enabled: true           # Zone boundary particles

Sound System

sounds:
  enabled: true                 # Master sound toggle
  radiation-damage:
    hurt-sound: "ENTITY_PLAYER_HURT"
    hurt-volume: 1.5
    hurt-pitch: 0.6
  critical-health:
    death-sound: "ENTITY_PLAYER_DEATH"
    beacon-sound: "BLOCK_BEACON_DEACTIVATE"

Performance Settings

performance:
  min-tps: 15.0                # Minimum TPS for operation
  max-zones: 50                # Maximum radiation zones
  cleanup-interval: 5          # Offline player cleanup (minutes)

🔗 Integration Features

🔐 LuckPerms Integration

Complete permission system with pre-configured roles:

# Player permissions
/lp group player permission set nuclearzone.help true
/lp group player permission set nuclearzone.status true

# Admin permissions  
/lp group admin permission set nuclearzone.* true

📊 PlaceholderAPI Support

Use these placeholders in TAB lists, scoreboards, and other plugins:

• %nuclearzone_level% - Player's radiation percentage
• %nuclearzone_status% - Radiation status (Safe, Low, Medium, High, Critical)
• %nuclearzone_in_zone% - Whether player is in radiation zone
• %nuclearzone_has_protection% - Whether player has protection armor

🎨 Resource Pack Compatibility

• Custom Models: Support for 3D armor and item models
• Texture Integration: Works with custom texture packs
• Model Data: Custom model data for unique appearances
• Visual Enhancement: Seamless integration with visual modifications

🚀 Performance & Optimization

⚡ Optimized Systems

• Efficient Particles: Reduced from 100+ to maximum 15 particles per zone
• Smart Scaling: Particle count adjusts based on zone size and server load
• TPS Protection: Automatic performance adjustments when TPS drops
• Memory Management: Intelligent cleanup of offline player data
• Modern APIs: Built with Paper 1.21+ optimizations

📈 Scalability Features

• Large Servers: Tested for high-player-count environments
• Multiple Worlds: Support radiation zones across different worlds
• Concurrent Zones: Handle dozens of active zones simultaneously
• Resource Efficiency: Minimal impact on server performance

🎯 Server Use Cases

🏰 Survival Servers

• Enhanced Challenge: Realistic environmental hazards
• Strategic Exploration: Players must prepare before venturing
• Resource Scarcity: Protection gear becomes valuable commodity
• Team Dynamics: Encourage cooperation and mutual protection

🎭 Roleplay Servers

• Post-Apocalyptic Scenarios: Authentic wasteland experiences
• Story Integration: Radiation zones as narrative elements
• Character Development: Survival skills as character traits
• Immersive Atmosphere: Realistic environmental dangers

🗺️ Adventure Maps

• Progressive Challenges: Increasing radiation levels as obstacles
• Equipment Gates: Require specific gear to access areas
• Puzzle Elements: Radiation zones as problems to solve
• Atmospheric Design: Create tension in exploration

⚔️ PvP Servers

• Strategic Zones: High-risk, high-reward combat areas
• Equipment Advantage: Protection gear provides tactical benefits
• Area Control: Use radiation to deny territory access
• Dynamic Battlefields: Changing danger zones affect combat

🛠️ Installation & Setup

📦 Quick Installation

1. Download NuclearZone-1.0.0.jar
2. Place in your server's plugins/ folder
3. Restart your server
4. Configuration files generate automatically
5. Ready to create your first zone!

🎮 First Steps

# Create your first radiation zone (20 block radius)
/nuclearzone set 20

# Give yourself protection armor
/nuclearzone armor

# Check your radiation status
/nuclearzone status

# View all available commands
/nuclearzone help

🔧 Basic Configuration

Edit plugins/NuclearZone/config.yml:

# Make radiation more/less dangerous
radiation:
  damage-per-second: 3.5      # Adjust damage amount
  accumulation-rate: 8.0      # Adjust buildup speed
  
# Customize visual effects
radiation:
  particle-intensity: 0.8     # Adjust particle density
  radiation-fog-enabled: true # Enable/disable fog

🎵 Sound Customization

🔊 Complete Audio Control

NuclearZone provides unprecedented control over audio effects:

Default Sound Configuration

sounds:
  radiation-damage:
    hurt-sound: "ENTITY_PLAYER_HURT"     # Pain sound
    fire-sound: "BLOCK_FIRE_AMBIENT"     # Radiation crackling
    wither-sound: "ENTITY_WITHER_HURT"   # Ominous effect
  critical-health:
    death-sound: "ENTITY_PLAYER_DEATH"   # Near-death warning
    beacon-sound: "BLOCK_BEACON_DEACTIVATE" # System failure

🎨 Themed Sound Packs

🧟 Zombie Apocalypse Theme

hurt-sound: "ENTITY_ZOMBIE_HURT"
fire-sound: "ENTITY_ZOMBIE_AMBIENT"
wither-sound: "ENTITY_ZOMBIE_VILLAGER_AMBIENT"

👻 Horror Theme

hurt-sound: "ENTITY_PHANTOM_HURT"
fire-sound: "ENTITY_SOUL_FIRE_AMBIENT"
wither-sound: "ENTITY_ENDERMAN_SCREAM"

🔥 Inferno Theme

hurt-sound: "ENTITY_BLAZE_HURT"
fire-sound: "ENTITY_BLAZE_AMBIENT"
wither-sound: "ENTITY_BLAZE_SHOOT"

🎛️ Volume & Pitch Control

• Volume Range: 0.0 (silent) to 2.0 (very loud)
• Pitch Range: 0.0 (very deep) to 2.0 (very high)
• Real-time Changes: Use /nuclearzone reload to apply instantly

📊 Technical Specifications

💻 System Requirements

• Minecraft Version: 1.21+ (Paper/Spigot/Bukkit)
• Java Version: 21+
• Server RAM: Minimum 1GB (2GB+ recommended)
• Dependencies: None required (PlaceholderAPI optional)

🔧 Development Features

• Modern APIs: Built with Paper 1.21+ optimizations
• Clean Code: Professional development standards
• Error Handling: Comprehensive exception management
• Documentation: Extensive JavaDoc comments
• Modular Design: Easy to maintain and extend

📈 Performance Metrics

• JAR Size: ~45KB (lightweight)
• Memory Usage: <10MB typical usage
• CPU Impact: <1% on modern servers
• Network Traffic: Minimal (client-side particles)
• Storage: <1MB for configuration and data

🏆 Why Choose NuclearZone?

✅ Professional Quality

• Enterprise-Grade Code: Built to professional development standards
• Extensive Testing: Thoroughly tested across multiple environments
• Active Development: Regular updates and improvements
• Long-term Support: Committed to ongoing maintenance

✅ Complete Solution

• All-in-One Package: Everything needed for radiation gameplay
• Zero Dependencies: Works independently without required plugins
• Easy Configuration: Sensible defaults with extensive customization
• Comprehensive Documentation: Detailed guides and examples

✅ Performance First

• Optimized Systems: Designed for high-performance environments
• Smart Resource Management: Efficient memory and CPU usage
• Scalable Architecture: Handles large servers and multiple zones
• Modern Technology: Built with latest Minecraft APIs

✅ Community Ready

• Multi-Language Support: 10 complete language translations
• Permission Integration: Full LuckPerms compatibility
• Plugin Compatibility: Works with popular server plugins
• Server Flexibility: Adapts to any server style or theme

🔮 Future Development Roadmap

🎯 Planned Features

• Advanced Zone Types: Different radiation types with unique effects
• Geiger Counter Items: Handheld radiation detection tools
• Contamination Spread: Dynamic zone expansion and contraction
• Weather Integration: Radiation affected by weather conditions
• Economy Integration: Radiation cleanup services and protection trading

🚀 Version 2.0 Goals

• GUI Management: Visual interface for zone management
• Advanced Particles: Custom particle effects and animations
• Radiation Sources: Placeable radiation emitters
• Decontamination: Tools and processes to clean radiation
• Mobile Zones: Moving radiation clouds and storms

📚 Support & Documentation

📖 Included Documentation

• Installation Guide: Step-by-step setup instructions
• Configuration Manual: Detailed explanation of all settings
• Command Reference: Complete list of commands and permissions
• Sound Examples: 50+ sound alternatives with themed packs
• Troubleshooting: Common issues and solutions

🆘 Getting Help

• Configuration Issues: Check the detailed config comments
• Permission Problems: Review the LuckPerms integration guide
• Performance Concerns: Adjust particle settings and zone limits
• Sound Problems: Use the sound testing guide and examples

🔧 Advanced Configuration

• Custom Armor Creation: Design unique protection gear
• Multi-World Setup: Configure zones across different worlds
• Performance Tuning: Optimize for your specific server needs
• Integration Setup: Connect with other plugins and systems

📝 License & Credits

📄 Usage Terms

NuclearZone is provided for Minecraft server use with the following guidelines:

• Commercial Use: Allowed for server monetization
• Modification: Configuration and customization encouraged
• Redistribution: Please link to official sources
• Support: Community-driven with developer involvement

👨‍💻 Development Team

• Core Development: NuclearZone Development Team
• Quality Assurance: Extensive testing and optimization
• Community Input: Built with server owner feedback
• Ongoing Support: Committed to long-term maintenance

🎮 Get Started Today!

Transform your Minecraft server into a realistic post-apocalyptic survival experience where every step into the unknown could be your last. NuclearZone brings scientific accuracy, stunning visuals, and engaging gameplay mechanics together in one comprehensive plugin.

Download NuclearZone now and create unforgettable radioactive adventures!

NuclearZone - Where survival meets science in the most dangerous zones of Minecraft! ☢️🎮

Version: 1.0.0 | Build: Production Ready | Status: ✅ Complete