DisCal - About

Below is full documentation on DisCal commands.


This documentation includes the command, acceptable arguments, an example, and an explanation for each and every command DisCal has to offer.

Since many commands have sub-commands and functions, this page will be split into sections for each.


[] = required argument, do not actually include this symbol in the command
() = optional argument, do not actually include this symbol in the command


Event Demo Gif Calendar Demo Gif Announcement Demo Gif

!calendar commands

Alias: !cal !callador

Command Acceptable Arguments Example Description
!cal create !cal create [name w/ spaces] !cal create cool calendar Starts the calendar creator
!cal summary !cal summary [summary w/ spaces] !cal summary cool calendar Sets the calendar's name/summary
!cal name !cal name [name w/ spaces] !cal name cool calendar Sets the calendar's name/summary
!cal description !cal description [desc. w/ spaces] !cal description my awesome calendar Sets the calendar's description
!cal timezone !cal timezone [timezone] !cal timezone America/Chicago Sets the calendar's timezone.
!cal view !cal view !cal view Displays the calendar currently in the editor/creator
!cal review !cal review !cal review Displays the calendar currently in the editor/creator
!cal confirm !cal confirm !cal confirm Confirms the creation/edits and updates on Google.
!cal cancel !cal cancel !cal cancel Cancels the creation/edits of a calendar
!cal delete !cal delete !cal delete Deletes the calendar from your Guild and Google
!cal remove !cal remove !cal remove Deletes the calendar from your Guild and Google
!cal edit !cal edit !cal edit Allows you to edit the calendar

!event commands

Aliases: !e

Command Acceptable Arguments Example Description
!event create !event create (name w/ spaces) !event create my cool event Start the event creator
!event summary !event summary [summary w/ spaces] !event summary my cool event Sets the event name/summary
!event description !event description [desc. w/ spaces] !event description This is my super cool event Sets the event description
!event start !event start [yyyy/MM/dd-HH:mm:ss] !event start 2018/03/21-14:30:00 Sets the event's start time (in 24 hour format)
!event end !event end [yyyy/MM/dd-HH:mm:ss] !event end 2018/03/21-20:00:00 Sets the event's end time (in 24 hour format)
!event color !event color [color] !event color GREEN Set's the event's Color
!event colour Alias of 'color' See above
!event location !event location [location] !event location Room 253 Sets the event's location
!event image !event image [link] !event image https://life.has-destroyed.me/CoXnNvOVq.jpg Sets the event's image. Must be a valid link to image directly. .gif support is Patron only!
!event review !event review !event review Displays the event currently in the creator/editor
!event confirm !event confirm !event confirm Confirms the event's creation/edit.
!event cancel !event cancel !event cancel Cancels the event creation/edits.
!event recur !event recur [true/false] !event recur true Set's whether or not the event will recur
!event freq !event freq [frequency] !event freq DAILY Set's the event recurrence frequency to DAILY. Valid options: DAILY, WEEKLY, MONTHLY, YEARLY
!event count !event count [count] !event count -1 Sets how many times the event will recur. (Use 0 or -1 for infinite)
!event interval !event interval [interval] !event interval 2 Sets the recurrence interval. 1 is every time (according to frequency), 2 means every other time, etc etc
!event edit !event edit [event ID] !event edit eihctjdgmf Starts the event editor for the specified event
!event copy !event copy [event ID] !event copy eihctjdgmf Copies the specified event details into a new event creator
!event view !event view [event ID] !event view eihctjdgmf Displays the specified event's details.
!event delete !event delete [event ID] !event delete eihctjdgmf Deletes the specified event
!event remove !event remove [event ID] !event remove eihctjdgmf Deletes the specified event

All Other Commands

Command Acceptable Arguments Example Description
!events !events (amount) !events 2 Displays up to the specified amount of upcoming events
!events today !events today !events today Displays the events upcoming in the next 24 hour period
!events now OR !events current OR !events ongoing !events now !events now Displays all events that are ongoing currently

!rsvp commands

Command Acceptable Arguments Example Description
!rsvp ontime !rsvp ontime [Event ID] !rsvp ontime eihctjdgmf RSVPs as going to the event on time.
!rsvp late !rsvp late [Event ID] !rsvp late eihctjdgmf RSVPs as going to the event, but arriving late.
!rsvp not !rsvp not [Event ID] !rsvp not eihctjdgmf RSVPs as not going to the event.
!rsvp unsure !rsvp unsure [Event ID] !rsvp unsure eihctjdgmf RSVPs as unsure about whether or not you will attend.
!rsvp remove !rsvp remove [Event ID] !rsvp remove eihctjdgmf Removes your RSVP status from the event.
!rsvp list !rsvp list [Event ID] !rsvp list eihctjdgmf Lists the users who have RSVPed to the event.
!rsvp limit !rsvp limit [Event ID] 5 !rsvp list eihctjdgmf 5 Sets a limit of how many people can RSVP to the event. -1 to disable
!rsvp role !rsvp role [Event ID] [role-id-or-name] !rsvp role Peeps Sets the role assigned when RSVPing to the event. "none" to disable/remove Patron only!

