Skip to content

Full Command Reference

John Grosh edited this page Oct 23, 2016 · 5 revisions

Spectra Commands (v3.2.2)

User Commands

about
Usage: %about
Aliases: botabout hello
This command displays basic information about the current state of the bot, as well as how to get in touch with the author.

achievements
Usage: %achievements [username]
Aliases: achieve awards
This command shows the specified user's (or your, with no input) achievements. These are small badges to show off your use and mastery of Spectra

achievements list
Usage: %achievements list
This command shows the full achievements list, with short descriptions of how to get each one.

afk
Usage: %afk [message]
This command marks you as Away From Keyboard. While away, whenever you are directly mentioned (and Spectra can see the mention), it will relay the info to you via a Direct Message. If you include a message when using the command, Spectra will also autoreply to the mention with your message. The next time you start typing or send a message, your AFK status will be automatically revoked.

archive
Usage: %archive <numposts> [channel]
This command is used to save all of the currently-visible text from the current chat, format it, and upload it for easy viewing and/or saving. This command requires a number of posts to archive (up to 1000), and optionally a channel to archive in. If you do not include a channel name, the archive will be of the current channel. You may only create archives where you can see the channel contents.

avatar
Usage: %avatar [username]
Aliases: avy avi
This command displays the given user's avatar (image), or your own if no user is provided. If possible, it will upload the image; otherwise it will provide a link.

