Wiki Release: 2026.09.5 · UltimateKoth: 2.26.1 · Documentation branch: 2

Scheduler and automation#

Timezone first#

The scheduler uses Config.scheduler.timezone. The supplied installation uses America/Sao_Paulo. If events start at the wrong clock time, verify this value before changing every schedule.

Config.scheduler.edit_permission is ukoth.admin.timezone.edit, so administrators may need that permission when editing timezone-related settings.

Create schedules only after manual testing#

Use /ukoth scheduler create, remove, list and minplayers after /ukoth start <name> has already completed successfully at least once.

A scheduler can correctly fire and still fail to start the KOTH because of minimum-player rules or invalid event state. The Discord integration can also report KothSchedulerEventError when configured.

Pre-alerts#

The configuration contains a scheduler pre-alert section where console commands can be executed before an event starts. Use KOTH placeholders in those commands only after verifying they resolve correctly in your build.

Production checklist#

• server timezone and configured scheduler timezone match your expectation;
• exact KOTH identifier is correct;
• minimum-player requirement is realistic;
• event is not already running;
• pre-alert commands work from console;
• manual event cleanup works before automatic rotation is enabled.