alea-iacta-est

Alea Iacta Est is a Discord bot designed to help running RPG sessions over the network.

The bot supports system specific rolls and also has an expression solver to work on more generic rolls.

Expression Engine

The expression engine is built to be used as a simple dice roller and can be invoked using the !alea expr <expression> command. It can solve compounded expression in algebrical sum form, and can interpret - beside simple integer constants - the following notations:

• Simple Dice notation NdX, for example 2d8 - which means roll two dice each with eight faces.
• Roll'n'Keep (upper) notation NdXkY, for example 10d6k5 - which means roll ten dice each with six faces, then sum together the 5 highest values
• Roll'n'Keep (lower) notation NdXlY, for example 10d6l5 - which means roll ten dice each with six faces, then sum together the 5 lowest values
• Roll Above notation NdX/Y, for example 5d10/7 - which means roll five dice each with ten faces, then count those with a value higher than, or equal to seven
• Roll Below notation NdX\Y, for example 3d20\13 - which means roll three dice each with twenty faces, then count those with a value lesser than, or equal to thirteen

For example, a perfecly valid expression could be: 4d4/3 + 10d6k5 - 1d8 - 1d12\5 +7 which could solve to anything between 3 and 40.

Supported systems

The system-specific code is isolated in several plugins, as such the best way to know which systems the instance can support is using the !alea system command, which reports a list of systems and the relative commands (generally two, a 3 character shortcut and a long command).

At the moment of writing the systems supported are the following:

System	Text Shortcut	Slash Command
2d20 System	!alea 2d20	/2d20-system
7th Sea 2nd Edition	!alea 7s2	/7th-sea-2nd
AGE System	!alea age	/age-system
Blacksad RPG	!alea sad	/blacksad
Brass Age	!alea ba1	/brass-age
Forged in the Dark	!alea fitd	/forged-in-the-dark
Genesys	!alea gen	/genesys
Klothos (Thread System)	!alea kts	/klothos
Lex Arcana 2nd Edition	!alea lex	/lex-arcana-2nd
Not The End	!alea nte	/not-the-end
Project H.O.P.E. 2nd Edition	!alea ph2	/project-hope-2nd
Shadowrun 5th Edition	!alea sr5	/shadowrun-5th
Shintiara RPG (Modern d100)	!alea shn	/shintiara
Stigmata: This Signal Kills Fascists	!alea stg	/stigmata
The Dark Eye 5th Edition	!alea da5	/the-dark-eye-5th
Vampire the Masquerade 5th Edition	!alea vt5	/vampire-5th
Walkthrough RPG	!alea wkt	/walkthrough
Year Zero Engine	!alea yze	/year-zero-engine
For system-specific syntax and usage you can run the !alea <system> -h command or check in the github wiki for the system-specific page.

Run-It-Yourself

Aside from the official instance, you can run yourself an instance of the bot, simply by building the code and run it with the command line argument --discordToken <YOUR_TOKEN_HERE>. You can also exclude systems that you're not interested into, simply by removing the appropriate jar from classpath before running it.