channel
Usage: %channel [channel]
This command displays information about the given channel, or the current channel if none is provided. This can be used to show information about "hidden" channels as well. This is public information (Spectra doesn't need any permissions to view it), so please keep important or sensitive information out of channel topics. Use pins instead.

colorme
Usage: %colorme <color>
This command sets the color of your role. It can only be used if your color-determinant role (the role that controls your username color) has been added to the colorme list. The colormust be a #hex or integer code.

colorme list
Usage: %colorme list
This command lists the roles that can be recolored from the colorme command.

contest
Usage: %contest <subcommand>
This command is the hub for the contest commands. Spectra Contests are automated competitions. They are created with set time boundaries and rules, and only accept entries between the given times.

contest list
Usage: %contest list <current|ended|upcoming>
This command lists the current contests on the server. A time period must be specified (current contests, contests that have ended, or contests that have not started yet).

contest rules
Usage: %contest rules <contestname>
This command displays the rules that were set for a contest at creation, or upon last edit.

contest submit
Usage: %contest submit <contestname> <submission>
This command is used to submit an entry to a contest. Entries are in the form of text (or links). If a contest has image submission, it is recommened to use some image-hosting site, rather than Discord-hosting. Each user may only submit one entry; any entry after the first will overwrite the previous.

contest time
Usage: %contest time <contestname>
This command shows the time for a contest. For contests that have ended, it will show how long ago they ended. For current contests, it will show how much time remains. For upcoming contests, it will show how long until it starts.

donate
Usage: %donate
This command provides information on how to donate to the author of Spectra, jagrosh. It includes links for how to help him out, even if you don't want to donate money! Also, it shows the top donators.

draw
Usage: %draw [hexcolor]
This command draws an electric wave using the same algorithm that Spectra uses to generate avatars. If no color is provided, it will generate it in a random color. To provide a color use hex (like #8FC73E) or an integer value (like 9422654).

emote
Usage: %emote <emote>
Aliases: emotes emoji charinfo
This command shows detailed information about an emote, emoji, or character.

emote list
Usage: %emote list
This command shows the emotes that are currently available on the server

google
Usage: %google <query>
Aliases: g websearch
This command finds the top result on Google for the given query.

image
Usage: %image <query>
Aliases: img pic
This command searches Bing for an image matching the given query.

imgur
Usage: %imgur <url|attachment>
This command uploads the given image URL or attachment to imgur, and returns the link of the new image.

info
Usage: %info [username]
Aliases: i userinfo
This command provides basic information about the given user, or the caller of the command if no user is provided. If used within a guild, and the given user is in the guild, additional information about the user in the guild will also be provided.

invite
Usage: %invite
This command provides a link for inviting Spectra to a server, as well providing an invite to jagrosh's bot server.

makebot
Usage: %makebot
This command writes a new bot in python for the discord.py library. The commands for the bot are selected from Spectra's tag database.

names
Usage: %names [username]
Aliases: pastnames namehistory
This command displays a user's (or your, if no user is provided) previous usernames. These are only tracked during the time Spectra can see the user, and nicknames are not tracked.

nick
Usage: %nick [nickname]
this command is used to set a user's nickname if the user has the Change Nickname permission and Spectra has the Manage Nicknames permissions (for mobile users)

ping
Usage: %ping
Aliases: pang peng pong pung
This command checks the difference in time between when discord recieves the command and when discord receives Spectra's response. The response is then edited to reflect the difference.

profile
Usage: %profile [username]
Aliases: p
This command is used to keep track of user profiles, with information for various games and services. Profiles are maintains across all servers.

profile clear
Usage: %profile clear <field>
Thic command clears the specified field in the profile.

profile 3ds
Usage: %profile 3ds <info>
This command sets the 3DS Friend Code field in the profile.

profile about
Usage: %profile about <info>
This command sets the AboutMe field in the profile.

profile battle
Usage: %profile battle <info>
This command sets the Battle.net account field in the profile.

profile email
Usage: %profile email <info>
This command sets the E-mail address field in the profile.

profile league
Usage: %profile league <info>
This command sets the League of Legends username field in the profile.

profile maplestory
Usage: %profile maplestory <info>
This command sets the Maplestory username field in the profile.

profile minecraft
Usage: %profile minecraft <info>
This command sets the Minecraft username field in the profile.

profile monhun
Usage: %profile monhun <info>
This command sets the MonsterHunter info field in the profile.

profile nnid
Usage: %profile nnid <info>
This command sets the NNID (Nintendo Network ID) field in the profile.

profile psn
Usage: %profile psn <info>
This command sets the PlayStation Network info field in the profile.

profile reddit
Usage: %profile reddit <info>
This command sets the Reddit username field in the profile.

profile smash
Usage: %profile smash <info>
This command sets the Smash Bros info field in the profile.

profile smite
Usage: %profile smite <info>
This command sets the Smite username field in the profile.

profile splatoon
Usage: %profile splatoon <info>
This command sets the Splatoon info field in the profile.

profile steam
Usage: %profile steam <info>
This command sets the Steam account field in the profile.

profile timezone
Usage: %profile timezone <info>
This command sets the Timezone field in the profile.

profile twitch
Usage: %profile twitch <info>
This command sets the Twitch channel field in the profile.

profile twitter
Usage: %profile twitter <info>
This command sets the Twitter handle field in the profile.

profile warframe
Usage: %profile warframe <info>
This command sets the Warframe info field in the profile.

profile xbox
Usage: %profile xbox <info>
This command sets the XBox Live info field in the profile.

profile youtube
Usage: %profile youtube <info>
This command sets the YouTube channel field in the profile.

reminder
Usage: %reminder <time> <message>
Aliases: remind remindme
This command is used to set reminders. The reminder will be sent to the channel it was set in (or in DMs if you set it in DMs or the channel is no longer available).

reminder list
Usage: %reminder list
This command lists all of the reminders you have set, as well as where they are set for.

reminder remove
Usage: %reminder remove <index>
Aliases: delete cancel clear
This command cancels a reminder. The index must be the number of the given reminder when using %remind list

roleme
Usage: %roleme <rolename>
This command gives you a role if an admin has set it to be a self-assignable role. By default, no roles are self-assignable.

roleme list
Usage: %roleme list
This command lists the roles that can be self-assigned from the roleme command.

roll
Usage: %roll <[numRolls]#[numDice][<d|D>numSides][<+|->modifier]>
This command is used for rolling one or more sets of dice. Each set must must include a number of dice, and number of sides, or a modifier (or any combination). The format to roll 3 d20 dice with a positive modifier of 4 would be 3d20+4. Multiple sets like this can be used, and should be separated by commas. Additionally, any missing numbers will be replaced by the defaults (1d6+0). So, d30 will roll 1d30+0.

room
Usage: %room [command]
This command is used for users on the server to make and manage their own private text channels or temporary voice channels. These channels are hidden from all users (except those with the Administrator permission).

room invite
Usage: %room invite <username> to [channel]
This command is used to invite a user to a private room. If the room is locked, only the owner can invite

room join
Usage: %room join <roomname>
This command is used to join a private room on the server.

room kick
Usage: %room kick <username>
This command kicks a user from a private room you own. Once kicked, they cannot join unless invited back.

room leave
Usage: %room leave [roomname]
This command removes you from a private or permanent Spectra room.

room list
Usage: %room list
This command shows the list of private rooms that you can join. Locked rooms, user-created rooms, and rooms you are in are not shown.

room list all
Usage: %room list all
Aliases: full
This command shows the full list of private rooms that you can join. Locked rooms, and room you are already in are not shown.

room lock
Usage: %room lock [channel]
This command locks a private room you own. Once locked, no users can join themselves; they must be invited by the owner. Also the room will not appear in the room list.

room remove
Usage: %room remove [channel]
Aliases: delete
This command allows a user (or an Admin) to remove a private text room.

room text
Usage: %room text <room_name>
This command creates a new private text channel that only the owner (and any users with the Administrator permission) can see. After creation, the owner can change the topic and settings for the channel.

room topic
Usage: %room topic [topic]
This command sets the topic of a private room you created.

room tts
Usage: %room tts <true|false>
This command can be used to enable or disable text-to-speech in a private room you own

room voice
Usage: %room voice <room name>
This command creates a temporary voice channel. It will be automatically deleted when there are no users left in it.

find
Usage: %find <query>
Aliases: ctrlf
This command searches through past messages for messages containing the provided text. The search is not case-sensitive

server
Usage: %server
Aliases: serverinfo srvr guildinfo
This command provides basic information about the current server

server mods
Usage: %server mods
Aliases: admins
This command shows which mods and admins are available, sorted by status.

server playing
Usage: %server playing [game name]
Aliases: games
This command shows the most-played games on the server (currently), and can show who is playing a specific game.

server plot
Usage: %server plot
Aliases: plotjoins
This command shows a plot of the joins of the users currently on the server. This is not accurate for a full history (since it only looks at current members), but is useful for showing trends.

server settings
Usage: %server settings
This command shows the settings for the current server, including welcome/leave messages, prefixes, and tag commands.

speakerphone
Usage: %speakerphone
This command (upon connection) joins the current text channel to another text channel where the command is used. This could be anywhere, so you never know who you might talk to! To hang up, use the command again.

stats
Usage: %stats
Aliases: statistics
This command shows various statistics, including uptime, command usage, and global activity.

tag
Usage: %tag <tagname> [tag arguments]
Aliases: t
This command is used to create, edit, and view "tags". Tags are a method of storing text for easy recollection later. Additionally, some scripting-esque elements can be used to provide extra functionality. See https://github.com/jagrosh/Spectra/wiki/JagTag for available elements.

tag create
Usage: %tag create <tagname> <tag contents>
Aliases: add
This command creates a new local tag for the current guild (if the tag doesn't exist). This tag is owned by the creator, and can only be edited or deleted by that user. Note: Anyone found creating offensive or not-safe-for-work tags is at risk of being blacklisted from using Spectra

tag createglobal
Usage: %tag createglobal <tagname> <tag contents>
Aliases: addglobal creategeneric
This command creates a new global tag. This tag is owned by the creator, and can only be edited or deleted by that user. Note: Anyone found creating offensive or not-safe-for-work tags is at risk of being blacklisted from using Spectra

tag delete
Usage: %tag delete <tagname>
Aliases: remove
This command deletes a tag if you own it. If you are a server moderator and don't want a tag to be displayed, consider using tag override to "delete" it from the current server.

tag edit
Usage: %tag edit <tagname> <new contents>
This command edits a tag you own.

tag list
Usage: %tag list [username]
This command shows the list of tags you have created, or the list a different user has created, if you specify a username.

tag owner
Usage: %tag owner <tagname>
This command shows who the owner of a tag is. If a tag is overriden, the tag will appear to be "owned" by the server.

tag pull
Usage: %tag pull <tag(s)>
Converts all tags in the given list (that belong to the user) from global tags to local tags for the current server.

tag random
Usage: %tag random [tag arguments]
This command brings up a random tag from all of the existing tags (or all the tags by users on the server in local mode).

tag raw
Usage: %tag raw <tagname>
This command shows the contents of a tag without interpretting any of the scripting.

tag raw2
Usage: %tag raw2 <tagname>
Aliases: code
This command shows the contents of a tag without interpretting any of the scripting. It also puts it in a code block to escape most formatting.

tag search
Usage: %tag search [query]
This command searches for tag names that contain the given query. If no query is provided, the full tag list will be returned.

timefor
Usage: %timefor [username]
Aliases: tf time
This command uses the current time in conjunction with the 'timezone' field in a user's profile to determine what time it is for them.

timefor timezones
Usage: %timefor timezones
Aliases: list
This command provides a list of all available timezones. Note that these are separated by spaces.

welcomeguide
Usage: %welcomeguide
Aliases: newuserguide welcomeme
This command sends the server's current welcome DM to the user who uses the command. This is useful if and admin changes the DM, or if the user misses the DM.

youtube
Usage: %youtube <query>
Aliases: yt
This command finds the top Youtube result for the given query.

Moderator Commands

tag

tag override
Usage: %tag override <tagname> [new contents]
This command overrides or deletes local tags on the server. This can be used to "disable" unwanted tags, or to use an existing tag for something else.

tag override list
Usage: %tag override list
This command shows which tags have been overridden on the server.

ban
Usage: %ban <username> for [reason]
This command bans a user from the server, and deletes any of their messages from within the past 7 days.

ban byid
Usage: %ban byid <id> for [reason]
Aliases: hack
This command bans a user by their ID, even if they are not on the server or % cannot directly see their account

ban list
Usage: %ban list
This command references the server's banlist and lsits the users.

botscan
Usage: %botscan
This command searches for all bots on the current server. It looks for [BOT] accounts, as well as any account with the "Bots" role on the DiscordBots server.

clean
Usage: %clean <numposts> [username]
Aliases: clear purge
This command is used to delete a lot of posts very quickly. Without a given user, it will delete all posts within the number given. If a user is provided, it will look within the given number of posts and only delete posts by that user.

clean bots
Usage: %clean bots [numposts]
Aliases: bot
This command deletes posts (within the last 100) that were posted by a bot, or that begin with punctuation

clean containing
Usage: %clean containing <phrase>
Aliases: contains contain
This command deletes posts (within the last 100) that contain the given text

clean images
Usage: %clean images [numposts]
Aliases: image img embeds
This command deletes posts (within the last 100) that contain image uploads or embeds

clean links
Usage: %clean links [numposts]
This command deletes posts (within the last 100) that contain links

clean matching
Usage: %clean matching <regex>
Aliases: regex
This command deletes posts (within the last 100) that match the given regex

kick
Usage: %kick <username> for [reason]
This command kicks the specified user from the server.

mute
Usage: %mute <username> for <time> for [reason]
This command applies the "Muted" role to the specified user for the specified length of time. The muted role can be set up however you wish, although the recommended can be used with %mute setup. If a user is muted, leaves the server, and rejoins during the time they should still be muted, the role will be re-applied on entry.

mute list
Usage: %mute list
This command shows the list of users that are muted on the server.

note
Usage: %note <username> for [reason]
This command adds a note (tied to a user) to the modlog.

note check
Usage: %note check <user>
This command searches the modlog for any actions related to the user.

note checkid
Usage: %note checkid <userId>
This command searches the modlog for any actions related to the user.

softban
Usage: %softban <username> for [reason]
This command first bans a user from the server, clearing any messages within the past 24 hours. Shortly after, the user is unbanned, and a 24 hour mute is applied (they will be muted if they return to the server within 24 hours). This command is essentially clean, kick, and mute wrapped into one easy command.

unban
Usage: %unban <username> for [reason]
This command unbans a user from the server, allowing them to rejoin the server.

unban byid
Usage: %unban byid <id> for [reason]
Aliases: hack
This command unbans a user, given their ID

unmute
Usage: %unmute <username> for [reason]
This command removes the "Muted" role from the specified user. The muted role can be set up however you wish, although the recommended can be used with %mute setup.

Admin Commands

colorme

colorme add
Usage: %colorme add <rolename>
This command adds a role that can be recolored using the colorme command.

colorme remove
Usage: %colorme remove <rolename>
This command removes a role that can be recolored from the colorme command.

contest

contest create
Usage: %contest create <contestname> <time until start> | <length of contest> <rules>
Aliases: add
Thic command creates a new contest on the server. A name must be provided for the contest, as well as how long until the contest should start, how long the contest should run for, and the rules of the contest. A | (vertical pipe) MUST be included between the first set of time units (time until start) and the second set (length of contest).

contest edit
Usage: %contest edit <contestname> <change in starttime> | <change in endtime> [rules]
Thic command is used to edit an existing contest. The time values are the difference in time from the already-established endpoints. If rules are included they will replace the current rules. If no rules are included, the existing rules will bekept.

contest getentries
Usage: %contest getentries <contestname>
This contests compiles all the entries for a contest and uploads them (in a .txt file) to the current chat.

emote

emote add
Usage: %emote add <emotename> <image_link>
Aliases: create
This command can add emotes for use on your server only. Note that they will not work on other servers. Emote names cannot contain spaces or other special characters. Please kick the Emote Provider account from your server when you have finished adding and removing emotes. Thank you.

emote remove
Usage: %emote remove <emote>
Aliases: delete
Removes the given emote from your server.

roleme

roleme add
Usage: %roleme add <rolename>
This command adds a role that can be self-assigned using the roleme command.

roleme max
Usage: %roleme max <number>
This command sets the max number of self-assignable roles a user can give themself using the roleme command. Set this to 0 for no maximum.

roleme remove
Usage: %roleme remove <rolename>
This command removes a role that can be self-assigned from the roleme command.

room

room assign
Usage: %room assign <user>
This command converts a non-Spectra room to a room owned by the given user

room check
Usage: %room check
This command checks if a room is a Spectra room

room mode
Usage: %room mode <mode>
This command sets the mode for the room commands. In normal mode, users can create both private text channels and temporary voice channels. Textonly and Voiceonly are for limiting to one type, and NoCreation prevents creating new rooms.

room permanent
Usage: %room permanent <true|false>
This room is used to convert a regular (non-Spectra room) to a permanent room, or convert a Spectra room to a regular room.

tag

tag import
Usage: %tag import <tagname>
This command imports a tag as a psuedo-command on the server. For example, if the tag hug was imported, you would be able to use %hug instead of %tag hug

tag mirror
Usage: %tag mirror <servername>
This command allows the current server to "mirror" all tags from the provided server. This means that calling a tag here can use the version from any mirrored servers if the local version does not exist for this server.

tag mirror list
Usage: %tag mirror list
This command shows the list of servers that have their tags mirrored onto the server.

tag mode
Usage: %tag mode <mode>
This command sets the tag mode. In global mode, all existing tags are available on the server. In local mode, the only available tags will be those that were created by users on the server.

tag unimport
Usage: %tag unimport <tagname>
This command un-imports a tag from being a pseudo-command.

tag unmirror
Usage: %tag unmirror <servername>
This command un-mirrors a server, so its tags are no longer available on the current server.

mute

mute setup
Usage: %mute setup [confirmation]
This command sets up the "Muted" role on the server. The default configuration disallows sending messages in any channels, as well as being unable to connect to voice channels. It it recommened to create all channels on the server before running this setup.

announce
Usage: %announce <channel> <rolename> | <announcement text>
This command makes an announcement that mentions all users with the provided role, even if the role is not normally mentionable. The message will be appended with the role mention, unless {role} is included, which will be replaced by the mention.

cmd
Usage: %cmd <disable|enable|list>
This command (formerly known as "toggle"), is used to enable or disable commands on the server. When a command is disabled, it can still be used in any channel with "{commandname}" in the topic. For example, if speakerphone is disabled, it can still be used in a channel if the topic includes {speakerphone}.

cmd disable
Usage: %cmd disable <command>
This command disables another command. Only regular and moderator commands can be disabled; Admin commands cannot. Any first-level command can be disabled (like tag, but not tag create).

cmd enable
Usage: %cmd enable <command>
This command enables a different command. Any command in the disabled-commands list can be enabled.

cmd list
Usage: %cmd list
This command lists the disabled commands on the server. If you see a command on the list that doesn't exist, you should still be able to "enable" it (to take it off the list). If you believe your disabled-commands list is corrupted, please contact jagrosh.

feed
Usage: %feed <feedtype>
Aliases: log
This command sets up or removes feeds on the server.

feed announcements
Usage: %feed announcements [channel]
This command sets the announcements feed, which is used for jagrosh to send important information and updates about Spectra.

feed list
Usage: %feed list
This command shows the current feeds on the server, as well as their locations, and any options that have been set.

feed modlog
Usage: %feed modlog [channel] [options]
This command is used to set the modlog feed. This feed keeps track of moderator actions taken on the server, such as kicks, bans, mutes, and cleans, as well as the reasons for the actions (if included in the command).

feed remove
Usage: %feed remove <feed name>
Aliases: clear delete
This command removes a feed from the server, and clears any option on that feed.

feed serverlog
Usage: %feed serverlog [channel] [options]
This command sets the serverlog feed, which displays various activity on the server, including message deletes, message edits, username changes, avatar changes, nickname changes, server joins, server leaves, and room changes. Additionally, options can be provided to exclude some or all users and/or actions from this feed. For more details on these options, please read https://github.com/jagrosh/Spectra/wiki/Serverlog-Feed-Parameters.

feed taglog
Usage: %feed taglog [channel]
This command sets the taglog feed, which displays any tag changes by users on the current server. The full tag log can be found on jagrosh's bot server.

ignore
Usage: %ignore <add|list|remove>
This command is used to make Spectra ignore a user, a role, or a channel. Spectra will not respond to commands or text by these users, users with these roles, or messages in these channels. However, Admins will not be ignored.

ignore add
Usage: %ignore add <user|role|channel> <name>
This command adds a user, channel, or role to the list that Spectra ignores.

ignore add channel
Usage: %ignore add channel <channelname>
This command adds a channel to the ignore list.

ignore add role
Usage: %ignore add role <rolename>
This command adds a role to the ignore list. If the @​everyone role is added, Spectra will ignore all users without roles.

ignore add user
Usage: %ignore add user <username>
This command adds a user to the ignore list.

ignore list
Usage: %ignore list
This command lists the users, roles, and channels that are ignored on the server.

ignore remove
Usage: %ignore remove <user|role|channel> <name>
This command removes a user, channel, or role from the list that Spectra ignores.

ignore remove channel
Usage: %ignore remove channel <channelname>
This command removes a channel from the ignore list.

ignore remove role
Usage: %ignore remove role <rolename>
This command removes a role from the ignore list.

ignore remove user
Usage: %ignore remove user <username>
This command removes a user from the ignore list.

leave
Usage: %leave <message>
This command sets the leave message for the server. This message supports JagTag and can include things like the user's name, server information, and more. See %tag help for more information about JagTag.

leave channel
Usage: %leave channel <channel>
This command sets the channel that the leave message will send to.

leave clear
Usage: %leave clear
Aliases: remove delete
This command clears the server's leave message.

mod
Usage: %mod <add|list|remove>
This command is for giving roles or users access to Spectra's moderator commands.

mod add
Usage: %mod add <user|role> <name>
This command adds a role or user to the list of moderators. Moderators can use the moderator commands. A user will have moderator status if they have a role that is listed as a moderator, so it is not necessary to "double-up" on the permission.

mod add role
Usage: %mod add role <rolename>
This command is used to add a role to the moderator list.

mod add user
Usage: %mod add user <username>
This command is used to add a user to the moderator list.

mod list
Usage: %mod list
This command lists the users and roles that have access to Spectra's moderator commands. Users within the roles have access, but are not listed.

mod remove
Usage: %mod remove <user|role> <name>
This command removes a user or role from the moderator list. If a user is removed, but still has a moderator role, they will still have access to the moderator commands

mod remove role
Usage: %mod remove role <rolename>
This command is used to remove a role from the moderator list.

mod remove user
Usage: %mod remove user <username>
This command is used to remove a user from the moderator list.

prefix
Usage: %prefix <add|list|remove>
This command is for adding, removing, and viewing the prefixes for the server. Multiple prefixes can be set. The prefix % is permanent and cannot be removed. The prefix / is enabled by default, but can be removed.

prefix add
Usage: %prefix add <prefix>
This command adds a prefix. Prefixes already on the list cannot be added. Prefixes may contain spaces and other special characters.

prefix list
Usage: %prefix list
This command lists all of the prefixes that Spectra will respond to on the current server.

prefix remove
Usage: %prefix remove <prefix>
This command removes a prefix from the list. The prefix % is permanent and cannot be removed.

role
Usage: %role <subcommand>
This command is for basic role management on the server

role auto
Usage: %role auto <rolename> | [phrase]
This command is used to set a role that can automatically be given to users. If no phrase is assigned, the role will be given the first time they send any message (within 30 minutes of joining). If a phrase is provided, they will be given the role when they type that exact phrase. Only 1 auto role can be set; any new auto role will override the previous.

role auto clear
Usage: %role auto clear
This command clears the auto-role, so that no roles are given to users when they say a phrase or send a message

role color
Usage: %role color <color> <rolename>
This command sets the color of a role, using a hex or integer value.

role create
Usage: %role create <role name>
This command creates a new, blank role of the specified name.

role give
Usage: %role give <rolename> to <username>
This command gives the specified role to the specified user.

role keep
Usage: %role keep <true|false>
Aliases: perma
This command is to set the role permanence setting on the server. This means that if a user leaves the server, and returns, any roles they had before they left (excluding any roles including or above Spectra's highest) will be reapplied. Note that if a user is off the server for more than a week, the roles will "expire" and no longer be applied.

role take
Usage: %role take <rolename> from <username>
This command takes the specified role from the specified user.

say
Usage: %say <text>
This command can be used by server admins to make Spectra say text. If the first word in the provided text is a channel mention, Spectra will say the text there instead.

welcome
Usage: %welcome <message>
This command sets the welcome message for the server (that is sent when users join). This message supports JagTag and can include things like the user's name, server information, and more. See %tag help for more information about JagTag.

welcome channel
Usage: %welcome channel <channel>
This command sets the channel that the welcome message will send to.

welcome clear
Usage: %welcome clear
Aliases: remove delete
This command clears the server's welcome message.

welcomedm
Usage: %welcomedm <clear|set> <pagenum>
This command sets or clears a page of the Direct Message that is sent to users when they join the server.

welcomedm clear
Usage: %welcomedm clear <pagenum>
This command clears a page of the Direct Message that is sent to new users when they join the server

welcomedm set
Usage: %welcomedm set <pagenum> <contents>
This command sets a page of the Direct Message that is sent to new users when they join the server

Clone this wiki locally