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

```text
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. 🚀