SVSchedule

SVSchedule is a lightweight scheduler plugin for Paper/Spigot servers that allows commands to be executed automatically based on custom schedules. Perfect for daily events, giveaways, recurring rewards, automated announcements, and random events within specific time ranges.

The plugin is designed to be safe against server reloads and restarts, as all generated schedules are stored in a data file and automatically restored when the server starts again.

✨ Features

• 📅 Schedule events at specific times
• 🎲 Random events within a configurable time range
• 🔢 Daily event limit support (limit)
• 🌏 Per-event timezone support
• ⏳ Delay between commands
• 🎨 HEX color and Minecraft color code support
• 🔄 Safe against /reload and server restarts
• 💾 Automatic schedule storage in schedule.yml
• ⚡ Lightweight and performance-friendly
• 🛠️ Enable/disable individual events

---

📖 Usage Examples

Random Event

Randomly generates 3 different times between 21:00–23:00 every day.

schedule:
  moonevent:
    enabled: true
    timezone: "Asia/Jakarta"
    time-range: "21:00 - 23:00"
    limit: 3

    actions:
      - command: "say Moon Event started!"

Example generated schedule:

21:17
22:05
22:43

Different times will be generated every day.

---

Fixed-Time Event

Executes commands every day exactly at 00:00.

schedule:
  midnight:
    enabled: true
    timezone: "Asia/Jakarta"
    time-range: "00:00"

    actions:
      - command: "say Happy Midnight!"

---

Delay Between Commands

actions:
  - command: "say Event started!"
  - delay: "5s"
    command: "give @a diamond 1"
  - delay: "10s"
    command: "say Event finished!"

Delay formats:

Format	Description
5s	5 seconds
1m	1 minute

---

⚙️ Example Configuration

# Enable or disable the entire scheduling system
enabled: true

schedule:
  moonevent:
    enabled: true # NEW FEATURE: Enable/disable this specific event
    timezone: "Asia/Jakarta"
    time-range: "19:00 - 22:00" # Uses the random scheduling system
    limit: 3 # Commands will be executed 3 times between 19:00 and 22:00
    actions:
      - command: "eco give %player% 1000"
        delay: "0s"
      - command: "broadcast &#ff3366[SV] MoonEvent Phase 2 Started!" # NEW FEATURE: HEX & Color Code Support
        delay: "30s"
      - command: "mobs spawn moonevent_boss"
        delay: "1m"

  anotherevent:
    enabled: true # NEW FEATURE: Runs independently from other events
    timezone: "Asia/Jakarta"
    time-range: "13:00" # NEW FEATURE: Supports fixed-time schedules
    actions:
      - command: "broadcast &#00ffcc[SV] This message appears exactly at 13:00 WIB!"
        delay: "0s"


# Asia
# Asia/Jakarta
# Asia/Makassar
# Asia/Jayapura
# Asia/Singapore
# Asia/Bangkok
# Asia/Ho_Chi_Minh
# Asia/Manila
# Asia/Kuala_Lumpur
# Asia/Hong_Kong
# Asia/Taipei
# Asia/Shanghai
# Asia/Seoul
# Asia/Tokyo
# Asia/Dubai
# Asia/Kolkata

# Europe
# Europe/London
# Europe/Dublin
# Europe/Paris
# Europe/Berlin
# Europe/Madrid
# Europe/Rome
# Europe/Amsterdam
# Europe/Warsaw
# Europe/Athens
# Europe/Moscow

# North America
# America/New_York
# America/Detroit
# America/Chicago
# America/Denver
# America/Phoenix
# America/Los_Angeles
# America/Toronto
# America/Vancouver
# America/Mexico_City

# South America
# America/Sao_Paulo
# America/Argentina/Buenos_Aires
# America/Santiago
# America/Bogota
# America/Lima
# America/Caracas

# Oceania
# Australia/Sydney
# Australia/Melbourne
# Australia/Brisbane
# Australia/Perth
# Pacific/Auckland
# Pacific/Fiji

# Africa
# Africa/Cairo
# Africa/Johannesburg
# Africa/Lagos
# Africa/Nairobi
# Africa/Casablanca

# UTC
# UTC
# Etc/UTC
# GMT

---

🔑 Commands

Command	Permission
/svschedule reload	svschedule.admin

---

🛡️ Permissions

svschedule.admin

Allows players to reload the plugin configuration.

---

💡 Perfect For

• Daily events
• Automatic rewards
• Moon Events
• Server giveaways
• Auto broadcasts
• Scheduled restarts
• Crate events
• Boss events
• Mining events
• Seasonal events

---

🔥 Advantages

Unlike traditional scheduler plugins, SVSchedule stores generated schedules in a file, which means:

• No schedule regeneration after reloads.
• Prevents events from running twice.
• Continues remaining schedules after server restarts.
• Safe for economy systems and reward-based events.

SVSchedule is built for servers that need a stable, lightweight, and reliable automated event scheduling system. 🚀