Skip to content

The dnd5e-town-generator is an application that allows the user to generate a city of a random size.

Notifications You must be signed in to change notification settings

BramvdnHeuvel/dnd5e-town-generator

Repository files navigation

The dnd5e town generator

This repository contains a program that allows you to look up humongous cities in a "memory free" manner. This program is running live on this website!

How does it work?

The dnd5e-town-generator makes use of what's called pseudo-randomness. Pseudo-randomness is given a determined seed, which will always reproduce the same "random" values.

We are using this property to regenerate the town. This means that the program is way more memory-friendly, but requires quite a bit more CPU-time, as the town needs to be regenerated every time.

The reason why that's efficient, is the assumption that a Dungeon Master will only look up data at a human's speed - not at a computer's. This means that they'll look up people at a relatively low speed.

How to set up

You can install the requirements and run main.py. Alternatively, you can run the town generator in a Docker container.

You can run the D&D Town Generator docker container at localhost:5000 by running the following command:

docker run -p 5000:80 \
--name town-generator \
-e SECRET_KEY='<random password if desired>' \
noordstar/town-generator

Or you can build the container yourself by using the included Dockerfile.

About

The dnd5e-town-generator is an application that allows the user to generate a city of a random size.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published