!announcement commands

Aliases: !announcements !announce !alert !alerts !a !ann

Command Acceptable Arguments Example Description
!a create !a create !a create Starts the announcement creator
!a type !a type [type] !a type UNIVERSAL Sets the announcement type. Valid types: UNIVERSAL, SPECIFIC, COLOR, RECUR
!a event !a event [event-id] !a event eihctjdgmf Sets the announcement's event. ONLY needed when using SPECIFIC or RECUR
!a color !a color [color] !a color BLUE Sets the announcement's color ONLY needed when using COLOR
!a colour Alias of 'color' see above
!a channel !a channel [channel-name] !a channel announcements Sets the announcement's channel to post in.
!a minutes !a minutes [minutes] !a minutes 30 Sets the minutes before the event to announce. Added to hours
!a hours !a hours [hours] !a hours 2 Sets the hours before the event to announce. Added to minutes
!a info !a info [your info here] !a info So much info, so little space Sets the additional info to be posted as part of the announcement
!a infoOnly !a infoOnly !a infoOnly Sets the announcement to ONLY display the additional info set.
!a publish !a publish !a publish Toggles whether the announcement will "publish" or repost in news channels Patron only!
!a review !a review !a review Displays info about the announcement being edited/created.
!a confirm !a confirm !a confirm Confirms the creation/edits and updates the database.
!a cancel !a cancel !a cancel Cancels the creation/edits on the announcement.
!a edit !a edit [announcement-ID] !a edit d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Starts the editor for the specified announcement
!a copy !a copy [announcement-ID] !a copy d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Copies the specified announcement's details to a new announcement
!a delete !a delete [announcement-ID] !a delete d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Deletes the specified announcement
!a enable !a enable [announcement-ID] !a enable d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Sets the announcement to be enabled, so it is posted.
!a disable !a disable [announcement-ID] !a disable d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Sets the announcement to be disabled, so it is not posted.
!a view !a view [announcement-ID] !a view d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Displays the specified announcement's details
!a list !a list [Amount or "all"] !a list 10 Lists the specified amount of announcements view quick viewing
!a sub !a sub [announcement-ID] (user(s) and/or role(s)) !a sub d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Subscribes yourself OR the specified users/roles to the announcement
!a unsub !a unsub [announcement-ID] (user(s) and/or role(s)) !a unsub d9b0ab8d-7b1e-4f3f-aaa8-0a8399e3fc8c Unsubscribes yourself OR the specified users/roles to the announcement

!discal commands

Command Acceptable Arguments Example Description
!discal !discal !discal Displays DisCal's bot information
!discal settings !discal settings !discal settings Displays the guild's settings for DisCal (like prefix)
!discal prefix !discal prefix [prefix] !discal prefix $$ Changes DisCal's prefix.Mentioning DisCal will always work no matter the prefix
!discal role !discal role [role-name] !discal role controllers Sets the role (or higher) users must have in order to use certain DisCal commands. Reset with "!discal role everyone"
!discal channel !discal channel [channel-name] !discal channel discal-control Sets the channel DisCal can respond in. Reset with "!discal channel all"
!discal simpleAnnouncement !discal simpleAnnouncement !discal simpleAnnouncement Makes announcements appear more user friendly
!discal brand !discal brand !discal brand Uses the guild's name in DisCal embeds. Patron only!
!discal timeFormat !discal timeFormat !discal timeFormat Toggles between using the 12-hour time format or 24-hour time format.
!discal lang !discal lang [language] !discal lang english Set's DisCal's language
!discal invite !discal invite !discal invite Displays the invite link to DisCal's Support Guild.
!discal dashboard !discal dashboard !discal dashboard Displays the link to the Control dashboard on DisCal's website.

All Other Commands

Command Acceptable Arguments Example Description
!linkCal !linkCal !linkCal Displays the server's calendar info AND provides a link to view in browser
!time !time !time Displays the current time of the calendar in the calendar's timezone
!events !events (amount) !events 2 Displays up to the specified amount of upcoming events
!events today !events today !events today Displays the events upcoming in the next 24 hour period
!events now OR !events current OR !events ongoing !events now !events now Displays all events that are ongoing currently
!help !help (command) (sub-command) !help event create Displays help information for the specified commands/sub commands