Simple RPG helper tools for generating content for tabletop role-playing games (or any other game that uses maps).
Currently rpgmap
is the only available tool but more are planned:
This program currently has 2 implementations: a primary one in Rust and a secondary one in Python. Initially, this was an implementation test to compare speed and code size. This is slowly going to migrate into an implementation in Rust and a Python wrapper library.
rpgmap
is a grid-based map generator. This is the primary tool available
right now.
Example maps look like this:
rpgmap -x 50 -y 50 --num-rooms 50 --room-size 7
rpgmap -s cave -x 50 -y 50
The two primary room types are halls
(default) and cave
. Halls represt a
classical rogue-like dungeon; rooms are rectangular and placed randomly on a
grid and then connected by single-width hallways. No effort is made to ensure
that the rooms overlap, which creates interesting non-rectangular rooms when
they overlap.
Caves are organic-looking blobs that are created by filling the grid with random cells and then annealing using a cellular automata mechanism. This creates blobs that vaguely resemble water-carved caves. The cellular automata strategy can produce blobs that are not connected, when this occurs, they're removed (if too small) or connected via a hallway.
Maps have an orange square that appears near the middle, which is intended to be the entrance.
Note on aesthetics: I am not a capable artist and the maps are kind of ugly. To be improved in the future.
Make sure that you have the Rust compiler and cargo installed.
cargo build --release
./target/release/rpgmap --help
For argument descriptions: ``` $ rpgmap --help RPG map generator 1.2.0 Aaron Seilis aaron.seilis@seilis.ca A simple map generator for role playing games
USAGE: rpgmap [OPTIONS]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-y, --height