On Duty System

The On-Duty System in OneeChan is designed to manage moderation shifts by assigning, tracking, and overriding on-duty roles for moderators based on a predefined schedule. Moderators can claim, unassig

The system ensures smooth moderation handover by automatically assigning moderators based on a schedule and allowing overrides when needed.

Features

  • Automated Role Assignment – Assigns moderators to the on-duty role based on a predefined schedule.

  • Claim & Override System – Moderators can claim or unassign their shift as needed.

  • Redis-Backed Role Persistence – Ensures real-time tracking of shifts and overrides.

  • On-Duty Announcements – Sends messages when a moderator claims a shift.

On-Duty System Behavior

Claiming an On-Duty Shift

Moderators can claim their on-duty shift using the command:

/duty claim

If successful, the bot will confirm the claim and send an announcement:

[Moderator] has claimed the on-duty role.

  • If another moderator was scheduled, the system overrides the assignment.

  • If the on-duty role was already assigned, it remains unchanged.

Unassigning from On-Duty

A moderator can remove themselves from an assigned shift using:

/duty unassign

If successful, the bot will confirm:

You have been unassigned, and the timeslot has been overridden or reassigned based on the schedule.

  • If no one else is scheduled, the bot will indicate that no replacement is available.

  • Unassigning is only possible before the shift ends.

Assigning On-Duty Moderators

The system can manually assign the on-duty role based on the predefined schedule:

/duty assign

If successful, the bot will confirm:

On-duty moderator has been assigned based on the current schedule.

This ensures that scheduled moderators are assigned automatically, even if no manual claims have been made.

Checking Current On-Duty Moderators

Moderators can view the currently assigned on-duty staff using:

/duty current

Example Output:

🛡️ Current Time (UTC): 14:00
📅 Scheduled Moderator: Vex
👮 Currently on Duty: Navi, Miso

If no moderators are currently on duty, the bot will display:

No moderators are currently on duty.

Last updated