Minor tweaks

CustomDisasters v3.5.2 – "MySQL & Cross-Version Stability"

Release Date: December 2025 | Build Status: ✅ STABLE | JAR: custom-disasters-3.5.2.jar

---

🚀 Major Features

1. MySQL Database Integration (NEW)

Optional persistent storage with HikariCP pooling and async operations:

• disaster_history – All events with timestamps
• player_disaster_stats – Deaths, participation, playtime
• custom_disasters_backup – Auto-backup configs
• disaster_rewards – Reward distribution logs

2. Cross-Version Support (1.19–1.21)

One JAR for all versions. No version-specific builds needed.

3. Complete Particle System Overhaul

All particle constants now use Compat helpers. Verified on 1.19–1.21.

---

🔧 Technical Changes

New Classes:

• MySQLDatabase.java – Database abstraction with async support

Updated Classes:

• CustomDisastersPlugin, AtmosphericEffects, VisualEffectsSystem, EffectsManager, CustomMobSystem, DisasterListener

Dependencies Added:

• mysql-connector-java:8.0.33
• HikariCP:5.1.0
• gson:2.10.1

---

📊 MySQL Configuration

mysql:
  enabled: false
  host: "localhost"
  port: 3306
  database: "customdisasters"
  username: "root"
  password: "yourpassword"
  max-pool-size: 10
  min-idle: 2
  features:
    log-disasters: true
    track-player-stats: true
    backup-custom-disasters: true
    log-rewards: true
    backup-interval-minutes: 60

---

🐛 Fixes

Issue	Fix
Particle constants on 1.19.x	All refs use Compat helpers
Missing DUST particles	VisualEffectsSystem fixed
EXPLOSION crashes	CustomMobSystem fixed

---

📋 Migration

Existing Servers:

1. Backup plugins/CustomDisasters/
2. Replace JAR with v3.5.2
3. Restart (config auto-updates)
4. Optional: Enable MySQL in config.yml

New Servers:

1. Install v3.5.2 JAR
2. First restart auto-generates configs
3. MySQL disabled by default

---

✅ What's Improved

• ✓ One JAR runs on 1.19–1.21 without crashes
• ✓ Database stats for analytics
• ✓ Auto-backup custom configs
• ✓ Async DB operations (zero lag)
• ✓ All particles safe across versions
• ✓ Reward logging for auditing
• ✓ Modrinth update notifications

---

📦 Requirements

Required:

• Paper/Spigot 1.19.x, 1.20.x, or 1.21.x
• Java 17+

Optional:

• MySQL 5.7+ (for database features)
• Vault (for rewards)
• PlaceholderAPI
• ProtocolLib (enhances visuals)

---

🔗 Support

• Modrinth: https://modrinth.com/plugin/customdisasters
• Issues: https://customdisasters.online/

Version 3.5.1 - "Stability & Status" Update

Release Date: 10th December 2025

🚀 Highlights

• Cross-Version Fallbacks (1.19–1.21): Added a compatibility helper to gracefully map particles, potion effects, and enchantments so the 1.21.1 build runs safely on 1.19.x–1.21.x servers.
• New Command: /disaster status reports the current disaster state, remaining time, and whether a disaster is active.
• Particle Safety Pass: Migrated particle usages in effects systems to the compatibility layer to prevent NoSuchFieldError on older versions.

🔧 Technical Changes

• Compile Target: Paper API 1.21.1 (runtime-compatible down to 1.19.x via fallbacks).
• New Helper: Compat centralizes particle/potion/enchant lookups with version-safe defaults.

🐛 Fixes

• Fixed crashes on 1.19.x caused by missing particle/effect constants by routing all visual effects through Compat.

Error or bugs?

Report to https://customdisasters.online/

CustomDisasters - Changelog

Version 3.5.0 - "Cloud Revolution" Update 🌩️

Release Date: December 2025

🚀 Major Features

☁️ Cloud Editor (MAIN FEATURE)

• Live Web-Based Editor - Edit disasters from anywhere via browser at customdisasters.online
• Real-Time Collaboration - Multiple admins can manage disasters simultaneously
• Instant Apply - Changes sync to your server automatically, no restart needed
• Session Management - Secure code-based sessions with 1-hour expiry
• Three Management Tabs:
  • 📝 Custom Disasters - Create and manage your own disasters
  • ⚡ Built-in Disasters - View and duplicate 11 pre-made disasters
  • ⚙️ Global Settings - Configure cooldowns, durations, and enable/disable states

🎨 Visual Disaster Builder

• 4-Tab Editor Interface:
  • 📋 Basic Info - Name, announcement, duration, difficulty, description
  • 👾 Mobs - Visual mob rule builder with allow/deny/replace dropdowns
  • ✨ Effects - Checkbox toggles for fog, darkness, particles, lightning, blood sky, potion effects
  • 🔊 Sounds - Dropdown menus for start sounds and ambient background music
• No YAML Required - User-friendly form fields instead of raw config editing
• Auto-Save - Automatically saves progress every 30 seconds
• Change Tracking - Shows detailed logs of added/removed/modified disasters

🔧 Enhanced Customization

• Enable/Disable System - Toggle any disaster on/off without deleting
• Individual Duration Control - Set custom duration for each disaster (1-30 days)
• Global Cooldown - Configure wait time between disasters
• Difficulty Levels - Easy, Normal, Hard, Extreme presets
• 11 Built-in Disasters:
  • Zombie Apocalypse
  • Skeleton Army
  • Creeper Chaos
  • Spider Infestation
  • Enderman Invasion
  • Blaze Storm
  • Wither Siege
  • Phantom Swarm
  • Drowned Rising
  • Pillager Raid
  • Blood Moon

🎵 Sound System

• Custom Sound Support - Add start.ogg to plugins/CustomDisasters/sounds/
• Built-in Sound Library - 10+ Minecraft sounds (Dragon Roar, Wither Spawn, Thunder, etc.)
• Ambient Background - Set atmospheric sounds for entire disaster duration
• Per-Disaster Configuration - Different sounds for each disaster type

🌐 Official Website

• Domain: customdisasters.online
• Features:
  • Quick access disaster editor
  • Documentation and guides
  • Session code input
  • Mobile-responsive design

🎯 Quality of Life Improvements

• Duplicate Function - Clone disasters to create variations quickly
• YAML Viewer - View raw configuration for debugging
• Success Messages - Visual feedback for all actions
• Console Change Logs - Server console shows detailed change summaries:
• Placeholder API and Vault Support

UPDATE 3.0

New Features & Improvements

• Smart Difficulty – Adaptive challenge scaling based on player performance.

• Custom Mob System – Fully customizable behavior and spawn settings.

• Multi-Stage Disasters – Dynamic events that evolve over time.

• Player Objectives – Guided goals to enhance gameplay progression.

• Visual Effects & Sounds – Enhanced immersion with updated VFX and SFX.

• Discord Webhooks – Instant notifications and event reporting.

• Scheduling & Auto-Spawn – Automated event and mob management.

• Performance Monitoring – Track system load and optimize server health.

• Auto-Complete Commands – Faster input with intuitive command suggestions.

Known Issues

Due to a high number of errors, the online editor is currently disabled. We aim to address these issues in version 3.5. Thank you for your patience—stay tuned!