This page documents Chessa’s commands.

Dicebot

All dicebot commands support four special features not available to other commands:

.help gives usage information and a description of the command.
.<command>-as <nick> processes the command as though nick had used it.
.<command>-to <nick> sends the output of the command to you and nick as a private message.
.<command> ; <comment> appends the comment to the end of the command’s output.

The following commands are associated:

.attrib generates D&D dice-rolled attributes.
.silcore rolls dice for Silhouette Core.
.exalted rolls dice for Exalted 2e; .exalted <dice> 6 may be used for old World of Darkness.
.hellcats rolls dice for Hellcats & Hockeysticks.
.fudge rolls dice for Fudge and Fate, and supports the Fate ladder.
.lonewolf rolls a die for the Lone Wolf gamebooks and tabletop game.
.dryh rolls dice for Don’t Rest Your Head.
.dw rolls dice for Dungeon World and variants.
.swrpg (and aliases .eote, .aor, and .fad) rolls dice for the Star Wars RPG tabletop game.
.roll and .math are more generic; the former allows for multiple formulas to be calculated at once, whereas the latter allows spaces to be used to make formulas more legible.

The .roll and .math commands support the following:

Op.	Operation	Function	Effects	Args	Var.	Definition
`**`	Exponents	int	Truncation	1	pi	4 * atan2(1, 1)
`*`	Multiplication	hex	Hexadecimal (integer-only)	1	e	exp(1)
`/`	Division	oct	Octal (integer-only)	1	tau	8 * atan2(1, 1)</td
`%`	Modulus	bin	Binary (integer-only)	1	pie	pi * e
`d`	Die roll	atan2	Two-argument arc-tangents	2
`^`	Bitwise XOR	cos	Cosine	1
`&`	Bitwise AND	exp	e to the nth power	1
`\|`	Bitwise OR	log	Logarithm of n	1
`+`	Addition	logn	Logarithm of n (base x)	2
`-`	Subtraction Negation	log10	Logarithm of n (base 10)	10
`~`	1’s complement	sin	Sine	1
`+`	Absolute value (unary)	asin	Arcsine	1
		sqrt	Square root	1
		c2f	Convert Celsius to Fahrenheit	1
		f2c	Convert Fahrenheit to Celsius	1
		floor	Round downward	1
		ceil	Round upward	1
		min	Lowest of given arguments	∞
		max	Highest of given arguments	∞

Database Commands

Chessa has a pluggable database interface, which provides a common interface for database-related functionality. Currently, the following plugins exist:

Pronouns: Simple database mapping users to their pronouns. Presets are available for male, female, and neutral.
Time: Timezone and current time for users.

Plugins are accessible via .<plugin>, with the following subcommands:

find looks up the requested user.
set allows the user to set data for the particular plugin.
help provides documentation for the plugin.

If no subcommand is provided, find is assumed. For example, .time US/Eastern gives the time in that timezone.

Weather

The weather command set consists of .weather, .f/.f1/.f3, .alerts, and .location. All commands take a query string and, optionally, a semicolon (;) followed by a country designator. This designator will constrain the query to the given country, in cases where an ambiguous query may return an unexpected result (e.g. .weather hell might return the weather for Hellin, Spain, whereas .weather hell;no will return the weather for Hell, Norway).

.f returns today’s forecast, .f1 returns tomorrow’s forecast, and .f3 returns (via PM) the forecast for the three days following today. Note that the forecast will change over at 00:00 local time.

.location stores the provided location for the user, so as to allow future inquiries to omit a query string.

Other Commands

.choose returns a randomly-chosen entry from a list, delimited by a comma followed by a space.
.unicode returns information on the given Unicode sequence. Supports combining characters.
.uniname returns information on the given Unicode named sequence.