📋 NuclearZone v1.0.1 - Changelog

What's New

☢️ Core Features

Radiation Zones - Create radiation zones with any radius
Auto-Save System - Zones automatically save to zones.yml and restore after server restart
Radiation Mechanics - Gradual radiation accumulation, damage at 100%, recovery outside zones
Visual Effects - Particles, sounds, and visual indicators

🛡️ Protection System

Diamond Armor - 100% radiation protection with beautiful gradients
Iron Armor - 75% radiation protection
Custom Armor - Fully configurable custom armor support
Full Set Detection - Bonus protection when wearing complete armor set

💊 Anti-Radiation Items

Vodka - Reduces radiation by 25%
Antirad - Reduces radiation by 50%
Radiation Water - Reduces radiation by 10%
Potassium Iodide - Reduces radiation by 75%
Full Cleanse - Removes 100% radiation
Custom Items - Add your own items with custom effects

🎨 GUI Shop System

Beautiful Interface - Modern GUI with gradients and animations
Main Menu - Categories for items and armor
Items Menu - Browse and get anti-radiation items
Armor Menu - Get protection armor (diamond, iron, custom)
Sound Effects - UI sounds for better experience
Particle Effects - Visual feedback when receiving items
Fully Configurable - Customize everything via gui-config.yml

📊 HUD System

Radiation Display - Real-time radiation level on screen
Protection Status - Shows if player has protection
Customizable Design - Configure colors, position, and format
PlaceholderAPI Ready - Integration support for other plugins

🌐 Multi-Language Support

10 Languages - Russian, English, German, French, Spanish, Italian, Portuguese, Chinese, Belarusian, Kazakh
Easy Translation - All messages in separate language files
Switch Anytime - Change language in config without restart

🔒 Security System

Anti-Spam - 100ms cooldown between commands
Anti-Flood - Maximum 10 commands per second
Input Validation - All user input is validated and sanitized
Injection Protection - Protected against SQL, XSS, Command, and Path Traversal attacks
Permission System - 25 permissions for fine-grained access control
Error Handling - Centralized error handler with logging

⚡ Performance

Async Processing - Heavy operations run asynchronously
Data Caching - ConcurrentHashMap for fast data access
TPS Check - Skips processing when server TPS is low
Memory Management - Automatic cleanup of old data
Optimized Loops - Efficient code for minimal resource usage

🎯 Commands

/nuclearzone help              - Show help
/nuclearzone set <radius>      - Create radiation zone
/nuclearzone remove            - Remove nearest zone
/nuclearzone removeall         - Remove all zones
/nuclearzone list              - List all zones
/nuclearzone status [player]   - Check radiation status
/nuclearzone menu              - Open GUI shop
/nuclearzone reload            - Reload configuration
/nuclearzone armor <type>      - Give protection armor
/nuclearzone item <id>         - Give custom item
/nuclearzone reset [player]    - Reset radiation level
/nuclearzone toggle            - Toggle visual effects

🔑 Permissions

Basic (for all players):
- nuclearzone.use
- radiation.help
- radiation.status

Admin (OP only):
- radiation.admin (includes all)
- radiation.set
- radiation.remove
- radiation.reload
- radiation.armor
- radiation.item
- radiation.bypass

📚 Documentation

40+ Documentation Files - Complete guides and examples
Custom Items Guide - Add your own items (10 examples included)
Custom Armor Guide - Add your own armor (20 examples included)
Quick Start Guide - Get started in 5 minutes
Visual Examples - See how items look in-game
Security Audit - Full security report included

🛠️ Developer Features

Custom Items API - Easy to add new anti-radiation items
Custom Armor API - Easy to add new protection armor
30+ Ready Examples - Copy and customize
Detailed Comments - Well-documented code
Extensible Design - Easy to add new features

🎨 Customization

Full Config Control - Everything configurable via YAML files
MiniMessage Support - Beautiful gradients and colors
Custom Model Data - Support for resource packs
GUI Customization - Change slots, items, names, lore
Effect Customization - Configure particles, sounds, titles

Technical Details

Requirements

Minecraft: 1.21+
Server: Paper (recommended)
Java: 21+
RAM: 512 MB minimum

File Size

JAR: 213 KB (with dependencies)
Documentation: ~500 KB

Code Statistics

Java Files: 36
Lines of Code: ~8,000+
Comments: ~1,500+
Classes: 36
Methods: ~300+

Security Rating

Overall: 9.5/10
Input Validation: ✅ Complete
Injection Protection: ✅ Complete
Error Handling: ✅ Centralized
Performance: ✅ Optimized

Installation

Download NuclearZone-1.0.1.jar
Place in plugins/ folder
Restart server
Configure config.yml (optional)
Done!

Quick Start

Choose language in config.yml:

language: en  # or ru, de, fr, es, it, pt, zh, be, kk

Create first zone:
```
/nz set 50
```
Open shop:
```
/nz menu
```
Check status:
```
/nz status
```

What's Fixed

Security Fixes

✅ Removed all printStackTrace() from production code
✅ Centralized error handling
✅ Added input validation for all commands
✅ Added anti-spam and anti-flood protection
✅ Fixed permission checks

Bug Fixes

✅ Fixed armor display showing {armor-name} placeholder
✅ Fixed item display showing {item_name} placeholder
✅ Fixed zone persistence (zones now save and restore)
✅ Fixed armor protection detection
✅ Fixed GUI messages

Performance Improvements

✅ Optimized radiation processing
✅ Added TPS checks before heavy operations
✅ Implemented data caching
✅ Added automatic memory cleanup
✅ Optimized loops and queries

Future Plans

Planned Features (30+ ideas)

Mutation System
Radiation Storms
Radiation Monsters
Crafting System
Radiation Crystals
Bunker System
Quest System
Achievement System
Leaderboards
PlaceholderAPI Integration
WorldGuard Integration
Dynmap Integration
MySQL Database Support
Web Panel
And much more!

See FUTURE-FEATURES.md for complete list.

Credits

Developer: NuclearZone Development Team Version: 1.0.1 Release Date: February 2, 2026 Status: ✅ Production Ready

NuclearZone

NuclearZone 1.0.1