Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tom-wolfe/tiyl

A library for generating character backstories based on the Xanathar's Guide to Everything 'This Is Your Life' tables.
https://github.com/tom-wolfe/tiyl

and character dnd dnd5e dragons dungeons everything generator guide library random to tool typescript utility xanathar-s xgte

Last synced: about 2 months ago
JSON representation

A library for generating character backstories based on the Xanathar's Guide to Everything 'This Is Your Life' tables.

Awesome Lists containing this project

README

        

# TIYL (This Is Your Life) [![NPM version](https://badge.fury.io/js/tiyl.svg)](http://badge.fury.io/js/tiyl)

[See an interface for this running here](https://tiyl.twolfe.dev)

A TypeScript library for generating characters based on the tables presented in the This Is Your Life chapter of Xanathar's Guide To Everything for 5th edition Dungeons & Dragons.

## Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

### Installing

```batchfile
npm install --save tiyl
```

### Usage

#### Basic Usage

At its simplest, the dice roller is very simple to use. Take the following example:

```typescript
import { Generator } from "tiyl";

const generator = new Generator();
const character = generator.generate();
console.log(character); // Outputs the randomly generated character.
```

#### Configuration

## Installing Dependencies

Installing the dependencies is done using a standard ```npm i```.

## Running the Tests

```dice
npm run test
```

## Building the project

```dice
npm run build
```

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/trwolfe13/dice-typescript/tags).

## Authors

* **Tom Wolfe** - *Initial work* - [trwolfe13](https://github.com/trwolfe13)

See also the list of [contributors](https://github.com/trwolfe13/tiyl/contributors) who participated in this project.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details