Commands

Usage: p? setup This command will attempt to create the channel #events under a new category, events. This channel will automatically be registered as the events channel.

If the bot fails to create the #events channel, it will let you know and you will have to create one manually. Once a suitable channel has been created, you can set it as the events channel with the configure channel command.

This command can be run however many times, for instance if you accidentally remove the events channel, however, it will always create a new category, channel and role so you need to delete the old stuff manually.

You can always manually set the event channel with the configure channel command.

Note

This command can only be executed by the server owner.

Usage: p? configure When this command is called without a subcommand, it will open up an interactive settings menu.

Note

This command is only available to members with permission to configure roles.

Usage: p? configure channel [channel type] This command sets the channel it is executed in to [channel type]. Available channel types are:

Example

Note

This command is only available to members with permission (see configure role for details).

Certain commands require special permission. This command is the way to give those permissions to roles on your server.

Usage: p? configure role [@role] This command allows you to change the permissions for a certain [@role]. Roles that have the administrator permission already have all permissions for this bot.

Commands that require special permission to use are:

• schedule
• remove
• update
• kick
• soundboard add
• soundboard remove
• configure channel
• configure role
• configure timezone
• notice new
• notice edit

Example

Note

This command is only available to members with permission (see configure role for details).

Usage: p? configure timezone This command will give you a dialogue to change your guild's time zone.

Note

This command is only available to members with permission (see configure role for details).

Usage: p? schedule (name) (date & time) (description) (limit) (-noroles) Starts the scheduling process for a new event. Note that if any of the optional arguments above are provided, the corresponding step below will be skipped. The bot will ask you to give a title, date and time, description, optional roles and people limit for your new event. If at any time you want to cancel the scheduling process, type cancel. The process is as follows:

1. Name

First you will be asked to provide a name for the event.

If the (name) optional argument is provided, this step will be skipped.

2. Date & Time

Next you will be asked to give a date and a time for the event. It is important to note that you must specify the date AND time, e.g. June 15th 2020 at 14:00.

Almost all date formats are supported. See date for details. If the date specified includes a weekday, the event will be set as recurring at the same time every week. You can also specify that an event is yet to be dated by entering TBD as the date.

If an event is recurring then instead of removing the event once it starts, the attendant list will simply be cleared.

At 10:00 A.M. on a day with a recurring event the bot will post a little message in the designated friendly channel (see configure channel for details)

If the (date & time) optional argument is provided, this step will be skipped.

3. Description

Third, you will be asked to provide a description for your event.

If the (description) optional argument is provided, this step will be skipped.

4. Roles

After asking you for a description, the bot will ask you to react to a message with emojis to represent any event specific roles. Once you have added all your reactions, type done in the text channel. You will then have to give a name and a limit of people for each role.

If you are not in need of any event specific roles, type done without reacting to the message with any emojis.

These roles are purely visual and no actual server roles are added.

If the (-noroles) optional flag is provided, this step will be skipped.

5. Limit

Lastly, you will be asked to specify how many people in total can join your event. If the (limit) optional argument is provided, this step will be skipped.

Event and role limits

Role limits and event limits work exactly the same. If an event or role is full, you will not be able to join that event or that role. If all roles are full but there is still space left in an event, new attendants will not get a role but they will still be added.

If you do not want a limit for your role or event, simply give 0 when you are asked for a limit.

Owner

When scheduling an event, you will be registered as the event owner and thus do not require any other event related permissions when executing commands related to this event.

Examples

Notes

1. You cannot change the order of the optional arguments. Your first argument will always be interpreted as (name), the second as (date & time) and so on. The exception is that you can specify -noroles anywhere.
2. This command is only available to members with permission (see configure role for details).

Usage: p? remove [event id] Removes the event number [event id].

Example

Note

This command is only available to members with permission (see configure role for details).

Usage: p? join [event id] Signs you up for event number [event id] and adds your name to the list of people showing up.

You can also use this command to change your role in an event. To do so, simply join the event again.

Example

Usage: p? leave [event id] Use this command to leave event number [event id] and remove your name from the list of people showing up.

Example

Usage: p? update [event id] [what to update] [new value] This command sets the field [what to update] to [new value] for event number [event id]. Available fields to update are

Editing roles

