NuclearZone

# ☢️ 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 | Command | Description | Permission | |---------|-------------|------------| | `/nuclearzone help` | Show command help | `nuclearzone.help` | | `/nuclearzone status` | Check radiation level | `nuclearzone.status` | | `/nuclearzone radiation` | View radiation info | `nuclearzone.radiation` | ### 🔧 Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/nuclearzone set <radius>` | Create radiation zone | `nuclearzone.admin` | | `/nuclearzone remove` | Remove nearest zone | `nuclearzone.admin` | | `/nuclearzone removeall` | Remove all zones | `nuclearzone.admin` | | `/nuclearzone list` | List all zones | `nuclearzone.admin` | | `/nuclearzone armor