SCOLD is a friendly [citation needed], helpful [citation needed] bot for Discord, designed
to do a lot of the same sorts of things that humans do, but better.
Don’t worry about it too much.

There are two primary means of interaction with SCOLD:

· Via traditonal commands, which are prefaced with a summon:

· Or via factoids, which are taught by users, and are triggered by secret keywords.

SCOLD's user interactions work best if you tell her a bit about yourself.

An important note: SCOLD uses Discord roles to refer to users by specific pronouns.
Please assign yourself a pronoun role if you would like her to use a pronoun for you other than the default they/them.

These commands are all prefixed with summons.

Command	Syntax	Aliases	Description
Name	call me [name]	None	Sets your nickname to the given value. SCOLD will use this to refer to you when a factoid uses $who, as well as in some other circumstances.
Remember	remember [content]	None	Adds the given information to a user-specific list of things that SCOLD is remembering for you.
Recall	recall	reminders remember	SCOLD will post everything you've told her to remember.
Forget	forget [number]	None	SCOLD will forget the item with the corresponding number. Use recall to find relevant numbers.

These commands primarily deal with factoid construction.

See the following section for more on factoid syntax.

Command	Syntax	Aliases	Description
X is Y	[x] is [y]	[x] are [y]	Teaches SCOLD a factoid. She will respond "x is y" in response to "x" being posted, unless "y" is annotated with $reply or another tag that defines specific behavior. More on this below.
What Is X	what is [x]	what are [x]	SCOLD will reply with the corresponding factoid definition(s), if she knows any.
Remove Factoid	remove factoid [x]	None	SCOLD will remove any factoids that match the trigger, if any exist.

The factoid system can be used to construct simple call-and-response commands, but variables
can also be used to make factoids more complex in behavior.

Variables are inserted into an [x] is [y] that creates a factoid, in the following fashion:



Here, $reply indicates that the factoid response should be posted as a standalone response, without the "x is y" formatting.


Some example commands:

scold, sus is $reply $random($someone has been voted out. $they $were a crewmate,I saw $someone did $their tasks)

scold, yell at me is $reply $upper($who)

scold, half an $arg1 is $reply an $arg1 is an $arg1. you can't say it's only a half



More variables, and their functions, are detailed in the table below.

Variable	Function	Syntax
$arg[number]	Allows for an arbitrary amount of input information to be taken from a factoid trigger, and reused in the output. May also be used to create factoids that will trigger in response to a variety of different inputs, given specific conditions.	[x] $arg1 and [y] $arg2 is $arg1 $arg2
$var([variable name])	Will be substituted with the value of the named variable.	[x] is $var([varname])
$setvar([variable name], [value])	Sets the specified variable to the specified output. Produces no visible message content.	[x] is $setvar([variable name], [value])
IFF $var([variable name], [value])	This response will ONLY trigger if the specified variable is set to the specified value.	[x] is [y] IFF $var([variable name], [value])
$caps	Forces the factoid to be case-sensitive: the response will only trigger in response to the exact capitalization used in the assignment command.	[x] is $caps [y]
$react	In addition to any other responses detailed, SCOLD will react to the triggering message with the relevant emote. Works for both default and custom emotes.	[x] is $react(😀)
$random	This portion of the response will pick from a list of items detailed by the variable arguments.	[x] is $random(x,y,z)
$lower	Will convert another variable's output to lowercase.	[x] is $lower([variable])
$upper	Will convert another variable's output to uppercse. Useful for shouting at people.	[x] is $upper([variable])
$who	Will be substituted with the name of the person who triggered the factoid. Affects pronouns if $their or similar variables are used.	[x] is $who
$someone	Will be substituted with the name of someone random who is online. Affects pronouns if $their or similar variables are used.	[x] is $someone
$they	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $they
$them	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $them
$themself	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $themself
$theirs	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $theirs
$their	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $their
$were	Pronoun variable. Will change accordingly to the referenced user if $who or $someone is used.	[x] is [$who or $someone] $were

SCOLD will play audio in the currently-active voice channel, given the following input:

scold, radio [url]

She currently accepts input from the following sources:

· YouTube (videos and playlists)

· Soundcloud (songs and playlists)

· Bandcamp (individual tracks, full albums)

· npr.org

· Direct links to audio files

· Audiobooks uploaded to her file server

If your audio link does not play properly, it's likely SCOLD thinks you have bad taste in music.
Trying a different URL may, in some cases, change her opinion.

Additional radio commands are as follows:

Command	Syntax	Description
Shuffle	radio shuffle	Shuffles the queue.
List queue	radio queue	Lists the current queue.
Now playing	radio now playing	Lists the currently playing track.
Skip	radio skip	Skips the currently-playing track.
Pause	radio pause	Pauses the player.
Play	radio play	Resumes the player.
Timestamp	radio timestamp	Prints the current timestamp of the actively-playing track.
Seek	radio seek [00:00:00]	Skips the currently-playing track to a particular timestamp. EXPERIMENTAL, may be slow with long YouTube videos.
Audiobook chapter	radio [book title] chapter [number]	Plays back a particular audiobook chapter from SCOLD's servers. Currently: Jeff Vandermeer's Area X trilogy.

Self-explanatory, hopefully.

Command	Syntax	Aliases	Description
Put this on a shirt	(Any message containing both a file attachment, addressing SCOLD, and the word "shirt")	[See above]	Puts it on a shirt.
New modchart	random modchart	new modfile	Generates a new modchart for the guessing game.
New crop	new crop	None	Generates a new crop of the current modchart screenshot.
Modchart guess	is it [x]	None	Guesses the provided modchart name.
Points leaderboard	points leaderboard	None	Gets the current leaderboard.