-
-
Notifications
You must be signed in to change notification settings - Fork 0
SprintAdmin
Commands available to guild owners, administrators and people with a role named SprintAdmin. Some commands are also available to people with a SprintMC role.
A Sprint Admin (A) is someone with extra privileges on a server. A server's owner, its administrators, and anyone with a role named Sprint Admin
. For simplicity, they'll all be called SprintAdmin here. Sprint Admins can configure Sprinto, for example, they can set which channels sprints run in, or remove all users from the ping list.
Sprinto considers anyone who has a role named Sprint Admin
or Sprint Admins
(space optional, any capitalization) to be a Sprint Admin.
A Sprint MC (MC) is a less powerful role (which Sprint Admins also automatically have). Sprint MCs can cancel sprints, or remove a single user from the the ping list, or run "locked" sprints which ordinary users cannot cancel.
Sprinto considers anyone who has a role named Sprint MC
or Sprint MCs
(space optional, any capitalization, and will also accept Sprinto MC) to be a Sprint MC. Additionally anyone with Sprint Admin powers also has Sprint MC powers.
Sprinto doesn't create the "Sprint MC" or "Sprint Admin" roles for you, so you'll have to create them the same way as creating any other Discord role. The roles are both optional. There's no requirement to have anyone with either role to run sprints. On a small server you might create the Sprint MC role and give it to everyone just so everyone can easily cancel sprints.
More fine grained control of Sprinto privileges is not available. If you need a more specific role for your server please provide _feedback
and tell me about your situation.
- "Please" is required for many commands. Instead of "please" you can also use "pls", "thanks" or "merci". Please is also used for some non-admin commands like to set your word count to a negative number.
- More SprintAdmin and SprintMC commands may be added in future.
- Guild owner and administrators automatically have Sprint Admin and Sprint MC powers.
Command | Description |
---|---|
_cancel please |
(MC) Forces a running sprint to end, regardless of how many sprinters have joined. |
_sprint lock |
(MC) Begins a sprint which cannot be cancelled except by a Sprint MC. See Sprint for the other parameters you can add to a _sprint
|
_sprint please |
(MC) SprintMCs who add "please" to a sprint command can set it to run for longer, or have increased "ready" time before it starts. |
_nudge please |
(MC) Moves the sprint on to the next stage immediately, typically only used for testing or debugging purposes. |
_forgetuser 123456789 |
(MC) Stops a user getting pinged at the start of sprints, as if they had typed _forgetme themselves. Replace 123456789 with the ID of the Discord user. If you can't see their user id, you might have to turn on "Developer Mode" in Discord settings, then "Copy ID" will appear when you right click the user. You can also use their user name (with no @ ), if they haven't left the server. Use _forgetallusers (A) to forget all users. |
_pinguser <user> <number> |
(MC) Turn pings on for a user, like if they typed _pingme . Replace <number> with the number of sprints. Default is 3. For "never" use 0. For always, use 1000. |
Command | Description |
---|---|
_set_sprinting_channel_here |
(A) Whitelist a channel to allow sprints to be run in it. Multiple channels can be selected by typing this in multiple channels. |
_unset_sprinting_channel_here |
(A) Remove a channel from the whitelist. If none are left on the whitelist, sprinting is not restricted to any channel. |
_reset_sprinting_channels |
(A) Clear and stop using a whitelist, not restricting sprints from being run anywhere (resetting to the default state) |
Note: Sprinto does not have a concept of secret or hidden channels. Sprinto will attempt to point users to a sprint room even if they don't have permission to see or use it.
If members of your Discord server can self assign roles (for example via another bot), then you may have a role named "@Sprinters" and want Sprinto to always mention (ping) those users when a new Sprint starts. You can do that with: _always_ping_role Sprinters
Command | Description |
---|---|
_always_ping_role <role> |
(A) The <role> will always be pinged whenever a new sprint starts. Replace <role> with the name or ID of a role. You may wish to use this in combination with _setAutoPings off (to stop Sprinto pinging individual users at the start of a sprint) |
_never_ping_role <role> |
(A) Remove <role> from the "always ping" list. |
_clear_ping_roles |
(A) Remove all roles from the "always ping" list. |
Notes:
- These settings are per channel: if you want a role pinged in multiple sprint channels then run
_always_ping_role role
in each. Multiple roles and different combinations of roles can be used in each channel. - These commands are only for mentions (pings) at the start of sprints. These commands will not cause Sprinto to assign anyone to the roles.
- Sprinto will still track recent sprinters and ping them (as well as the roles you choose). If sprinters want to always be pinged they can also use
_always
to be specifically pinged at the start of sprints. - Use
_sprint noping
to start a sprint without pinging any roles or user.
Sprinto Voice is currently in beta. These commands may not be available on your server unless you've requested it.
Sprinto will automatically join the first voice channel it finds with "sprint" in the name (e.g. "🔊 Sprinting talk"). You can set it manually with _set_voice_home_here
, or disable Sprinto using voice with _voice_home_off
. If Sprinto's previous voice channel is removed you may have to use _reset_voice_home
to find another one.
Note again, this feature isn't yet widely enabled. Request it on Sprinto Planet.
Command | Description |
---|---|
_set_voice_home_here |
(A) Join a voice channel first, then enter _set_voice_home_here . This sets Sprinto's voice channel (server-wide setting) |
_reset_voice_home |
(A) Set Sprint's voice channel to the default (i.e. any voice channel with "sprint" in the name) |
_voice_home_on |
(MC) Allow Sprinto to join voice channels on your Discord server (defaults to on) |
_voice_home_off |
(MC) Stop Sprinto joining voice channels |
All settings can be set to on
, off
or default
Command | Description |
---|---|
_settings |
Display values of channel settings. |
_setShowPatreonRequests off / on
|
(A) Show / don't show requests to join Sprinto's Patreon (or to buy Sprinto merch) at the end of sprints. You can also use _patreon and _merch for links. |
_setShowQuotes off / on
|
(A) Hide or show quotes at the end of sprints. Quotes are meant to be thought provoking and inspiring. If you find ones that are instead overly prescriptive (about grammar or what a "real" writer is), or otherwise problematic, please report them by leaving _feedback with the quote, or mention it on the support Discord. |
_setShowPS off / on
|
(A) Show or hide all post-sprint text. Turning this off will hide quotes, updates, combined word counts, _forgetme help, and everything else which would otherwise be shown after the scoreboard. |
_setAutoPings off / on
|
(A) Set whether sprinters who join should automatically be pinged (mentioned) at the start of the next few sprints. If off, users will not be added to the list of users be pinged at the start of future sprints. Users can still manually use _pingme or _always . Even with autopings off, the _always_ping_role setting will be respected, so, for example, if you have a @sprinter role which users can add themselves to and use _always_ping_role @sprinter , then Sprinto will alert them of new sprints via that role. Use _forgetallusers (A) to remove all existing individual user pings. |
_setShowWallTime off / on / sometimes
|
(A) Show or hide display of the ending "wall time" when sprint starts. e.g. "(Runs until ⏰ :30)". With sometimes (the default) it will only be shown if the sprint ends near an exact minute. With on it will be always shown (at least for sprints longer than 2 minutes). Wall time also shown with the _time command for both on and sometimes . |
- Setup (setting up Sprinto)
- ActiveSprinter (another role used by Sprinto)
⸻ Sprinto documentation has moved to sprintobot.com ⸻