When editing a role, the command syntax becomes as follows: p? update [event id] role [the role's emoji] [attribute] [new value] Available values for [attribute] are

Examples

p? update 2 description Free oj for everyone who shows up. This would update the description for event number 2 to Free oj for everyone who shows up..

p? update 1 role :thumbsup: limit 5 This would update the role with the :thumbsup: emoji and set its limit to 5.

p? update 1 role :thumbsup: emoji This would allow you to change this role's emoji from :thumbsup:.

Note

This command is only available to members with permission (see configure role for details).

Usage: p? kick [@member] [event id] This command kicks member @member from event number event id

Example

Note

This command is only available to members with permission (see configure role for details).

Usage: p? when [event id] [UTC offset] This command returns the start time with regards to the given UTC offset. It also returns the time until the event starts.

Example

Usage: p? owner [event id] This command will make the bot reply with the current owner of event with id [event id]

Usage: p? salt This command gives you a little demotivational quote and ups the count of salty nugs you have had.

Usage: p? saltboard This command prints a salty leaderboard so you can ascertain who is the saltiest of all your friends.

Usage: p? eyebleach This command give you a cute image of something or other from /r/eyebleach.

Usage: p? clowntime It's clowntime!

Usage: p? orangejuice This command posts a picture of high quality orange juice! The best in all the land!

Usage: p? sorry Use this command to apologise to the bot if you have been mean to it. why would you do that though? :'(

Usage: p? roll [list of names] The bot selects a random person from the [list of names] provided.

Example

Usage: p? julia (colour scheme) (complex number) This command generates a random julia set unless a (complex number) is specified, then it will generate the set with the given constant. You can choose the colour scheme by specifiyng (colour scheme).

If neither parameter is specified, you will receive a random Julia set.

Example

Usage: p? chill This command will only work when you are connected to a voice channel.

This command makes the bot join your voice channel and starts playing some chill tunes.

Usage: p? chill stop This command makes the bot stop playing chill tunes and leave your voice channel.

Usage: p? chill volume [volume] Where

This command sets the chill tunes volume to [volume]

Example

Usage: p? chill nowplaying This command displays the currently playing song.

Usage: p? log The bot messages you with a log of recent activity in the events channel. The log only consists of commands found under Event related commands.

Usage: p? clean This command clears the channel it is executed in. You will be asked to confirm this action.

Note

This command is only available to members with the administrator permission.

Usage: p? readycheck [list of mentions] (-expires [date]) This command invokes a ready check for all members listed. The [list of mentions] is a list of @mentions for members or roles you want to include in the ready check.

Use the optional argument -expires [date] to specify when the readycheck should expire. If this argument is not present, there expiration time will be set to 24 hours (see date for more details about date formats).

Example

Usage: p? calculate [query] This command queries wolfram alpha for your [query] and returns the result.

Example

Usage: p? spoiler [message] This command reuploads all attachments as spoilers with the message [message] attached.

Example

Usage: p? spoiler delete This command deletes the last message the user posted with the spoiler command.

Usage: p? poll [name] [options] This command will create a poll with the name [name] and the options [options]

Example

Notes

1. The number of options for a poll is limited to 20.
2. After some time without any activity, the poll will stop working

Usage: p? notice new This command creates a new notice message that can be edited by everyone with permission to display whatever you want. You can edit this message with the notice edit command.

Note

This command is only available to members with permission (see configure role for details).

Usage: p? notice edit [message id] [new message] This command will edit the notice message with id [message id] to display the new message [new message]. You do not need to surround [new message] with quotes.

Notes

1. You need to be in the same channel as the notice message you want to edit.
2. This command is only available to members with permission (see configure role for details).

Usage: p? forget_me This command will purge all stored information this bot has stored on you which is:

• Salt count
• All reminders you have set and have not yet deleted
• All spoiler messages you have sent with the spoiler command and have not yet been deleted
• You will be removed from all scheduled events

Usage: p? soundboard When this command is invoked without a subcommand it will list all the available sounds and you will be able to pick one to play.

Usage: p? soundboard add [name] To add a new sound, upload a mp3 or wav file to any channel the bot has access to and put this command in the comment when uploading. The new sound will be called [name].

Example

Notes

1. Sound names cannot include spaces.
2. If you delete the message with the file upload, then that sound will no longer work.
3. This command is only available to members with permission (see configure role for details).
4. The maximum amount of sounds for a server is 19.

Usage: p? soundboard remove [name] This command will remove the sound called [name].

Example

Note

This command is only available to members with permission (see configure role for details).

Usage: p? soundboard play [name] This command will play the sound called [name].
To see all available sounds, use the Soundboard command.

Usage: p? soundboard rename [oldname] [newname] This command will rename the sound [oldname] to [newname].

Example

Usage: p? remindme [time] to [reminder] Where

Examples: p? remindme in 2 days to water my cactus This command would set a reminder for 2 days in the future to water your cactus. p? remindme tomorrow at 14:30 UTC-3 to put cookies in the oven This command would set a reminder for tomorrow at 14:30 UTC-3 time to put cookies in the oven.

Usage: p? remindme list (page) This command will give you a list of reminders you have set for yourself as well as their ids. If (page) is not specified, you will receive page one of the list. There are 10 reminders per page.

Example

Note

All times are in UTC.

Usage: p? remindme remove [reminder id] This command will remove the reminder with the given [reminder id]. You can check all your reminders and their ids with the remindme list command.

Example