# 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](https://github.com/journeyman88/alea-iacta-est/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.


Alea Iacta Est

Alea Iacta Est is a bot designed to help RPG players. It supports system-specific rolls and a general dice roller.

Voting for Alea Iacta Est

Do you want to support us?