Group Sessions
A group session (or sprint) is a competitive writing event with other participants from a channel, where you each aim to write as much as you can in a given time period!
Starting a Group Session
A group session can be started using the /session group command! There are several options to fill out, and not choosing any will result in the default values for the server being used.
WriterStats Server Moderators can set server defaults for group sessions using the bot! You can see more on how to do this on the server settings page!
The various options for the command are shown below:
session_length: Optional. How long you want the session to be, in minutes. Defaults to 15 minutes. If you want more detailed control, you can use the hours/minutes/seconds format. All 3 fields must be provided.random_length: Optional. Let WriterStats pick a random length for your session, based on your criteria! Pick from the options provided.start_delay: Optional. How long before the session starts, in minutes. Defaults to 1 minute. Must be less than 60 minutes.end_delay: Optional. How long participants will have to submit their final count, in minutes. Defaults to 2 minutes, which can be overriden in server settings. Must be less than 30 minutes.join_type: Optional. Whether you wish to join as a paricipant or a spectator. This is participant, by default.starting_count: Optional. The number of words you are starting with. This overrides your project wordcount when calculating your net change at the end, but does not directly change it.project_name: Optional. The name of the project you wish to write in. This sets your active project, and defaults to your active project.
You cannot fill out both the session_length and random_length fields!
Joining a Group Session
The creator of a group session is automatically added to the session! Other server members can join a group session using the /session join command!
The two options for this command are shown below:
starting_count: Optional. The number of words you are starting with. This overrides your project wordcount when calculating your net change at the end, but does not directly change it.project_name: Optional. The name of the project you wish to write in. This sets your active project, and defaults to your active project.
Spectating a Group Session
If you wish to join a group session for a non-writing task or to accompany those taking part in the session, you can use the /session spectate command! This lets you join the session as a spectator, and be mentioned for all of the session's events.
Leaving a Group Session
You can leave a group session using the /session leave command.
Cancelling a Group Session
The owner of a group session can cancel a group session using the /session cancel command.
WriterStats Server Moderators have the ability to cancel any group session, including ones they haven't created.
Viewing Information for a Group Session
You can view information for the currently running group session using the /session info command, which displays information such as when the session starts, finishes and the number of members in the session.
The /session info command can be used to see how much longer you have in a session!
Group Session Notifications
WriterStats allows you to be notified whenever a group session is scheduled in a channel!
Subscribing to Notifications
You can subscribe to notifications using the /notifications subscribe command, and by providing the number of notifications you wish to receive. For example, if you want to be notified for the next 5 group sessions in the channel, provide 5 in the number_of_notifications field.
If you wish to be notified for all group sessions in a channel indefinitely, provide 0 in the number_of_notifications field.
Unsubscribing from Notifications
You can unsubscribe from notifications in a channel using the /notifications unsubscribe command.
Viewing your Notifications Settings
You can view your notification settings for a given channel using the /notifications view command.
Switching project or starting count in a Group Session
To switch your project and/or starting count in a group session, you can use the /session switch command, completing a "stretch" of the session (and logging a session in your user) and rejoining the group session with a single command.
The fields for this command are explored in the /session join and /session complete sections of the guide.
Completing a Group Session
A group session can be completed using the /session complete command, which is detailed on the Completing a Session page.
What's Next?
You have now learned how to run group sessions in your servers! But, what if you write outside of one and want to log it with WriterStats? Move on to the next page to learn how to log writing sessions you performed outside of the bot!