Page 1 of 1

Roll Log Manager Usage

Posted: April 4th, 2024, 10:07 pm
by Daedalus
Roll Logger

Daedalus has created a tool that bridges IRC and a web app based on the boards that will allow you to use bracketed commands inside an RP post to make the bot roll actions automatically without the need for follow-up posts.

You can find the web app for managing it here:
rolllogger/characters

Nicknames should be verified through NickServ in order to work. There's a limited workaround available for users without one. The reason this is required is people may have similar character names, so registering a irc nickname allows kefka to know who is using what alias, and look up the characters accordingly.

To create a new user list, click "Nickname List," then "New Nick." The app will prompt you with instructions.

Once that is finished, you can create your individual characters.
When creating a character, at least 1 roll and 1 alias are required.

You can choose to "Import" to quickly enter your rolls via a text box, instead of a form that you fill out.
The format is: category name (line break) roll name: roll (line break) roll name(form): roll
You can also "Export" your created list of rolls and aliases to save as a backup for later.
Here's what that looks like:



Once you have a character created, there are several ways to roll the rolls the character has via roll log manager.

During the game, on a nickname that has been verified, use the alias of a character to write a post(pretty simple so far).
In that post, supply rolls between square brackets:


Some notes:
  • Keep your roll names simple in terms of the standard alphabet, because the parser is written in such a way that it won't match otherwise.
  • Numbers are okay too, as long as they don't appear at the end after a math operator (a minus or plus). In that case, they'd be treated as a step up or down to the roll in question.
  • It is required to keep all rolls for a character on one character; because of the way the code works for finding the rolls in the first place.
  • If two characters are created with the same name, then it would only prioritize the first one.
For this reason, there is a way to filter rolls based on character form; only rolls with the given filtered form will show up, and categories that don't have any rolls will fade out to indicate they don't have any of the rolls of a given form.

When creating a character, given rolls have two optional fields: form and alternate names.
  • Form allows a roll to be specified as applying to a specific form of the character, whether that form be for example: trance, limitbreak or dragon. Anything can be used for the form name, just as long as it does not contain any spaces.
  • Aliases also have a form field that is optional. When an alias has a form assigned to it, any rolls that also have that same form will be prioritized and will roll instead of the same-named roll without a form.
  • This can be overridden by supplying the form name to the roll in question as a prefix suffixed with a forward slash: .
Alternate names allow rolls to be rolled with another name than the one given to the roll. Due to how import/export works, these are not imported or exported and will have to be re-defined if removed or if the rolls were imported.

All syntax variations can be used with each other.

Here are all of the ways to roll/the syntax supported for rolling:
  • - This will make the roll of roll name
  • - This will make the roll of roll name at the given number steps up. So if the roll was 1s1, it'd roll at 1s2 if +1 was given as a suffix to roll name
  • - This will make the roll of roll name at the given number steps down. So if the roll was 1s1, it'd roll at 1s0 if -1 was given as a suffix to roll name
  • - This will make the roll of roll name and append a reason to it.
  • - This will make the roll of roll name and bump up the bonus of the roll by the given number. So if a roll was 1s1+40 and a +10 was given, it'd roll instead at 1s1+50
  • - This will make the roll of roll name and bump down the bonus of the roll by the given number. So if a roll was 1s1+40 and a -10 was given, it'd roll instead at 1s1+30
  • - This will make the roll of roll name and bump up the bonus of the roll by the given number and append a reason.
  • - This will make the roll of roll name and bump down the bonus of the roll by the given number and append a reason.
  • - This will override the alias's form with the form of formname(it may not contain spaces), and make the roll that uses the given form.