Commands

DisCal uses a simple-to-understand permission scheme for handling access to commands.

Elevated

Requires ADMINISTRATOR or MANAGE_SERVER permission nodes, or being the guild owner

Privileged

Requires DisCal control role (default control role is @everyone)

Everyone

Everyone will always be able to access (unless commands are disabled for the channel)

Patron-Only

Requires guild to be a patron-guild at the early access tier or higher

Dev-Only

Only DisCal Developers are able to use these commands

/calendar commands
Command	Description	Usage	Access
view	Provides info and a link to the Guild's calendar	/calendar view (overview) (calendar)	Everyone
list	Lists all calendars owned by the guild	/calendar list	Everyone
create	Starts calendar create wizard	/calendar create [name] (desc) (timezone) (host)	Elevated
name	Sets the calendar's name	/calendar name [name]	Elevated
description	Sets the calendar's description	/calendar description [description]	Elevated
timezone	Sets the calendar's timezone	/calendar timezone [timezone]	Elevated
review	Displays calendar wizard properties	/calendar review	Elevated
confirm	Commits the changes made in the wizard	/calendar confirm	Elevated
cancel	Cancels the calendar wizard	/calendar cancel	Elevated
delete	Deletes the calendar	/calendar delete (calendar)	Elevated
edit	Starts the calendar edit wizard	/calendar edit (calendar)	Elevated

/displaycal commands
Command	Description	Usage	Access
new	Creates a new auto-updating calendar overview message	/displaycal new (time) (calendar)	Elevated

/event commands
Command	Description	Usage	Access
view	Displays the event's details	/event view [event-id] (calendar)	Everyone
create	Starts the event create wizard	/event create (name) (calendar)	Privileged
name	Sets the event's name	/event name [name]	Privileged
description	Sets the event's description	/event description [desc]	Privileged
start	Sets the event's start	/event start [yyyy] [MM] [dd] (hh) (mm) (keep-duration)	Privileged
end	Sets the event's end	/event end [yyyy] [MM] [dd] (hh) (mm) (keep-duration)	Privileged
color	Sets the event's color	/event color [color]	Privileged
location	Sets the event's location	/event location [location]	Privileged
image	Sets the event's image	/event image [link]	Privileged, gif support patron-only
recur	Toggles whether the event recurs, and how it recurs	/event recur (enable) (frequency) (interval) (count)	Privileged
review	Displays the event wizard's properties	/event review	Privileged
confirm	Commits the changes made in the wizard	/event confirm	Privileged
cancel	Cancels the event wizard	/event cancel	Privileged
edit	Starts the event edit wizard	/event edit [event-id] (calendar)	Privileged
copy	Copies an existing event's details to a new event	/event copy [event-id] (calendar) (target-cal)	Privileged
delete	Deletes an event	/event delete [event-id] (calendar)	Privileged

/events commands
Command	Description	Usage	Access
upcoming	Lists the next N upcoming events	/events upcoming (number) (calendar)	Everyone
ongoing	Lists any ongoing events	/events ongoing (calendar)	Everyone
today	Lists the events occurring in the next 24 hours	/events today (calendar)	Everyone
range	Lists the events found in the date range provided	/events range [yyyy/MM/dd] [yyyy/MM/dd] (calendar)	Everyone

/rsvp commands
Command	Description	Usage	Access
ontime	RSVPs as going to the event on time	/rsvp ontime [event-id] (calendar)	Everyone
late	RSVPs as going to the event, but arriving late	/rsvp late [event-id] (calendar)	Everyone
not-going	RSVPs as not going to the event	/rsvp not [event-id] (calendar)	Everyone
unsure	RSVPs are unsure if you will be able to attend	/rsvp unsure [event-id] (calendar)	Everyone
remove	Removes your RSVP status from the event	/rsvp remove [event-id] (calendar)	Everyone
list	Lists who as RSVPed to the event	/rsvp list [event-id] (calendar)	Everyone
limit	Sets the max number of people allowed to attend. -1 to disable the limit		Privileged
role	Sets the role assigned when RSVPed to the event. '@everyone' to disable. *Note: these roles are currently not automatically removed	/rsvp role [event-id] [role] (calendar)	Elevated, patron-only

/announcement commands
Command	Description	Usage	Access
create	Starts the announcement create wizard	/announcement create (type) (channel) (minutes) (hours) (calendar)	Privileged
type	Sets the announcement type. Valid types: UNIVERSAL, SPECIFIC, COLOR, RECUR	/announcement type [type]	Privileged
event	Sets the announcement's event. Only needed when using SPECIFIC or RECUR types	/announcement event [event-id]	Privileged
color	Sets the announcement's color. Only needed when using COLOR type	/announcement color [color]	Privileged
channel	Sets the channel the announcement will be posted in	/announcement channel [channel]	Privileged
minutes	Sets the minutes before an event to announce. Added to hours	/announcement minutes [number]	Privileged
hours	Sets the hours before an event to announce. Added to minutes	/announcements hours [number]	Privileged
info	Sets the additional info to be posted along with the event. No text input to remove	/announcement info (text)	Privileged
calendar	Sets the calendar the announcement will read from. Defaults to 1 (main calendar)	/announcement calendar [calendar]	Privileged
publish	Toggles if the announcement should be pushed to channel subscribers	/announcement public [true/false]	Privileged, Patron-only
review	Displays the announcement properties in the wizard	/announcement review	Privileged
confirm	Commits the changes made in the wizard	/announcement confirm	Privileged
cancel	Cancels the announcement wizard	/announcement cancel	Privileged
edit	Starts the announcement edit wizard	/announcement edit [announcement-id]	Privileged
copy	Copies an existing announcement to a new one	/announcement copy [announcement-id]	Privileged
delete	Deletes an announcement	/announcement delete [announcement-id]	Privileged
enable	Sets whether an announcement is enabled	/announcement enable [announcement-id] [true/false]	Privileged
view	Displays an existing announcement's properties	/announcement view [announcement-id]	Everyone
list	Lists announcements, -1 for all	/announcement list [amount]	Everyone
subscribe	Subscribes to an announcement to be pinged when it is posted	/announcement subscribe [announcement-id] (user/role)	Everyone
unsubscribe	Unsubscribes to an announcement, to stop being pinged when it is posted	/announcement unsubscribe [announcement-id] (user/role)	Everyone

/settings commands
Command	Description	Usage	Access
view	Displays the current settings for the guild	/settings view	Elevated
role	Sets the role required to use privileged commands	/settings role [role]	Elevated
announcement-style	Changes the style announcements will be posted as	/settings announcement-style [style]	Elevated
language	Changes the language the bot will use in responses	/settings language [lang]	Elevated
time-format	Changes what format to display date/time when needed	/settings time-format [format]	Elevated
keep-event-duration	Toggles whether to keep an event's duration when changing the start or end time (default false)	/settings keep-event-duration [true/false]	Elevated
branding	Toggles between using DisCal branding or the guild's name/image where possible	/settings branding [true/false]	Elevated, patron-only

All other commands
Command	Description	Usage	Access
discal	Displays information about the bot	/discal	Everyone
linkcal	Provides info and a link to view the guild's calendar	/linkcal (overview) (calendar)	Everyone
time	Displays the current time as seen by the calendar's timezone	/time (calendar)	Everyone
addcal (WIP)	Starts the process to add a pre-existing calendar	/addcal	Elevated, patron-only, dev-only (work in progress)
help	Links to the commands page and documentation	/help	Everyone