Map generation for games
Go to file
2021-01-14 12:18:31 +01:00
demo Metrics Fixed: #20, Fixed #21. 2021-01-14 12:18:31 +01:00
docs Metrics Fixed: #20, Fixed #21. 2021-01-14 12:18:31 +01:00
examples smaller example1 2020-10-19 21:35:24 +02:00
src Metrics Fixed: #20, Fixed #21. 2021-01-14 12:18:31 +01:00
.gitignore First working version 2020-09-12 15:49:33 +02:00
.travis.yml Added Travis CI 2020-08-31 11:48:44 +02:00
Cargo.toml Upgrade to rand 0.8. 2021-01-12 09:16:49 -06:00
LICENSE-APACHE init 2020-08-31 11:45:59 +02:00
LICENSE-MIT init 2020-08-31 11:45:59 +02:00
README.md implemented Voronoi Hive. Fixed: 30 2020-11-19 20:53:34 +01:00

Game Map Generator

Build Status Crates.io mapgen.rs

Generate procedural maps for games. Try it in the browser using WebAssembly.

Map filters

This library consists of different map filters which can be combined to create custom map generator.

Implemented filters

  • Area exit point
  • Area starting point
  • BSP Interior
  • BSP Rooms
  • Cellular automata
  • Cull unreachable areas
  • Diffusion-Limited Aggregation (DLA)
  • Drunkard's walk
  • Maze
  • Noise generator
  • Prefabs
  • Room corridors nearest
  • Simple rooms
  • Voronoi hive
  • Wave Function Collapse

Usage

Add dependency to your project

mapgen = "0.4"

Using single map generator:

use rand::prelude::*;
use mapgen::{Map, MapFilter};
use mapgen::filter::CellularAutomata;

let mut rng = StdRng::seed_from_u64(100);
let gen = CellularAutomata::new();
let map = gen.modify_map(&mut rng, &Map::new(80, 50));

Use MapBuilder for chaining map generator and modifiers

use mapgen::{
    MapBuilder,
    filter::{
        NoiseGenerator, 
        CellularAutomata,
        AreaStartingPosition,
        XStart, 
        YStart,
    },
};

let map = MapBuilder::new(80, 50)
        .with(NoiseGenerator::uniform())
        .with(CellularAutomata::new())
        .with(AreaStartingPosition::new(XStart::CENTER, YStart::CENTER))
        .with(CullUnreachable::new())
        .with(DistantExit::new())
        .build();

For more information check the doc

This library is based on the code from the Roguelike tutorial. I highly recommend it for learning how to write Roguelike in Rust.

License

Licensed under either of

at your option.

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.