NuclearZone
- By
NuclearZone - Realistic radiation zones for MC 1.21+. Gradual damage, protection, particles. ☢️
Снимок ÑкÑана 2026-01-31 021423.png
Снимок ÑкÑана 2026-01-31 021348.png
Снимок ÑкÑана 2026-01-31 021453.png
Снимок ÑкÑана 2026-01-31 021506.png
Снимок ÑкÑана 2026-01-31 021357.png
Description
# ☢️ 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 [player]` | Give protection armor | `nuclearzone.admin` |
| `/nuclearzone item give <item>` | Give anti-radiation items | `nuclearzone.admin` |
| `/nuclearzone custom list` | List custom armor | `nuclearzone.admin` |
| `/nuclearzone reload` | Reload configuration | `nuclearzone.admin` |
### 🔐 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
```yaml
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
```yaml
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
```yaml
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
```yaml
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:
```bash
# 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
```bash
# 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`:
```yaml
# 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
```yaml
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**
```yaml
hurt-sound: "ENTITY_ZOMBIE_HURT"
fire-sound: "ENTITY_ZOMBIE_AMBIENT"
wither-sound: "ENTITY_ZOMBIE_VILLAGER_AMBIENT"
```
**👻 Horror Theme**
```yaml
hurt-sound: "ENTITY_PHANTOM_HURT"
fire-sound: "ENTITY_SOUL_FIRE_AMBIENT"
wither-sound: "ENTITY_ENDERMAN_SCREAM"
```
**🔥 Inferno Theme**
```yaml
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
The NuclearZone Team
