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!
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.
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.