# Sims Random Legacy Roller

> Rolls the random rules for each generation of the Sims 4 Random Legacy Challenge: marital status, number of children, careers, a generational goal and a "miscellaneous fun" twist. Rolls can be filtered by the Sims 4 packs the player owns.

An AI can run the challenge for a player in two ways:

1. **Use the live roll API** (recommended). `GET https://simsrandom.com/api/roll` rolls a whole generation using the exact same logic as the website. Add `?exclude=` with pack slugs the player does not own.
2. **Roll by hand** with the complete roll tables in `https://simsrandom.com/llms-full.txt`.

Ask the player which packs they own before rolling. Then exclude every pack they don't own.

## Docs

- [Full rules, roll tables and every possible result](https://simsrandom.com/llms-full.txt): all entries with descriptions, dice ranges, pack slugs and special cases
- [Official challenge rules](https://ts4randomlegacychallenge.wordpress.com/2020/12/26/the-rules/): the general rules of the Random Legacy Challenge by PieceOfPrincess, for example 10 generations, heir choice and money rules

## API

- [Roll a full generation](https://simsrandom.com/api/roll): marital status, children, careers, generational goal and miscellaneous fun
- [Roll marital status](https://simsrandom.com/api/maritalstatus): includes `working_sims`, the number of careers to roll
- [Roll children](https://simsrandom.com/api/children)
- [Roll careers](https://simsrandom.com/api/careers/2): replace `2` with the number of working sims
- [Roll generational goal](https://simsrandom.com/api/gengoal)
- [Roll miscellaneous fun](https://simsrandom.com/api/miscfun)
- [Roll midlife crisis options](https://simsrandom.com/api/midlifecrisis): only when the generational goal is "Midlife Crisis"
- [Roll a color](https://simsrandom.com/api/color): only when miscellaneous fun is "Rainbow Brite"

## Optional

- [Roller website](https://simsrandom.com/): the interactive roller for humans