Перейти к содержимому
Mineforgian

CustomDisasters

Custom Disasters is a Paper plugin that adds dynamic world events like Blood Moons, Zombie Apocalypses, and Nether Breaches, each transforming gameplay with unique mob behavior and atmospheric world effects.

Загрузки
935
Подписчики
7
Обновлён
10 декабря 2025 г.
Лицензия
MIT

Опубликован 23 ноября 2025 г.

🌋 CustomDisasters

Dynamic disaster events for Paper 1.20+ with a cloud-based visual editor.

CustomDisasters creates atmospheric disaster events (zombie apocalypses, skeleton armies, blood moons, etc.) that transform your Minecraft world with custom mobs, visual effects, sounds, and environmental hazards.

Main Feature: A cloud-based visual editor lets you create and manage disasters from any browser — no YAML editing, no server restarts.

⚠️ Requires ProtocolLib 5.0.0+ 🌐 Cloud Editor: customdisasters.online


🎯 What It Does

Creates disaster events that change your world:

  • Custom mob spawning (allow/deny/replace mobs)
  • Atmospheric effects (fog, darkness, particles, lightning, sky colors)
  • Sound design (start sounds + ambient music)
  • Duration control (1-30 in-game days)
  • Difficulty scaling (Easy/Normal/Hard/Extreme)

Example: "Zombie Apocalypse" spawns only zombies, replaces all passive mobs with zombies, adds fog/darkness, plays eerie music, lasts 2 in-game days.


☁️ Cloud Editor

Manage disasters from your browser — no file editing needed.

  • Create disasters with visual forms (dropdowns, checkboxes)
  • 11 built-in disasters (enable/disable or duplicate to customize)
  • Global settings (cooldowns, durations)
  • Changes sync instantly without restarts
  • Access from any device

Usage: /disaster editor → Visit customdisasters.online → Enter code → Edit → Save


✨ What's Included

✨ Features

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

Custom Disaster Creator:

  • Visual editor (no YAML)
  • Mob rules (allow/deny/replace)
  • Effects (fog, darkness, particles, lightning, sky colors)
  • Sounds (10+ built-in + custom .ogg)
  • Duration & difficulty presets

Commands:

  • /disaster editor - Open web editor
  • /disasters start <name> - Trigger disaster
  • /disasters stop - End current disaster
  • /disasters list - View all disasters

📦 Requirements

  • Paper 1.20.1+ (1.21.x recommended)
  • Java 17+
  • ProtocolLib 5.0.0+ (mandatory)
  • PlaceholderAPI 2.11.0+ (optional)

🎯 Perfect For

Survival/SMP servers • RPG worlds • Challenge/Hardcore modes • Seasonal events • Content creators • Community servers


🧩 Compatibility

✅ Paper/Purpur/Pufferfish | ⚠️ Spigot (reduced visuals) | ❌ Forge/Fabric/Vanilla


📥 Installation

  1. Download custom-disasters-3.5.0.jar
  2. Install ProtocolLib (required)
  3. Place both JARs in /plugins/
  4. Restart server
  5. Run /disaster editor in-game
  6. Visit customdisasters.online to start creating

📖 Quick Start

Create a disaster:

  1. /disaster editor → Enter code at customdisasters.online
  2. Click "+ Create New" → Fill visual form (4 tabs: Basic/Mobs/Effects/Sounds)
  3. Save → Test with /disasters start YourDisasterName

Use built-ins: Open editor → Built-in Disasters tab → Enable/disable or duplicate to customize


🔗 Links

ChangelogIssuesCloud Editor


Developer: Connor • Version: 3.5.0 • License: MIT

Ченджлог

3.5.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 10 декабря 2025 г.

Minor tweaks

3.5.2Релиз1.21.9, 1.21.10, 1.21.11 · 10 декабря 2025 г.

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

3.5.1Релиз1.21.9, 1.21.10, 1.21.11 · 10 декабря 2025 г.

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/

3.5.0Релиз1.21.9, 1.21.10, 1.21.11 · 9 декабря 2025 г.

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
3.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 8 декабря 2025 г.

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!

Комментарии

Загружаем…