# \u2622\ufe0f NuclearZone – Complete Plugin Guide<\/p>\n
## \ud83c\udf1f Overview<\/p>\n
**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.<\/p>\n
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.<\/p>\n
—<\/p>\n
## \ud83c\udfaf Core Features<\/p>\n
### \ud83d\udd2c Realistic Radiation System
\n– **Gradual Accumulation**: Radiation builds up over time (8.0 per tick), not instantly
\n– **Slow Recovery**: Radiation decreases slowly when outside zones (0.5 per tick)
\n– **Critical Threshold**: Damage only occurs at 100% radiation level
\n– **Lethal Consequences**: Players can die from radiation poisoning (3.5 HP\/second)
\n– **Scientific Accuracy**: Based on real-world radiation exposure principles<\/p>\n
### \ud83d\udee1\ufe0f Complete Protection System
\n– **Radiation Armor**: Full diamond armor sets provide 100% protection
\n– **Custom Armor**: Create unique protection gear through configuration
\n– **Anti-Radiation Items**: 5 consumable items that reduce radiation levels:
\n – **Vodka**: Reduces 25% radiation
\n – **Anti-Rad Pills**: Reduces 50% radiation
\n – **Rad-Away Water**: Reduces 10% radiation
\n – **Potassium Iodide**: Reduces 75% radiation
\n – **Full Cleanse**: Removes 100% radiation
\n– **3D Model Support**: Custom model data for unique visual designs<\/p>\n
### \ud83c\udfa8 Stunning Visual Effects
\n– **Modern Particles**: Utilizes Minecraft 1.21+ particle systems
\n– **SPORE_BLOSSOM_AIR**: Green floating particles for radiation atmosphere
\n– **ELECTRIC_SPARK**: Electrical discharge effects for danger
\n– **ASH & WHITE_ASH**: Radioactive fog and atmospheric haze
\n– **SOUL_FIRE_FLAME**: Zone boundary markers with green fire
\n– **Performance Optimized**: Maximum 15 particles per zone for lag-free experience<\/p>\n
### \ud83d\udd0a Fully Customizable Audio
\n– **Complete Sound Control**: Replace any sound with your preferences
\n– **5 Themed Sound Packs**: Horror, Sci-Fi, Zombie, Inferno, Underwater
\n– **Dynamic Audio Levels**: Different sounds for various radiation stages
\n– **Volume & Pitch Control**: Fine-tune every audio aspect
\n– **Critical Health Alerts**: Special sounds when health drops below 2 HP<\/p>\n
—<\/p>\n
## \ud83c\udfae Gameplay Mechanics<\/p>\n
### \ud83c\udf0d Zone Management
\n– **Flexible Creation**: Zones from 1 to 1000 block radius
\n– **Multiple Zones**: Support up to 50 simultaneous radiation zones
\n– **Easy Administration**: Simple commands for creation and removal
\n– **Visual Boundaries**: Clear particle effects mark danger areas
\n– **Performance Monitoring**: Automatic optimization based on server TPS<\/p>\n
### \u26a1 Radiation Effects
\n1. **Zone Entry**: Player enters radiation zone without protection
\n2. **Accumulation**: Radiation builds at 8.0% per second (configurable)
\n3. **Visual Feedback**: Particle effects and status messages
\n4. **Critical Level**: At 100% radiation, damage begins
\n5. **Lethal Damage**: 3.5 HP per second until death or escape
\n6. **Recovery**: Slow healing at 0.5% per second outside zones<\/p>\n
### \ud83c\udfaf Strategic Gameplay
\n– **Preparation Required**: Players must plan before entering zones
\n– **Resource Management**: Protection gear becomes valuable
\n– **Risk vs Reward**: High-danger zones for valuable resources
\n– **Team Cooperation**: Group exploration with shared protection
\n– **Emergency Items**: Anti-radiation consumables for emergencies<\/p>\n
—<\/p>\n
## \ud83c\udf10 Multi-Language Support<\/p>\n
NuclearZone supports **10 complete languages**:<\/p>\n
– **\ud83c\uddfa\ud83c\uddf8 English** – Full documentation and interface
\n– **\ud83c\uddf7\ud83c\uddfa Russian** – \u041f\u043e\u043b\u043d\u0430\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 \u0440\u0443\u0441\u0441\u043a\u043e\u0433\u043e \u044f\u0437\u044b\u043a\u0430
\n– **\ud83c\udde8\ud83c\uddf3 Chinese** – \u5b8c\u6574\u7684\u4e2d\u6587\u652f\u6301
\n– **\ud83c\udde9\ud83c\uddea German** – Vollst\u00e4ndige deutsche Unterst\u00fctzung
\n– **\ud83c\uddeb\ud83c\uddf7 French** – Support complet en fran\u00e7ais
\n– **\ud83c\uddea\ud83c\uddf8 Spanish** – Soporte completo en espa\u00f1ol
\n– **\ud83c\uddee\ud83c\uddf9 Italian** – Supporto completo in italiano
\n– **\ud83c\uddf5\ud83c\uddf9 Portuguese** – Suporte completo em portugu\u00eas
\n– **\ud83c\udde7\ud83c\uddfe Belarusian** – \u041f\u043e\u045e\u043d\u0430\u044f \u043f\u0430\u0434\u0442\u0440\u044b\u043c\u043a\u0430 \u0431\u0435\u043b\u0430\u0440\u0443\u0441\u043a\u0430\u0439 \u043c\u043e\u0432\u044b
\n– **\ud83c\uddf0\ud83c\uddff Kazakh** – \u049a\u0430\u0437\u0430\u049b \u0442\u0456\u043b\u0456\u043d\u0456\u04a3 \u0442\u043e\u043b\u044b\u049b \u049b\u043e\u043b\u0434\u0430\u0443\u044b<\/p>\n
Each language includes complete message translations, command descriptions, and detailed parameter explanations.<\/p>\n
—<\/p>\n
## \ud83c\udf9b\ufe0f Commands & Permissions<\/p>\n
### \ud83d\udccb Player Commands
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/nuclearzone help` | Show command help | `nuclearzone.help` |
\n| `\/nuclearzone status` | Check radiation level | `nuclearzone.status` |
\n| `\/nuclearzone radiation` | View radiation info | `nuclearzone.radiation` |<\/p>\n
### \ud83d\udd27 Admin Commands ### \ud83d\udd10 Permission Hierarchy —<\/p>\n ## \u2699\ufe0f Configuration System<\/p>\n ### \ud83d\udcca 100+ Configuration Options<\/p>\n #### Radiation Settings #### Visual Effects #### Sound System #### Performance Settings —<\/p>\n ## \ud83d\udd17 Integration Features<\/p>\n ### \ud83d\udd10 LuckPerms Integration # Admin permissions ### \ud83d\udcca PlaceholderAPI Support ### \ud83c\udfa8 Resource Pack Compatibility —<\/p>\n ## \ud83d\ude80 Performance & Optimization<\/p>\n ### \u26a1 Optimized Systems ### \ud83d\udcc8 Scalability Features —<\/p>\n ## \ud83c\udfaf Server Use Cases<\/p>\n ### \ud83c\udff0 Survival Servers ### \ud83c\udfad Roleplay Servers ### \ud83d\uddfa\ufe0f Adventure Maps ### \u2694\ufe0f PvP Servers —<\/p>\n ## \ud83d\udee0\ufe0f Installation & Setup<\/p>\n ### \ud83d\udce6 Quick Installation ### \ud83c\udfae First Steps # Give yourself protection armor # Check your radiation status # View all available commands ### \ud83d\udd27 Basic Configuration # Customize visual effects —<\/p>\n ## \ud83c\udfb5 Sound Customization<\/p>\n ### \ud83d\udd0a Complete Audio Control #### Default Sound Configuration #### \ud83c\udfa8 Themed Sound Packs<\/p>\n **\ud83e\udddf Zombie Apocalypse Theme** **\ud83d\udc7b Horror Theme** **\ud83d\udd25 Inferno Theme** ### \ud83c\udf9b\ufe0f Volume & Pitch Control —<\/p>\n ## \ud83d\udcca Technical Specifications<\/p>\n ### \ud83d\udcbb System Requirements ### \ud83d\udd27 Development Features ### \ud83d\udcc8 Performance Metrics NuclearZone – Realistic radiation zones for MC 1.21+. Gradual damage, protection, particles. \u2622\ufe0f<\/p>\n","protected":false},"featured_media":114357,"template":"","meta":{"_minecraft_slug":"nuclearzone","_minecraft_project_id":"OfFq0oCW","_minecraft_author":"Muliccki","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":56,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nuclearzone.zip","_minecraft_size_bytes":322301,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:53:49.241202Z","_minecraft_date_created":"2026-01-31T21:09:17.598965Z","_minecraft_date_modified":"2026-02-01T18:02:00.971643Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nuclearzone","_minecraft_icon_attachment_id":114357,"_minecraft_imported_at":"2026-06-06T17:46:27+00:00","_minecraft_import_hash":"e1036b2aa3ff584bc18f306ea7284db5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-114356","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/nuclearzone set
\n| `\/nuclearzone remove` | Remove nearest zone | `nuclearzone.admin` |
\n| `\/nuclearzone removeall` | Remove all zones | `nuclearzone.admin` |
\n| `\/nuclearzone list` | List all zones | `nuclearzone.admin` |
\n| `\/nuclearzone armor [player]` | Give protection armor | `nuclearzone.admin` |
\n| `\/nuclearzone item give
\n| `\/nuclearzone custom list` | List custom armor | `nuclearzone.admin` |
\n| `\/nuclearzone reload` | Reload configuration | `nuclearzone.admin` |<\/p>\n
\n– **nuclearzone.player** – Basic player permissions
\n– **nuclearzone.vip** – VIP status with additional features
\n– **nuclearzone.moderator** – Moderator tools and commands
\n– **nuclearzone.admin** – Full administrative access
\n– **nuclearzone.*** – Wildcard for all permissions<\/p>\n
\n“`yaml
\nradiation:
\n damage-per-second: 3.5 # Damage at 100% radiation (1.75 hearts)
\n accumulation-rate: 8.0 # Fast radiation buildup
\n recovery-rate: 0.5 # Slow radiation recovery
\n max-level: 100 # Maximum radiation level
\n check-interval: 20 # Check frequency (ticks)
\n“`<\/p>\n
\n“`yaml
\nradiation:
\n particle-interval: 5 # Particle update frequency
\n particle-intensity: 0.8 # Particle density (performance-friendly)
\n radiation-fog-enabled: true # Atmospheric fog effects
\n glow-enabled: true # Zone boundary particles
\n“`<\/p>\n
\n“`yaml
\nsounds:
\n enabled: true # Master sound toggle
\n radiation-damage:
\n hurt-sound: “ENTITY_PLAYER_HURT”
\n hurt-volume: 1.5
\n hurt-pitch: 0.6
\n critical-health:
\n death-sound: “ENTITY_PLAYER_DEATH”
\n beacon-sound: “BLOCK_BEACON_DEACTIVATE”
\n“`<\/p>\n
\n“`yaml
\nperformance:
\n min-tps: 15.0 # Minimum TPS for operation
\n max-zones: 50 # Maximum radiation zones
\n cleanup-interval: 5 # Offline player cleanup (minutes)
\n“`<\/p>\n
\nComplete permission system with pre-configured roles:
\n“`bash
\n# Player permissions
\n\/lp group player permission set nuclearzone.help true
\n\/lp group player permission set nuclearzone.status true<\/p>\n
\n\/lp group admin permission set nuclearzone.* true
\n“`<\/p>\n
\nUse these placeholders in TAB lists, scoreboards, and other plugins:
\n– `%nuclearzone_level%` – Player’s radiation percentage
\n– `%nuclearzone_status%` – Radiation status (Safe, Low, Medium, High, Critical)
\n– `%nuclearzone_in_zone%` – Whether player is in radiation zone
\n– `%nuclearzone_has_protection%` – Whether player has protection armor<\/p>\n
\n– **Custom Models**: Support for 3D armor and item models
\n– **Texture Integration**: Works with custom texture packs
\n– **Model Data**: Custom model data for unique appearances
\n– **Visual Enhancement**: Seamless integration with visual modifications<\/p>\n
\n– **Efficient Particles**: Reduced from 100+ to maximum 15 particles per zone
\n– **Smart Scaling**: Particle count adjusts based on zone size and server load
\n– **TPS Protection**: Automatic performance adjustments when TPS drops
\n– **Memory Management**: Intelligent cleanup of offline player data
\n– **Modern APIs**: Built with Paper 1.21+ optimizations<\/p>\n
\n– **Large Servers**: Tested for high-player-count environments
\n– **Multiple Worlds**: Support radiation zones across different worlds
\n– **Concurrent Zones**: Handle dozens of active zones simultaneously
\n– **Resource Efficiency**: Minimal impact on server performance<\/p>\n
\n– **Enhanced Challenge**: Realistic environmental hazards
\n– **Strategic Exploration**: Players must prepare before venturing
\n– **Resource Scarcity**: Protection gear becomes valuable commodity
\n– **Team Dynamics**: Encourage cooperation and mutual protection<\/p>\n
\n– **Post-Apocalyptic Scenarios**: Authentic wasteland experiences
\n– **Story Integration**: Radiation zones as narrative elements
\n– **Character Development**: Survival skills as character traits
\n– **Immersive Atmosphere**: Realistic environmental dangers<\/p>\n
\n– **Progressive Challenges**: Increasing radiation levels as obstacles
\n– **Equipment Gates**: Require specific gear to access areas
\n– **Puzzle Elements**: Radiation zones as problems to solve
\n– **Atmospheric Design**: Create tension in exploration<\/p>\n
\n– **Strategic Zones**: High-risk, high-reward combat areas
\n– **Equipment Advantage**: Protection gear provides tactical benefits
\n– **Area Control**: Use radiation to deny territory access
\n– **Dynamic Battlefields**: Changing danger zones affect combat<\/p>\n
\n1. **Download** `NuclearZone-1.0.0.jar`
\n2. **Place** in your server’s `plugins\/` folder
\n3. **Restart** your server
\n4. **Configuration** files generate automatically
\n5. **Ready** to create your first zone!<\/p>\n
\n“`bash
\n# Create your first radiation zone (20 block radius)
\n\/nuclearzone set 20<\/p>\n
\n\/nuclearzone armor<\/p>\n
\n\/nuclearzone status<\/p>\n
\n\/nuclearzone help
\n“`<\/p>\n
\nEdit `plugins\/NuclearZone\/config.yml`:
\n“`yaml
\n# Make radiation more\/less dangerous
\nradiation:
\n damage-per-second: 3.5 # Adjust damage amount
\n accumulation-rate: 8.0 # Adjust buildup speed<\/p>\n
\nradiation:
\n particle-intensity: 0.8 # Adjust particle density
\n radiation-fog-enabled: true # Enable\/disable fog
\n“`<\/p>\n
\nNuclearZone provides unprecedented control over audio effects:<\/p>\n
\n“`yaml
\nsounds:
\n radiation-damage:
\n hurt-sound: “ENTITY_PLAYER_HURT” # Pain sound
\n fire-sound: “BLOCK_FIRE_AMBIENT” # Radiation crackling
\n wither-sound: “ENTITY_WITHER_HURT” # Ominous effect
\n critical-health:
\n death-sound: “ENTITY_PLAYER_DEATH” # Near-death warning
\n beacon-sound: “BLOCK_BEACON_DEACTIVATE” # System failure
\n“`<\/p>\n
\n“`yaml
\nhurt-sound: “ENTITY_ZOMBIE_HURT”
\nfire-sound: “ENTITY_ZOMBIE_AMBIENT”
\nwither-sound: “ENTITY_ZOMBIE_VILLAGER_AMBIENT”
\n“`<\/p>\n
\n“`yaml
\nhurt-sound: “ENTITY_PHANTOM_HURT”
\nfire-sound: “ENTITY_SOUL_FIRE_AMBIENT”
\nwither-sound: “ENTITY_ENDERMAN_SCREAM”
\n“`<\/p>\n
\n“`yaml
\nhurt-sound: “ENTITY_BLAZE_HURT”
\nfire-sound: “ENTITY_BLAZE_AMBIENT”
\nwither-sound: “ENTITY_BLAZE_SHOOT”
\n“`<\/p>\n
\n– **Volume Range**: 0.0 (silent) to 2.0 (very loud)
\n– **Pitch Range**: 0.0 (very deep) to 2.0 (very high)
\n– **Real-time Changes**: Use `\/nuclearzone reload` to apply instantly<\/p>\n
\n– **Minecraft Version**: 1.21+ (Paper\/Spigot\/Bukkit)
\n– **Java Version**: 21+
\n– **Server RAM**: Minimum 1GB (2GB+ recommended)
\n– **Dependencies**: None required (PlaceholderAPI optional)<\/p>\n
\n– **Modern APIs**: Built with Paper 1.21+ optimizations
\n– **Clean Code**: Professional development standards
\n– **Error Handling**: Comprehensive exception management
\n– **Documentation**: Extensive JavaDoc comments
\n– **Modular Design**: Easy to maintain and extend<\/p>\n
\n– **JAR Size**: ~45KB (lightweight)
\n– **Memory Usage**: <10MB typical usage\n- **CPU Impact**: <1% on modern servers\n- **Network Traffic**: Minimal (client-side particles)\n- **Storage**: <1MB for configuration and data\n\n---\n\n## \ud83c\udfc6 Why Choose NuclearZone?\n\n### \u2705 Professional Quality\n- **Enterprise-Grade Code**: Built to professional development standards\n- **Extensive Testing**: Thoroughly tested across multiple environments\n- **Active Development**: Regular updates and improvements\n- **Long-term Support**: Committed to ongoing maintenance\n\n### \u2705 Complete Solution\n- **All-in-One Package**: Everything needed for radiation gameplay\n- **Zero Dependencies**: Works independently without required plugins\n- **Easy Configuration**: Sensible defaults with extensive customization\n- **Comprehensive Documentation**: Detailed guides and examples\n\n### \u2705 Performance First\n- **Optimized Systems**: Designed for high-performance environments\n- **Smart Resource Management**: Efficient memory and CPU usage\n- **Scalable Architecture**: Handles large servers and multiple zones\n- **Modern Technology**: Built with latest Minecraft APIs\n\n### \u2705 Community Ready\n- **Multi-Language Support**: 10 complete language translations\n- **Permission Integration**: Full LuckPerms compatibility\n- **Plugin Compatibility**: Works with popular server plugins\n- **Server Flexibility**: Adapts to any server style or theme\n\n---\n\n## \ud83d\udd2e Future Development Roadmap\n\n### \ud83c\udfaf Planned Features\n- **Advanced Zone Types**: Different radiation types with unique effects\n- **Geiger Counter Items**: Handheld radiation detection tools\n- **Contamination Spread**: Dynamic zone expansion and contraction\n- **Weather Integration**: Radiation affected by weather conditions\n- **Economy Integration**: Radiation cleanup services and protection trading\n\n### \ud83d\ude80 Version 2.0 Goals\n- **GUI Management**: Visual interface for zone management\n- **Advanced Particles**: Custom particle effects and animations\n- **Radiation Sources**: Placeable radiation emitters\n- **Decontamination**: Tools and processes to clean radiation\n- **Mobile Zones**: Moving radiation clouds and storms\n\n---\n\n## \ud83d\udcda Support & Documentation\n\n### \ud83d\udcd6 Included Documentation\n- **Installation Guide**: Step-by-step setup instructions\n- **Configuration Manual**: Detailed explanation of all settings\n- **Command Reference**: Complete list of commands and permissions\n- **Sound Examples**: 50+ sound alternatives with themed packs\n- **Troubleshooting**: Common issues and solutions\n\n### \ud83c\udd98 Getting Help\n- **Configuration Issues**: Check the detailed config comments\n- **Permission Problems**: Review the LuckPerms integration guide\n- **Performance Concerns**: Adjust particle settings and zone limits\n- **Sound Problems**: Use the sound testing guide and examples\n\n### \ud83d\udd27 Advanced Configuration\n- **Custom Armor Creation**: Design unique protection gear\n- **Multi-World Setup**: Configure zones across different worlds\n- **Performance Tuning**: Optimize for your specific server needs\n- **Integration Setup**: Connect with other plugins and systems\n\n---\n\n## \ud83d\udcdd License & Credits\n\n### \ud83d\udcc4 Usage Terms\nNuclearZone is provided for Minecraft server use with the following guidelines:\n- **Commercial Use**: Allowed for server monetization\n- **Modification**: Configuration and customization encouraged\n- **Redistribution**: Please link to official sources\n- **Support**: Community-driven with developer involvement\n\n### \ud83d\udc68\u200d\ud83d\udcbb Development Team\n- **Core Development**: NuclearZone Development Team\n- **Quality Assurance**: Extensive testing and optimization\n- **Community Input**: Built with server owner feedback\n- **Ongoing Support**: Committed to long-term maintenance\n\n---\n\n## \ud83c\udfae Get Started Today!\n\nTransform 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.\n\n**Download NuclearZone now and create unforgettable radioactive adventures!**\n\n---\n\n*NuclearZone - Where survival meets science in the most dangerous zones of Minecraft!* \u2622\ufe0f\ud83c\udfae\n\n**Version**: 1.0.0 | **Build**: Production Ready | **Status**: \u2705 Complete\n<\/p>\n","protected":false},"excerpt":{"rendered":"