SchedulerCheck Guide

This page documents SchedulerCheck as a public staff/reference guide. It has no player-facing command and intentionally rejects in-game use and RCON.

What It Does

SchedulerCheck is a direct-console server-owner tool for checking CMI scheduler entries before a restart, after editing the scheduler file, or before adding a simple new scheduled task.

How Staff Use It

There is no player-side command for SchedulerCheck. Server owners use it from direct console to check CMI scheduler YAML, review enabled and disabled entries, explain one entry, estimate upcoming fixed-time runs, export reports, safely toggle one schedule entry, or create a basic delay/daily schedule without opening the file system.

Available features include:

• Run a YAML and value check before trusting a changed scheduler file.
• Catch invalid time values such as Hour: 31 or Minute: Five.
• List all, enabled, or disabled CMI scheduler entries.
• Inspect one scheduler entry by id when you need the full details.
• Explain one entry in plain language, including trigger details and command count.
• Estimate fixed-time PerformOn runs for the next 24 hours or 7 days.
• Export the latest check as full Markdown or compact Discord Markdown.
• Toggle one entry with Enabled: true or Enabled: false while logging the reason.
• Create a simple disabled delay or daily task from direct console.

Quick Start

1. Open direct server console, not RCON and not in-game chat.
2. Run /_scheduler check to scan the configured CMI scheduler file.
3. Use /_scheduler list enabled or /_scheduler list id Announcer to review specific entries.
4. Use /_scheduler explain Announcer when you want a plain-language summary.
5. Run /_scheduler export discord when you want a compact Markdown report to share with staff.

Commands

Command	What it does	Example
/_scheduler	Shows the SchedulerCheck intro from direct console.	/_scheduler
/_scheduler info	Shows the SchedulerCheck intro and server scheduler documentation link.	/_scheduler info
/_scheduler help	Shows command examples.	/_scheduler help
/_scheduler check	Parses and validates the configured server scheduler file.	/_scheduler check
/_scheduler scan	Alias for the scheduler check action.	/_scheduler scan
/_scheduler explain <key>	Shows a plain-language summary for one scheduler entry.	/_scheduler explain Announcer
/_scheduler upcoming 24h|7d	Estimates upcoming fixed-time PerformOn runs over the next day or week.	/_scheduler upcoming 24h
/_scheduler export	Writes the latest check as Markdown, running a fresh check first when needed.	/_scheduler export
/_scheduler export discord	Writes a compact Discord-friendly Markdown report.	/_scheduler export discord
/_scheduler list [all|enabled|disabled]	Lists scheduler entries by state.	/_scheduler list
/_scheduler list id <key>	Shows full details for one scheduler entry.	/_scheduler list id example
/_scheduler set <key> [enabled] <true|false> [--reason <text>]	Sets one entry Enabled: true or false with a line-preserving edit and audit log entry.	/_scheduler set Announcer enabled false --reason noisy during maintenance
/_scheduler create <key> delay <seconds> <true|false> --command <command> [--reason <text>]	Appends a simple delay-based schedule entry, then reloads the YAML to verify it.	/_scheduler create pinataClear delay 600 false --command asFakeOp! pinata killall
/_scheduler create <key> daily <hour> <minute> <true|false> --command <command> [--reason <text>]	Appends a simple daily PerformOn schedule entry, then reloads the YAML to verify it.	/_scheduler create morningAnnouncer daily 6 0 false --command broadcast! Good morning from 1MoreBlock --reason draft test
/_scheduler reload	Reloads SchedulerCheck config and messages.	/_scheduler reload

Examples

• /_scheduler check
• /_scheduler export discord
• /_scheduler explain Announcer
• /_scheduler upcoming 24h
• /_scheduler list enabled
• /_scheduler list id Announcer
• /_scheduler set Announcer enabled false --reason noisy during maintenance
• /_scheduler create morningAnnouncer daily 6 0 false --command broadcast! Good morning from 1MoreBlock --reason draft test
• /_scheduler create pinataClear delay 600 false --command asFakeOp! pinata killall

Good To Know

• A full /stop and server start is still the cleanest way to apply server scheduler file changes.
• You can try /cmi reload or /cmi schedule <key> for server-side testing, but do not treat that as a full restart.
• The scan warns about invalid booleans, invalid numbers, missing Commands on enabled schedules, risky command roots, unknown server specialized command prefixes, duplicate enabled schedules, common schedule-id typos,…
• Exports may include scheduler command lines, so review reports before posting them publicly.

Full Reference

The full synced SchedulerCheck reference is available for exact technical details.