Reminders System

1. Feature Brief

The Reminders plugin is a personal, GUI-driven reminder system. Run one command and a button panel appears - no arguments, no syntax to remember. Set a reminder in seconds and the bot will DM you when it fires, regardless of which channel or server you were in when you set it.

1. GUI dashboard - run /reminder to open an interactive panel with buttons for every action; no subcommands or arguments needed
2. Custom reminders - open a modal, type your message and a time expression, and the reminder is saved instantly
3. Quick presets - one-click buttons for 5 min, 15 min, 30 min, 1 hour, and 24 hours - just enter the message and you’re done
4. Flexible time parsing - supports relative durations, specific clock times (12h and 24h), and natural expressions like tomorrow 9am
5. DM delivery - reminders are always sent as a private DM, with the original message and how long ago it was set
6. Reminder list - view all your active reminders for the server, sorted by soonest first, with a live countdown for each
7. Clear all - wipe every active reminder you have in the server in a single click

Who can use this?

Any server member can use /reminder. No permissions or roles are required.

---

2. Sub-Systems

Dashboard

Run /reminder to open the interactive panel. The embed shows the total number of active reminders and unique users in your server.

Row 1 - Management

Button	Action
New Reminder	Opens a modal to set a custom message and time
My Reminders	Lists your active reminders with countdowns (private)
Clear All	Deletes all your active reminders in this server

Row 2 - Quick Presets

Button	Duration
5 min	Fires in 5 minutes
15 min	Fires in 15 minutes
30 min	Fires in 30 minutes
1 hour	Fires in 1 hour
24 hours	Fires in 24 hours

The panel is personal - only you can interact with your own dashboard. Anyone else clicking your buttons receives a prompt to open their own with /reminder. The panel expires after 5 minutes of inactivity.

Time Formats

The custom reminder modal accepts a wide range of time expressions:

Relative durations - combine days, hours, and minutes freely:

Input	Meaning
30m	30 minutes from now
2h	2 hours from now
1d	1 day from now
2h30m	2 hours and 30 minutes from now
1d12h	1 day and 12 hours from now

Specific clock times - sets the reminder for that time today, or tomorrow if the time has already passed:

Input	Meaning
14:30	2:30 PM in 24-hour format
2:30pm	2:30 PM in 12-hour format
9:00am	9:00 AM

Natural expressions:

Input	Meaning
tomorrow	Next day at 9:00 AM (default)
tomorrow 14:30	Next day at 2:30 PM
tomorrow 9am	Next day at 9:00 AM

Maximum message length is 500 characters. Times in the past are rejected with an error.

Delivery

• Reminders are checked every 10 seconds - expect at most a brief delay between the scheduled time and the DM arriving
• Delivery is always via DM, never in a channel; the embed includes the reminder message and how long ago it was originally set
• If the bot cannot DM you (DMs disabled or no shared server), the reminder is silently discarded after the attempt - enable DMs from server members to ensure delivery
• After a reminder fires it is permanently deleted from the database; it will not repeat

Reminder List

Click My Reminders on the dashboard to see your active reminders for the current server:

• Reminders are sorted by soonest first
• Each entry shows a preview of the message (truncated at 50 characters) and the time remaining
• The footer shows the total count of active reminders
• The response is ephemeral - only you can see it
• If you have no active reminders, a prompt to create one is shown instead

---

3. Setup

No configuration or setup command is needed - the plugin is ready the moment it is loaded.

1. Open the dashboard - run /reminder in any server channel. The interactive panel appears as an ephemeral message only you can see.

2. Set a reminder - click New Reminder and fill in the modal: enter what you want to be reminded about (up to 500 characters) and a time expression. Or use a Quick Preset button to skip the time field entirely.

3. Check your reminders - click My Reminders at any time to see what you have queued and how long until each one fires.

4. Wait for the DM - when the time comes, the bot DMs you the reminder message. No further action is needed.

---

Reliability & Edge Cases

• Reminders survive bot restarts - all active reminders are loaded from the database on startup and the check loop resumes immediately.
• The reminder check runs every 10 seconds, so delivery is prompt but not instant to the millisecond.
• Reminders are scoped to the server they were created in but are always delivered via DM, so you’ll receive them even if you’ve left the server by the time they fire.
• If a quick preset modal times out (no submission within 5 minutes), the reminder is silently discarded - no entry is saved.