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 admin

Configure server settings

/schedulemanagement

Schedule commands or messages to run later or on a timer