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 | |||
|---|---|---|---|
| create | Starts cal 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 properties | /calendar review | elevated |
| confirm | Commits the changes made in the wizard | /calendar confirm | elevated |
| cancel | Cancels the wizard | /calendar cancel | elevated |
| delete | Deletes the calendar | /calendar delete (calendar) | elevated |
| edit | Starts the edit wizard | /calendar edit (calendar) | elevated |
/displaycal commands
| Command | |||
|---|---|---|---|
| new | Creates a new auto-updating calendar overview message | /displaycal new (time) (calendar) | elevated |
| update | Updates an existing calendar overview | /displaycal update [message-id] | elevated |
/event commands
| Command | |||
|---|---|---|---|
| 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) | privileged |
| end | Sets the event's end | /event end [yyyy] [MM] [dd] (hh) (mm) | 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's properties | /event review | privileged |
| confirm | Commits the changes made in the wizard | /event confirm | privileged |
| cancel | Cancels the 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 | |||
|---|---|---|---|
| upcoming | Lists the next X upcoming events | /events upcoming (number) (calendar) | everyone |
| ongoing | Lists the 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 | |||
|---|---|---|---|
| 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 | 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 | /rsvp limit [event-id] [limit] (calendar) | 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 | |||
|---|---|---|---|
| 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 | /announcement 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 publish [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 | |||
|---|---|---|---|
| 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 bbe 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 |
| 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 | |||
|---|---|---|---|
| discal | Displays information about the bot | /discal | everyone |
| linkcal | Provides info and a link to view the guild's calendar | /linkcal (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 | patron-only, dev-only (work in progress) |
| help | Links to the commands page | /help | everyone |