The Bot and How to use it
Posted: Wed Feb 19, 2025 5:50 am
The Bot has two ways of rolling, and multiple methods of interaction aside from just rolling.
To read this guide, one thing must be understood; for parameters, the symbols surrounding parameter names are never included, but are used to describe the type of parameter. A pair of
To make any of these commands, the command is typed into the ooc channel, or in the bot's pm if noted.
Dice:
Normal dice, and not rank-based rolls, are simply in the format of
Commands:
Rolling:
Command:
Examples:
Description: Gives all the rank names (long hand and short hand) the bot can roll, as well as their damage/score, and if given a rank name (long hand or shorthand), and a chart shift (given in the form of +/-number (example: +1, -1, etc), the bot will give the new rank.
Command:
Examples:
ST/GM:
ST/GM Examples:
Description: This is the main rolling command; it takes two forms, and both are valid;
Initiative:
Command:
Examples:
Description: This command either lists the initiative for the channel in which it is executed, or it adds a Character to the initiative. If a character name and rank name is given, the rank given is rolled and given bonuses depending on if it crits or not, and the resulting number is added to the initiative. If a number is given, the flat number is rolled as if it was a dice, and that result is added.
Command:
Examples:
Description: This command is similar to the initiative command, but enters an enemy into the initiative instead. It has the same parameters as
Command:
Examples:
Description: This command resets the initiative for the channel it is given in.
Command:
Examples:
Description: This command flags or unflags a character with a custom bit of text. If the command is used without the flag, the flag text for the character is cleared. If used with the flag, it overwrites the current flag text, if any, with the provided flag text.
Command:
Examples:
Description: This command KOs a character, marking them as unconscious.
Command:
Examples:
Description: This command marks a character as no longer in unconscious status.
Command:
Examples:
Description: This command removes a character from the initiative.
Experimental Features: These features are in the testing bot, but not the live bot. Never the less, they can be used in the interim before they are deployed to the live bot.
Notes: These commands only work for characters currently in the testing Bot's system, and they will only work if the user of a command is the owner of the character, or an ST/GM. If the roller is an ST/GM and does not own the character in question, the format to roll is altered according to the 'ST/GM' section under each command.
Command:
Examples:
ST/GM:
ST/GM Examples:
Description: The Character Roll command will roll the given character's stats or powers as defined in the roll. Statistic names (fighting, agility, etc), can be used as well as their shorthand forms (f, a, s, e, etc), Power names can be used, and talents can be used to buff stats or powers. Additionally, modifiers can be used in the form of +/-number after the stat, power, or talent name. A form may be specified if the statistics of a character are different for that form, with a slash after the character Call Name followed by the Form Name. If a power is not accessible to a given form, the power usage will be replaced by nothing. Last but not least, the operators of the command (names of stats, names of powers, names of talents, and number modifiers), cannot have any spaces in them. If using the
Command:
Examples:
ST/GM:
ST/GM Examples:
Description: This command may be executed in private message with the bot if desired. The command lists all powers available to that character in the given form, or the default form if not specified.
Command:
Examples:
ST/GM:
ST/GM Examples:
Description: This command may be executed in private message with the bot if desired. The command lists all talents available to that character.
To read this guide, one thing must be understood; for parameters, the symbols surrounding parameter names are never included, but are used to describe the type of parameter. A pair of
<> denote a requried parameter, while () denote optional, and finally, (<>) denote required if the previous parameter was entered. An ellipsis after a parameter denotes it may be repeated as desired.To make any of these commands, the command is typed into the ooc channel, or in the bot's pm if noted.
Dice:
Normal dice, and not rank-based rolls, are simply in the format of
xdy+/-z. X is number of dice being rolled, Y is the dice face amount (d20, etc), +/- is either + or - if applicable, and Z is a bonus if applicable.Commands:
Rolling:
Command:
!ranks (Rank Name) (<Chart Shift>)Examples:
!ranks, !ranks good +1, !ranks in -2Description: Gives all the rank names (long hand and short hand) the bot can roll, as well as their damage/score, and if given a rank name (long hand or shorthand), and a chart shift (given in the form of +/-number (example: +1, -1, etc), the bot will give the new rank.
Command:
!r <Rank Name> (Rank Name)... (Reason), !roll <Rank Name> (Rank Name)... (Reason)Examples:
!r in, !roll incredible, !r incredible rm good, !r in reason goes hereST/GM:
!gm <ST/GM Nickname> !r <Rank Name> (Rank Name)... (Reason), !gm <ST/GM Nickname> !roll <Rank Name> (Rank Name)... (Reason)ST/GM Examples:
!gm Daedalus !r in am ex a roll!Description: This is the main rolling command; it takes two forms, and both are valid;
!r or !roll. Both have the same parameters. The command takes a list of rank names, which can be long hand or short hand, and an optional reason at the end. If using the !gm format, the result of the roll is private-messaged to the given ST/GM.Initiative:
Command:
!init (Character Name) (<Rank Name or Number>)Examples:
!init, !init Dae incredible, !init Dae am, !init Dae 40Description: This command either lists the initiative for the channel in which it is executed, or it adds a Character to the initiative. If a character name and rank name is given, the rank given is rolled and given bonuses depending on if it crits or not, and the resulting number is added to the initiative. If a number is given, the flat number is rolled as if it was a dice, and that result is added.
Command:
!enemyExamples:
!enemy, !enemy Dae incredible, !enemy Dae am, !enemy Dae 40Description: This command is similar to the initiative command, but enters an enemy into the initiative instead. It has the same parameters as
!init and works the same way.Command:
!resetExamples:
!resetDescription: This command resets the initiative for the channel it is given in.
Command:
!flag <Character Name> (Flag Name)Examples:
!flag Dae, !flag Dae flag name goes hereDescription: This command flags or unflags a character with a custom bit of text. If the command is used without the flag, the flag text for the character is cleared. If used with the flag, it overwrites the current flag text, if any, with the provided flag text.
Command:
!ko <Character Name>Examples:
!ko DaeDescription: This command KOs a character, marking them as unconscious.
Command:
!alive <Character Name>Examples:
!alive DaeDescription: This command marks a character as no longer in unconscious status.
Command:
!remove <Character Name>Examples:
!remove DaeDescription: This command removes a character from the initiative.
Experimental Features: These features are in the testing bot, but not the live bot. Never the less, they can be used in the interim before they are deployed to the live bot.
Notes: These commands only work for characters currently in the testing Bot's system, and they will only work if the user of a command is the owner of the character, or an ST/GM. If the roller is an ST/GM and does not own the character in question, the format to roll is altered according to the 'ST/GM' section under each command.
Command:
!croll <Character Call Name>(/Form Name) <Stat or Power Name>(+/-Talent Name)(+/-Number)...!gm <ST/GM Nickname> !croll <Character Call Name>(/Form Name) <Stat or Power Name>(+/-Talent Name)(+/-Number)...Examples:
!croll Dae Fighting+1 Fire-Breath-1!croll Dae fighting+sword fighting+sword-1!croll Dae/dragon Fire-Breath!gm Daedalus !croll Dae fightingST/GM:
!croll <Nickname of Owner>:<Character Call Name>(/Form Name) <Stat or Power Name>(+/-Talent Name)(+/-Number)...!gm <ST/GM Nickname> !croll <Nickname of Owner>:<Character Call Name>(/Form Name) <Stat or Power Name>(+/-Talent Name)(+/-Number)...ST/GM Examples:
!croll Daedalus:Dae fighting!gm Daedalus !croll Daedalus:Dae fightingDescription: The Character Roll command will roll the given character's stats or powers as defined in the roll. Statistic names (fighting, agility, etc), can be used as well as their shorthand forms (f, a, s, e, etc), Power names can be used, and talents can be used to buff stats or powers. Additionally, modifiers can be used in the form of +/-number after the stat, power, or talent name. A form may be specified if the statistics of a character are different for that form, with a slash after the character Call Name followed by the Form Name. If a power is not accessible to a given form, the power usage will be replaced by nothing. Last but not least, the operators of the command (names of stats, names of powers, names of talents, and number modifiers), cannot have any spaces in them. If using the
!gm format, the result of the roll is private-messaged to the given ST/GM.Command:
!cpowers <Character Call Name>(/Character Form)Examples:
!cpowers Dae, !cpowers Dae/dragonST/GM:
!cpowers <Nickname of Owner>:<Character Call Name>(/Form Name)ST/GM Examples:
!cpowers Daedalus:Dae, !cpowers Daedalus:Dae/dragonDescription: This command may be executed in private message with the bot if desired. The command lists all powers available to that character in the given form, or the default form if not specified.
Command:
!ctalents <Character Call Name>Examples:
!ctalents DaeST/GM:
!ctalents <Nickname of Owner>:<Character Call Name>ST/GM Examples:
!ctalents Daedalus:DaeDescription: This command may be executed in private message with the bot if desired. The command lists all talents available to that character.