Help - CustomDisasters Cloud Editor

🚀 Quick Start

1. Install the Plugin

Download CustomDisasters v3.5+ and place it in your Paper server's plugins/ folder. The plugin requires:

Paper/Spigot 1.21.1+
Java 17+
ProtocolLib (optional, for advanced features)

2. No Configuration Required!

✨ NEW in v3.5: Cloud editor is automatically enabled! No config changes needed.

The editor is ready to use immediately after plugin installation.

3. Create a Session

In-game, run:

/disasters editor

You'll receive a unique URL like: https://customdisasters.online/editor/ABC123

4. Edit in Your Browser

Open the URL in any browser. Changes save automatically every 30 seconds!

5. Save & Apply

Click "Save Changes" and the server applies your edits instantly. No reload required!

📝 Commands Reference

Command	Description	Permission
`/disasters editor`	Open cloud disaster management interface	`customdisasters.admin`
`/disaster start <name>`	Start a disaster	`customdisasters.start`
`/disaster stop`	Stop active disaster	`customdisasters.stop`
`/disaster list`	List all disasters	`customdisasters.list`
`/disaster reload`	Reload configurations	`customdisasters.reload`
`/disaster difficulty <level>`	Set difficulty (easy/normal/hard/expert)	`customdisasters.admin`

✨ Cloud Editor Features

🎮 Management Mode

View, create, edit, and delete ALL disasters from one interface.

💾 Auto-Save

Enabled by default! Your work is saved locally every 30 seconds automatically.

🔒 Session Security

Sessions expire after 1 hour
One-time use (refreshing the page invalidates session)
Only the creating player can edit

⚡ Instant Apply

Changes apply to the server immediately when you save. No restart required!

📄 YAML Configuration Format

Basic Structure

DisasterName: "Zombie Siege"
Description: "Waves of zombies attack the world"
Announcement: "§c⚠ A zombie siege has begun!"
DurationDays: 2

# Mob spawn rules
Mobs:
  - "ZOMBIE"
  - "ZOMBIE_VILLAGER"
  - "/CREEPER"  # Deny creepers

# Wave configuration
Waves:
  - Day: 0
    Time: 0
    Mobs:
      ZOMBIE: 10
      HUSK: 5
  - Day: 0
    Time: 12000
    Mobs:
      ZOMBIE: 20

# Difficulty scaling
Difficulty:
  easy:
    mob_multiplier: 0.5
  hard:
    mob_multiplier: 2.0
  expert:
    mob_multiplier: 3.0

Mob Rules Syntax

ZOMBIE - Allow zombies to spawn
/CREEPER - Deny creepers from spawning
r/ZOMBIE/HUSK - Replace zombies with husks

Color Codes

Use Minecraft color codes in announcements:

§c - Red
§a - Green
§e - Yellow
§b - Aqua
§l - Bold
§o - Italic

🔧 Advanced Features (v3.5)

Smart Difficulty System

Automatic scaling based on player count, equipment, and progression.

Custom Mob System

Define custom mobs with special attributes, AI, and equipment.

Multi-Stage Disasters

Create disasters with multiple phases that evolve over time.

Player Objectives

Assign tasks players must complete during disasters.

Visual Effects System

Add particle effects, custom skies, weather, and fog.

Discord Integration

Send notifications to Discord when disasters start/end.

🔧 Troubleshooting

Session Creation Fails

Check server has internet connection
Verify firewall isn't blocking outbound HTTPS
Check server console for detailed error messages
Ensure you have admin permissions

"Session Not Found" Error

Sessions expire after 1 hour
Create a new session with /disasters editor
Don't share session URLs - they're single-use

Changes Not Applying

Verify you clicked "Save Changes"
Check YAML syntax is valid (no tabs, proper indentation)
Run /disaster reload if needed
Check server console for errors

Connection Timeout

v3.5 has 30-second timeout (up from 10s)
Automatic retry (3 attempts)
Check https://customdisasters.online is accessible

📁 File Locations

Plugin Files

plugins/CustomDisasters/ - Main plugin folder
plugins/CustomDisasters/config.yml - Main configuration
plugins/CustomDisasters/custom/ - Custom disaster definitions
plugins/CustomDisasters/data/ - Runtime data storage

Manual Editing

You can also edit disasters manually by creating/editing YAML files in:

plugins/CustomDisasters/custom/

Then reload with: /disaster reload

❓ Frequently Asked Questions

Is the cloud editor free?

Yes! The cloud editor is completely free and open-source.

Does it store my data?

Sessions are stored in-memory for 1 hour max, then deleted. No persistent storage.

Can I use it offline?

No, the cloud editor requires internet connection. Use manual YAML editing for offline configuration.

Does it work with Spigot?

Yes! Works with Spigot and Paper 1.21.1+

Can multiple players edit simultaneously?

Yes, each player can create their own session and edit different disasters.

What happens if the server restarts during editing?

Your changes are saved on the website. Just save them and they'll apply when you click save.

📚 Help & Documentation