Scheduled Commands
Schedule commands and messages to run at a future time or on a recurring interval.
Enabling scheduled commands
Scheduled commands must be enabled in your server's config before anyone can use them.
Usage
/config scheduledCommands true
Once enabled, all members can create schedules up to their limit. Regular users can create up to 3 schedules, while admins can create up to 15 schedules.
One-off scheduled commands
Schedule a command to run once at a future time. The command executes automatically and then the schedule is removed.
Usage
/schedule command once <time> <command>
Example
/schedule command once 30m daily
The when parameter uses the same time format as giveaways (e.g., 30m, 2h, 1d). The command runs relative to when you create the schedule.
Recurring scheduled commands
Set a command to run automatically on a repeating interval. This is perfect for automated routines like farming harvests or daily check-ins.
Usage
/schedule command recurring <interval> <command>
Example
/schedule command recurring 6h "farm harvest"
The command will run every interval indefinitely until you cancel the schedule. The first execution happens after the first interval has passed.
Scheduling messages
Admins can schedule messages to be sent to a specific channel at a future time. This is useful for announcements, reminders, or timed event posts.
Usage
/schedule message once <time> #channel <message>
Example
/schedule message once 1d #general "Don't forget about the event tonight!"
Message scheduling is restricted to admins to prevent misuse. The message is sent as Nevi, not as you.
Listing your schedules
View all of your active schedules.
Usage
/schedule list
This shows every active schedule with its ID, type (once or recurring), the command or message, and the next execution time.
Canceling a schedule
Cancel a schedule you no longer need using its ID prefix.
Usage
/schedule cancel <id>
Example
/schedule cancel abc12
You don't need the full ID. Just enough characters to uniquely identify the schedule. You can find IDs using /schedule list.
Setting the output channel
By default, scheduled commands output their results in the channel where the schedule was created. You can redirect this output to a different channel.
Usage
/schedule output <id> #channel
Example
/schedule output abc12 #bot-spam
This is useful for keeping automated output out of main channels. Send it to a #bot-spam channel so it doesn't clutter conversation.
Permissions & execution context
Scheduled commands run as you with your current permissions at the time the command executes, not when you created the schedule.
Important Notes
- If you lose a permission after creating a schedule, the scheduled command will fail when it tries to run.
- If you leave the server, your schedules are cancelled.
- Regular users can create up to 3 schedules. Admins can create up to 15 schedules.
- Message scheduling (sending text to a channel) is admin only.
This permission model ensures that scheduled commands can't be used to escalate privileges. If you can't run a command manually, you can't schedule it either.
Related Commands
/configmanagementRequires adminConfigure server settings
/schedulemanagementSchedule commands or messages to run later or on a timer