RPG Tools

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.

RPG Map

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 Example halls map

rpgmap -s cave -x 50 -y 50 Example caves map

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.

Install

Make sure that you have the Rust compiler and cargo installed. cargo build --release ./target/release/rpgmap --help

Usage

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 The vertical height of the map [default: 50] -s, --style The style of map to generate [default: halls] [possible values: halls, cave] --num-rooms The number of rooms to generate [default: 30] -o, --output The name of the output file [default: rpgmap.png] --room-size The size of generated rooms [default: 10] -S, --scale The number of pixels for each square [default: 25] -x, --width The horizontal width of the map [default: 50] ```