Automated, randomized, and fully customizable premium event scheduling for your Rust server — with Discord integration and live player visibility.
- 🎲 Randomized Event Queue — Events fire in a different order every cycle to keep gameplay fresh and unpredictable
- ⏱️ Smart Buffer Timing — Configurable random delay (min/max minutes) between every event keeps spawn timing varied
- 🔁 Auto-Cycling — When all events have run, the list re-randomizes automatically and starts a new cycle
- ⚡ Max Active Events — Control how many events can run simultaneously; prevents event stacking
- 📢 Discord Notifications — Rich embed messages for every scheduler action (load, queue, start, end, delay, cycle reset)
- 🖥️ Console Logging — Full console output for every scheduler action with local server time
- 💬 Player Command — Players type
!eventsor/events— both are silent (not shown in chat), and the result broadcasts to all players so everyone benefits from the cooldown - 🔧 Dynamic Config — Add your own events by editing the config file — no code, no reload required on first load
- 🕐 Local Server Time — All times display in your server's local timezone, auto-detected and abbreviated (e.g. CST, PST, EDT)
- 🛑 Self-Managed Events — Events without a stop command (convoys, trains, etc.) are tracked by run time with no stop needed
- 👹 Managed Events — Events like boss monsters get an automatic stop command fired after their run time expires
- Download
rCEventScheduler.cs - Place it in your
oxide/plugins/directory - Restart the server or run:
oxide.reload rCEventScheduler - Edit the config at
oxide/config/rCEventScheduler.json - Set your Discord webhook URL for admin notifications (optional)
File: oxide/config/rCEventScheduler.json
{
"Log Events to Console": true,
"Log Events to Discord": true,
"Admin Discord Webhook URL": "",
"Max Active Events": 1,
"Event Buffer Time Enabled": true,
"Event Min Buffer Time (minutes)": 5,
"Event Max Buffer Time (minutes)": 15,
"Enable Player Events Command": true,
"Show Next Event Scheduled on Event End": true,
"Events": [
{
"Event Name": "Air Event",
"Event Enabled": true,
"Required Plugin": "AirEvent",
"Event Run Time (minutes)": 60,
"Event Start Command": "airstart",
"Event Stop Command": ""
},
{
"Event Name": "Airfield Event",
"Event Enabled": true,
"Required Plugin": "AirfieldEvent",
"Event Run Time (minutes)": 60,
"Event Start Command": "afestart",
"Event Stop Command": ""
},
{
"Event Name": "Arctic Base Event",
"Event Enabled": true,
"Required Plugin": "ArcticBaseEvent",
"Event Run Time (minutes)": 45,
"Event Start Command": "abstart",
"Event Stop Command": ""
},
{
"Event Name": "Armored Train",
"Event Enabled": true,
"Required Plugin": "ArmoredTrain",
"Event Run Time (minutes)": 60,
"Event Start Command": "atrainstart",
"Event Stop Command": ""
},
{
"Event Name": "Boss Monster Clown",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Clown",
"Event Stop Command": "KillBoss Clown"
},
{
"Event Name": "Boss Monster Evil",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Evil",
"Event Stop Command": "KillBoss Evil"
},
{
"Event Name": "Boss Monster Franken",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Franken",
"Event Stop Command": "KillBoss Franken"
},
{
"Event Name": "Boss Monster Frankenstein",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Frankenstein",
"Event Stop Command": "KillBoss Frankenstein"
},
{
"Event Name": "Boss Monster Heavy",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Heavy",
"Event Stop Command": "KillBoss Heavy"
},
{
"Event Name": "Boss Monster Horror",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Horror",
"Event Stop Command": "KillBoss Horror"
},
{
"Event Name": "Boss Monster Jason",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Jason",
"Event Stop Command": "KillBoss Jason"
},
{
"Event Name": "Boss Monster King of the Night",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss King of the Night",
"Event Stop Command": "KillBoss King of the Night"
},
{
"Event Name": "Boss Monster Michael Myers",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Michael Myers",
"Event Stop Command": "KillBoss Michael Myers"
},
{
"Event Name": "Boss Monster Oni",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Oni",
"Event Stop Command": "KillBoss Oni"
},
{
"Event Name": "Boss Monster Raptor",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Raptor",
"Event Stop Command": "KillBoss Raptor"
},
{
"Event Name": "Boss Monster Scary",
"Event Enabled": true,
"Required Plugin": "BossMonster",
"Event Run Time (minutes)": 60,
"Event Start Command": "SpawnBoss Scary",
"Event Stop Command": "KillBoss Scary"
},
{
"Event Name": "Celestial Barrage",
"Event Enabled": true,
"Required Plugin": "CelestialBarrage",
"Event Run Time (minutes)": 5,
"Event Start Command": "cb.random",
"Event Stop Command": ""
},
{
"Event Name": "Convoy",
"Event Enabled": true,
"Required Plugin": "Convoy",
"Event Run Time (minutes)": 60,
"Event Start Command": "convoystart",
"Event Stop Command": ""
},
{
"Event Name": "Gas Station Event",
"Event Enabled": true,
"Required Plugin": "GasStationEvent",
"Event Run Time (minutes)": 45,
"Event Start Command": "gsstart",
"Event Stop Command": ""
},
{
"Event Name": "Gun Game",
"Event Enabled": true,
"Required Plugin": "GunGame",
"Event Run Time (minutes)": 45,
"Event Start Command": "ggstart",
"Event Stop Command": ""
},
{
"Event Name": "Harbor Event",
"Event Enabled": true,
"Required Plugin": "HarborEvent",
"Event Run Time (minutes)": 60,
"Event Start Command": "harborstart",
"Event Stop Command": ""
},
{
"Event Name": "Sputnik",
"Event Enabled": false,
"Required Plugin": "Sputnik",
"Event Run Time (minutes)": 60,
"Event Start Command": "sputnikstart",
"Event Stop Command": ""
},
{
"Event Name": "Supermarket Event",
"Event Enabled": true,
"Required Plugin": "SupermarketEvent",
"Event Run Time (minutes)": 45,
"Event Start Command": "supermarketstart",
"Event Stop Command": ""
},
{
"Event Name": "Twister",
"Event Enabled": true,
"Required Plugin": "Tornado",
"Event Run Time (minutes)": 5,
"Event Start Command": "tornado start random",
"Event Stop Command": ""
},
{
"Event Name": "Water Event",
"Event Enabled": true,
"Required Plugin": "WaterEvent",
"Event Run Time (minutes)": 120,
"Event Start Command": "waterstart",
"Event Stop Command": ""
}
]
}| Option | Default | Description |
|---|---|---|
Log Events to Console |
true |
Print all scheduler events to the server console |
Log Events to Discord |
true |
Send Discord embed messages for all scheduler events |
Admin Discord Webhook URL |
"" |
Private Discord webhook URL for admin-only notifications |
Max Active Events |
1 |
Maximum number of events that can run at the same time |
Event Buffer Time Enabled |
true |
Enable random delay between events |
Event Min Buffer Time (minutes) |
5 |
Minimum random delay (minutes) before next event fires |
Event Max Buffer Time (minutes) |
15 |
Maximum random delay (minutes) before next event fires |
Enable Player Events Command |
true |
Allow all players to use !events in chat |
Show Next Event Scheduled on Event End |
true |
After an event ends, re-send the Next Event Scheduled Discord embed as a reminder |
| Option | Type | Description |
|---|---|---|
Event Name |
string | Display name of the event |
Event Enabled |
bool | Set to false to skip this event without removing it from the config |
Required Plugin |
string | Oxide plugin name that must be loaded for this event to be scheduled — leave "" to always include |
Event Run Time (minutes) |
int | How long the event runs before being stopped or expired |
Event Start Command |
string | Server console command to start the event |
Event Stop Command |
string | Server console command to stop the event — leave "" if self-managed |
Note: Events with an empty
Event Stop Commandare self-managed. The scheduler tracks their run time but does not issue a stop command — the event ends on its own (e.g. a convoy that despawns naturally).
Note: If
Required Pluginis set and that Oxide plugin is not loaded when the server starts, the event is silently omitted from the queue. A single warning message lists all skipped events and their missing plugins.
| Command | Access | Description |
|---|---|---|
!events |
All Players | Silent — suppressed from chat. Broadcasts active events and next scheduled event to all players |
/events |
All Players | Silent — slash commands are suppressed by Oxide. Same result and same shared cooldown as !events |
Broadcast: The result is sent to all players on the server, not just the player who typed the command. Since the cooldown is global, everyone benefits from one trigger.
Anti-spam: Both commands share a global 5-minute server-side cooldown. The player who triggers it during cooldown receives a private message showing seconds remaining — other players are not notified.
Example output in chat:
[ My Rust Server Event Scheduler ]
Active Events:
● Boss Monster Oni
Next Event: Convoy
Starts at: 4:23 PM CST (~38 min)
The header uses your server's name automatically, pulled from
ConVar.Server.hostname(yourserver.cfghostname).
Disable this command in config with
"Enable Player Events Command": false
When a webhook URL is configured, the plugin sends Discord embed messages for every scheduler action. All embed titles use your server's name automatically (e.g. My Rust Server Event Scheduler).
| Event | Color | Description |
|---|---|---|
| Plugin Loaded | 🔵 Blue | Lists all loaded events by name |
| Queue Randomized | 🟣 Purple | Shows the new randomized event order |
| Next Event Scheduled | 🩵 Teal | Event name, scheduled time, countdown, queue position, and events until reshuffle |
| Event Delayed | 🟠 Orange | Max active events reached — shows new retry time |
| Event Started | 🟢 Green | Event name, run time, expected end time |
| Event Ended | 🟠 Orange | Event name and how it ended (self-managed or stopped) |
| Cycle Complete | 🟣 Purple | All events ran — new randomized cycle starting |
PLUGIN LOADS
└── Counts and logs all enabled events (console + Discord)
└── Randomizes the event queue and logs the order
└── Calculates first buffer time (random between min/max minutes)
└── Waits buffer time, then fires first event
BUFFER FIRES
├── Active events < Max Active Events?
│ YES → Fire next event → run start command
│ → Schedule stop command after run time (if defined)
│ → Schedule next buffer → repeat
│ NO → Wait: Event Run Time + new buffer calculation → retry
ALL EVENTS IN QUEUE HAVE RUN
└── Log "Cycle Complete" to console + Discord
└── Re-randomize the full event list
└── Log new randomized order to console + Discord
└── Resume scheduling from the top
Edit oxide/config/rCEventScheduler.json and add a new block to the "Events" array:
{
"Event Name": "My Custom Event",
"Event Enabled": true,
"Required Plugin": "MyPluginName",
"Event Run Time (minutes)": 45,
"Event Start Command": "myeventstart",
"Event Stop Command": ""
}Then reload: oxide.reload rCEventScheduler
The event will be picked up automatically, mixed into the randomized queue, and scheduled like any other event.
This plugin is licensed under the GNU General Public License v3.0.
Ftuoil Xelrash
⭐ Star this repository if you find it useful! ⭐