☢️ 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

Zone Entry: Player enters radiation zone without protection
Accumulation: Radiation builds at 8.0% per second (configurable)
Visual Feedback: Particle effects and status messages
Critical Level: At 100% radiation, damage begins
Lethal Damage: 3.5 HP per second until death or escape
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

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

Download NuclearZone-1.0.0.jar
Place in your server's plugins/ folder
Restart your server
Configuration files generate automatically
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

NuclearZone