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/