ruby-perlin-2D-map-generator 0.0.4 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1bd8731cdd9870723cfcb6b977f7d111cc160591f727598ae05be919d6dd231f
-  data.tar.gz: d13ec13f781e96e6251bf37ee54d998c065698063e59d99b8143735c48e7e28a
+  metadata.gz: 8bef2e8554e39c0e315b940f4a98a8927348ae576a7f12168c86c74f969c241b
+  data.tar.gz: b3debfe8269979c1f1f0be2a8def6a86de9fcd2a8ad6f548295113068ec04566
 SHA512:
-  metadata.gz: 766f4c73584e9e5152bf6842790bb3f330ca7d7fd9b46ab7427754f4c7869c0529e870827f181b0523f341d9134e8c5fdce18eecc2ef8a9ad2d22f17112cb040
-  data.tar.gz: ed3f8b411ccced1c278e0038abd92ccb6f856f67b683f13ab5298b51f762e71683efecf69e87ab53b56ecacf24859a8541336330fb65dcb15da2a8ae1e3b2740
+  metadata.gz: c91f9810eda61b360e26b31944820b2587ff9e6a10776cdc84347475470573b381853e63b629781fbc0f18eb9fc33299fad31e2a436ef7f7a66d67db8dbb2ea2
+  data.tar.gz: 8c12388e0e7965165557bc5680f030d6d2da9a42e35cc066fbff2390de0e6076c2318e7d62000d17026fa91206adb1ff631eff0ff6af5d670ef81e3d206e45a0

data/README.md

@@ -3,16 +3,18 @@
 [![Gem Version](https://badge.fury.io/rb/ruby-perlin-2D-map-generator.svg)](https://badge.fury.io/rb/ruby-perlin-2D-map-generator)
 ![CI Status](https://github.com/matthewstyler/ruby-perlin-2D-map-generator/actions/workflows/main.yml/badge.svg)
 ![CodeQL](https://github.com/matthewstyler/ruby-perlin-2D-map-generator/workflows/CodeQL/badge.svg)
+<a href="https://codeclimate.com/github/matthewstyler/ruby-perlin-2D-map-generator/test_coverage"><img src="https://api.codeclimate.com/v1/badges/b99aae29d02b7a8a4cc6/test_coverage" /></a>
+<a href="https://codeclimate.com/github/matthewstyler/ruby-perlin-2D-map-generator/maintainability"><img src="https://api.codeclimate.com/v1/badges/b99aae29d02b7a8a4cc6/maintainability" /></a>
 [![Downloads](https://img.shields.io/gem/dt/ruby-perlin-2D-map-generator.svg?style=flat)](https://rubygems.org/gems/ruby-perlin-2D-map-generator)
 
-A gem that procedurally generates seeded and customizable 2D map using perlin noise.
+A gem that procedurally generates seeded and customizable 2D map with optional roads and towns using perlin noise.
 
 Include the gem in your project, or use the executable from the command line.
 
 Map can be rendered in console using ansi colors or returned as 2D array of hashes describing each tile and binome. Completely customizable, use the --help option for full usage details.
 
 
-![2D-maps](https://github.com/matthewstyler/ruby-perlin-2D-map-generator/assets/4560901/4fa5883f-839a-40c9-86a1-d5f9e2c37b9a)
+![2D-maps](https://github.com/matthewstyler/ruby-perlin-2D-map-generator/assets/4560901/6234ebc1-f3bd-48b5-9b78-4d286d2c8d6e)
 
 
 # Installation
@@ -34,6 +36,7 @@ gem install ruby-perlin-2D-map-generator
 See Command line Usage for full customization, below are some examples. Alter the temperature, moisture or elevation seeds to alter these maps:
 
 - Plains with random terrain evens: `ruby-perlin-2D-map-generator render`
+- Plains with random terrain events and two roads: `ruby-perlin-2D-map-generator render --roads=2`
 - Desert (increase temperature, decrease moisture): `ruby-perlin-2D-map-generator render --temp=100 --moisture=-100`
 - Mountainous with lakes (increase elevation, increase moisture) `ruby-perlin-2D-map-generator render --elevation=25 --moisture=25`
 - Islands (decreaes elevation, increase moisture): `ruby-perlin-2D-map-generator render --elevation=-40 --moisture=25`
@@ -44,21 +47,42 @@ See Command line Usage for full customization, below are some examples. Alter th
 --width=int        The width of the generated map (default 128)
 --height=int       The height of the generated map (default 128)
 
+--roads=int        Add this many roads through the map,
+                     starting and ending at edges 
+                         (default 0)
+--towns=int        Add this randomly sized towns
+                         (default 0)
 --hs=int           The seed for a terrains height perlin generation
                          (default 10)
 --ms=int           The seed for a terrains moist perlin generation
                          (default 300)
 --ts=int           The seed for a terrains temperature perlin generation
                          (default 3000)
+--rs=int            The seed for generating roads
+                         (default 100)
 
---elevation=float  Adjust each generated elevation by this percent (0 -
+--elevation=float  Adjust each generated elevation by this percent (-100 -
                          100) (default 0.0)
---moisture=float   Adjust each generated moisture by this percent (0 -
+--moisture=float   Adjust each generated moisture by this percent (-100 -
                          100) (default 0.0)
---temp=float       Adjust each generated temperature by this percent (0
+--temp=float       Adjust each generated temperature by this percent (-100
                          - 100) (default 0.0)
 ```
 
+## Roads and the heuristic
+Roads can be generated by providing a positive integer to the `roads=` argument. Roads are randomly seeded to begin
+and start at an axis (but not the same axis).
+
+A* pathfinding with a priority queue is used to generate the roads. The heuristic uses manhattan distance, and favours existing roads and similar elevations in adjacent tiles. 
+
+Roads can be configured to include/exclude generating paths thorugh water, mountains and flora.
+
+Tiles containing roads are of type `road`, those without are of type `terrain`. 
+
+The `--roads_to_make` option allows you to specify multiple pairs of coordinates to attempt to build paths, subject to the heuristic and other option constraints. Expects a a single list, but must be sets of 4, example of two roads: `--roads_to_make=0,0,50,50,0,0,75,75`
+
+## Towns
+With Poisson Disk Sampling, towns can be generated randomly or with a provided x,y coordinate used as a centroid with radius. The result will be tiles that contain `Building` `items`. Buildings in a town are connected by roads, and additionally towns are connected to other towns by roads.
 # Generate without rendering
 
 ```irb
@@ -112,7 +136,7 @@ $ ruby-perlin-2D-map-generator --help
 ```bash
 Usage: ruby-perlin-2D-map-generator [OPTIONS] (DESCRIBE | RENDER)
 
-Generate a seeded customizable procedurally generated 2D map.
+Generate a seeded customizable procedurally generated 2D map with optional roads.
 Rendered in the console  using ansi colours, or described as a 2D array of
 hashes with each tiles information.
 
@@ -128,40 +152,74 @@ Keywords:
                         coordinate tile details
 
 Options:
-      --elevation=float  Adjust each generated elevation by this percent (0 -
-                         100) (default 0.0)
-      --fhx=float        The frequency for height generation across the x-axis
-                         (default 2.5)
-      --fhy=float        The frequency for height generation across the y-axis
-                         (default 2.5)
-      --fmx=float        The frequency for moist generation across the x-axis
-                         (default 2.5)
-      --fmy=float        The frequency for moist generation across the y-axis
-                         (default 2.5)
-      --ftx=float        The frequency for temp generation across the x-axis
-                         (default 2.5)
-      --fty=float        The frequency for temp generation across the y-axis
-                         (default 2.5)
-      --gf=bool          Generate flora, significantly affects performance
-      --height=int       The height of the generated map (default 128)
-  -h, --help             Print usage
-      --hs=int           The seed for a terrains height perlin generation
-                         (default 10)
-      --moisture=float   Adjust each generated moisture by this percent (0 -
-                         100) (default 0.0)
-      --ms=int           The seed for a terrains moist perlin generation
-                         (default 300)
-      --oh=int           Octaves for height generation (default 3)
-      --om=int           Octaves for moist generation (default 3)
-      --ot=int           Octaves for temp generation (default 3)
-      --ph=float         Persistance for height generation (default 1.0)
-      --pm=float         Persistance for moist generation (default 1.0)
-      --pt=float         Persistance for temp generation (default 1.0)
-      --temp=float       Adjust each generated temperature by this percent (0
-                         - 100) (default 0.0)
-      --ts=int           The seed for a terrains temperature perlin generation
-                         (default 3000)
-      --width=int        The width of the generated map (default 128)
+      --elevation=float                  Adjust each generated elevation by
+                                         this percent (-100 - 100) (default 0.0)
+      --fhx=float                        The frequency for height generation
+                                         across the x-axis (default 2.5)
+      --fhy=float                        The frequency for height generation
+                                         across the y-axis (default 2.5)
+      --fmx=float                        The frequency for moist generation
+                                         across the x-axis (default 2.5)
+      --fmy=float                        The frequency for moist generation
+                                         across the y-axis (default 2.5)
+      --ftx=float                        The frequency for temp generation
+                                         across the x-axis (default 2.5)
+      --fty=float                        The frequency for temp generation
+                                         across the y-axis (default 2.5)
+      --gf=bool                          Generate flora, significantly affects
+                                         performance
+      --height=int                       The height of the generated map
+                                         (default 128)
+  -h, --help                             Print usage
+      --hs=int                           The seed for a terrains height perlin
+                                         generation (default 10)
+      --moisture=float                   Adjust each generated moisture by
+                                         this percent (-100 - 100) (default 0.0)
+      --ms=int                           The seed for a terrains moist perlin
+                                         generation (default 300)
+      --oh=int                           Octaves for height generation
+                                         (default 3)
+      --om=int                           Octaves for moist generation (default
+                                         3)
+      --ot=int                           Octaves for temp generation (default
+                                         3)
+      --ph=float                         Persistance for height generation
+                                         (default 1.0)
+      --pm=float                         Persistance for moist generation
+                                         (default 1.0)
+      --pt=float                         Persistance for temp generation
+                                         (default 1.0)
+      --road_exclude_flora_path=bool     Controls if roads will run tiles
+                                         containing flora
+      --road_exclude_mountain_path=bool  Controls if roads will run through
+                                         high mountains
+      --road_exclude_water_path=bool     Controls if roads will run through
+                                         water
+      --roads=int                        Add this many roads through the map,
+                                         starting and ending at edges (default
+                                         0)
+      --roads_to_make ints               Attempt to create a road from a start
+                                         and end point (4 integers), can be
+                                         supplied multiple paths 
+                                         (default [])
+      --rs=int                           The seed for generating roads
+                                         (default 100)
+      --temp=float                       Adjust each generated temperature by
+                                         this percent (-100 - 100) (default 0.0)
+      --town_seed=int                    The seed for generating towns
+                                         (default 500)
+      --towns=int                        Add this many randomly sized towns
+                                         throughout the map 
+                                         (default 0)
+      --towns_to_make ints               Attempt to create a town at given x,y
+                                         coordinate, with z points and v radius
+                                         (4 integers). Can be supplied multiple
+                                         towns. 
+                                         (default [])
+      --ts=int                           The seed for a terrains temperature
+                                         perlin generation (default 3000)
+      --width=int                        The width of the generated map
+                                         (default 128)
 
 Examples:
   Render with defaults
@@ -169,6 +227,12 @@ Examples:
 
   Render with options
     $ ruby-perlin-2D-map-generator render --elevation=-40 --moisture=25 --hs=1
+  
+  Render with roads
+    $ ruby-perlin-2D-map-generator render --roads=2
+  
+  Render with 5 roads, 1 provided road, 10 random towns and 1 provided town
+    $ ruby-perlin-2D-map-generator render --roads=5 --roads_to_make=0,0,50,50 --towns=10 --towns_to_make=5,5,10,3
 
   Describe tile [1, 1]
     $ ruby-perlin-2D-map-generator describe coordinates=1,1

data/lib/CLI/command.rb

@@ -12,7 +12,7 @@ module CLI
 
       no_command
 
-      desc 'Generate a seeded customizable procedurally generated 2D map. Rendered in the console ' \
+      desc 'Generate a seeded customizable procedurally generated 2D map with optional roads. Rendered in the console ' \
            ' using ansi colours, or described as a 2D array of hashes with each tiles information.'
 
       example 'Render with defaults',
@@ -21,6 +21,9 @@ module CLI
       example 'Render with options',
               '  $ ruby-perlin-2D-map-generator render --elevation=-40 --moisture=25 --hs=1'
 
+      example 'Render with roads',
+              '  $ ruby-perlin-2D-map-generator render --roads=2'
+
       example 'Describe tile [1, 1]',
               '  $ ruby-perlin-2D-map-generator describe coordinates=1,1'
     end
@@ -41,6 +44,24 @@ module CLI
       desc 'Used with the describe command, only returns the given coordinate tile details'
     end
 
+    option :roads_to_make do
+      arity one
+      long '--roads_to_make ints'
+      convert :int_list
+      validate ->(v) { v >= 0 }
+      desc 'Attempt to create a road from a start and end point (4 integers), can be supplied multiple paths'
+      default MapConfig::DEFAULT_ROADS_TO_MAKE
+    end
+
+    option :towns_to_make do
+      arity one
+      long '--towns_to_make ints'
+      convert :int_list
+      validate ->(v) { v >= 0 }
+      desc 'Attempt to create a town at given x,y coordinate, with z points and v radius (4 integers). Can be supplied multiple towns.'
+      default MapConfig::DEFAULT_TOWNS_TO_MAKE
+    end
+
     option :height_seed do
       long '--hs int'
       # or
@@ -210,7 +231,7 @@ module CLI
       long '--temp float'
       long '--temp=float'
 
-      desc 'Adjust each generated temperature by this percent (0 - 100)'
+      desc 'Adjust each generated temperature by this percent (-100 - 100)'
       convert ->(val) { val.to_f / 100.0 }
       validate ->(val) { val >= -1.0 && val <= 1.0 }
       default MapConfig::DEFAULT_TEMP_ADJUSTMENT
@@ -220,7 +241,7 @@ module CLI
       long '--elevation float'
       long '--elevation=float'
 
-      desc 'Adjust each generated elevation by this percent (0 - 100)'
+      desc 'Adjust each generated elevation by this percent (-100 - 100)'
       convert ->(val) { val.to_f / 100.0 }
       validate ->(val) { val >= -1.0 && val <= 1.0 }
       default MapConfig::DEFAULT_HEIGHT_ADJUSTMENT
@@ -230,12 +251,83 @@ module CLI
       long '--moisture float'
       long '--moisture=float'
 
-      desc 'Adjust each generated moisture by this percent (0 - 100)'
+      desc 'Adjust each generated moisture by this percent (-100 - 100)'
       convert ->(val) { val.to_f / 100.0 }
       validate ->(val) { val >= -1.0 && val <= 1.0 }
       default MapConfig::DEFAULT_MOIST_ADJUSTMENT
     end
 
+    option :roads do
+      long '--roads int'
+      long '--roads=int'
+
+      desc 'Add this many roads through the map, starting and ending at edges'
+      convert Integer
+      validate ->(val) { val >= 0 }
+      default MapConfig::DEFAULT_NUM_OF_ROADS
+    end
+
+    option :road_seed do
+      long '--rs int'
+      long '--rs=int'
+
+      desc 'The seed for generating roads'
+      convert Integer
+      default MapConfig::DEFAULT_ROAD_SEED
+    end
+
+    option :road_exclude_water_path do
+      long '--road_exclude_water_path bool'
+      long '--road_exclude_water_path=bool'
+
+      desc 'Controls if roads will run through water'
+      convert :bool
+      default MapConfig::DEFAULT_ROAD_EXCLUDE_WATER_PATH
+    end
+
+    option :road_exclude_mountain_path do
+      long '--road_exclude_mountain_path bool'
+      long '--road_exclude_mountain_path=bool'
+
+      desc 'Controls if roads will run through high mountains'
+      convert :bool
+      default MapConfig::DEFAULT_ROAD_EXCLUDE_MOUNTAIN_PATH
+    end
+
+    option :road_exclude_flora_path do
+      long '--road_exclude_flora_path bool'
+      long '--road_exclude_flora_path=bool'
+
+      desc 'Controls if roads will run tiles containing flora'
+      convert :bool
+      default MapConfig::DEFAULT_ROAD_EXCLUDE_FLORA_PATH
+    end
+
+    option :town_seed do
+      long '--town_seed int'
+      long '--town_seed=int'
+
+      desc 'The seed for generating towns'
+      convert Integer
+      default MapConfig::DEFAULT_TOWN_SEED
+    end
+
+    option :towns do
+      long '--towns int'
+      long '--towns=int'
+
+      desc 'Add this many randomly sized towns throughout the map'
+      convert Integer
+      validate ->(val) { val >= 0 }
+      default MapConfig::DEFAULT_NUM_OF_TOWNS
+    end
+
+    option :verbose do
+      arity one
+      long '--verbose'
+      desc 'Used with the render command, outputs loading information'
+    end
+
     flag :help do
       short '-h'
       long '--help'
@@ -259,10 +351,11 @@ module CLI
       map = Map.new(map_config: MapConfig.new(
         width: params[:width],
         height: params[:height],
-        perlin_height_config: perlin_height_config,
-        perlin_moist_config: perlin_moist_config,
-        perlin_temp_config: perlin_temp_config,
-        generate_flora: params[:generate_flora]
+        all_perlin_configs: MapConfig::AllPerlinConfigs.new(perlin_height_config, perlin_moist_config, perlin_temp_config),
+        generate_flora: params[:generate_flora],
+        road_config: MapConfig::RoadConfig.new(*params.to_h.slice(:road_seed, :roads, :road_exclude_water_path, :road_exclude_mountain_path, :road_exclude_flora_path, :roads_to_make).values),
+        town_config: MapConfig::TownConfig.new(*params.to_h.slice(:town_seed, :towns, :towns_to_make).values),
+        verbose: params[:verbose]
       ))
       case params[:command]
       when 'render' then map.render

data/lib/ansi_colours.rb

@@ -26,6 +26,9 @@ module AnsiColours
     TAIGA_HIGHLAND = "\e[48;5;65m"
     TAIGA_COAST = "\e[48;5;17m"
     ICE = "\e[48;5;159m"
+    LOW_ROAD_BLACK = "\e[48;5;241m"
+    ROAD_BLACK = "\e[48;5;239m"
+    HIGH_ROAD_BLACK = "\e[48;5;236m"
     ANSI_RESET = "\033[0m"
   end
 end

data/lib/biome.rb

@@ -32,6 +32,10 @@ class Biome
     TAIGA_TERRAIN.include?(self)
   end
 
+  def high_mountain?
+    HIGH_MOUNTAIN.include?(self)
+  end
+
   def flora_available
     !flora_range.nil?
   end
@@ -132,6 +136,12 @@ class Biome
     TAIGA_COAST
   ].freeze
 
+  HIGH_MOUNTAIN = [
+    SNOW,
+    ROCKS,
+    MOUNTAIN
+  ].freeze
+
   LAND_TERRAIN = (ALL_TERRAIN - WATER_TERRAIN).freeze
 
   class << self
@@ -141,21 +151,21 @@ class Biome
       case elevation
       when 0.95..1
         SNOW
-      when 0.9..0.95
+      when 0.9...0.95
         ROCKS
-      when 0.8..0.9
+      when 0.8...0.9
         if moist < 0.9
           MOUNTAIN
         else
           SHOAL
         end
-      when 0.7..0.8
+      when 0.7...0.8
         if moist < 0.9
           MOUNTAIN_FOOT
         else
           SHOAL
         end
-      when 0.6..0.7
+      when 0.6...0.7
         if moist < 0.8
           if desert_condition?(moist, temp)
             STEPPE_DESERT
@@ -169,7 +179,7 @@ class Biome
         else
           SHOAL
         end
-      when 0.3..0.6
+      when 0.3...0.6
         if desert_condition?(moist, temp)
           DESERT
         elsif taiga_condition?(moist, temp)
@@ -177,7 +187,7 @@ class Biome
         else
           VALLEY
         end
-      when 0.2..0.3
+      when 0.2...0.3
         if desert_condition?(moist, temp)
           DEEP_DESERT
         elsif taiga_condition?(moist, temp)
@@ -185,25 +195,25 @@ class Biome
         else
           DEEP_VALLEY
         end
-      when 0.15..0.2
+      when 0.15...0.2
         if taiga_condition?(moist, temp)
           TAIGA_COAST
         else
           COASTLINE
         end
-      when 0.05..0.15
+      when 0.05...0.15
         if taiga_condition?(moist, temp)
           ICE
         else
           SHOAL
         end
-      when 0.025..0.05
+      when 0.025...0.05
         if taiga_condition?(moist, temp)
           ICE
         else
           OCEAN
         end
-      when 0.0..0.025
+      when 0.0...0.025
         if taiga_condition?(moist, temp)
           ICE
         else

data/lib/building.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'tile_item'
+
+#
+# Represents a building item on a tile
+#
+class Building < TileItem
+  TOWN_RENDER_PRIORITY = DEFAULT_RENDER_PRIORITY + 1
+
+  HOUSE = "\u{1F3E0}"
+
+  def initialize(render_symbol)
+    super self, render_symbol: render_symbol, render_priority: TOWN_RENDER_PRIORITY
+  end
+
+  def self.random_town_building(_seed)
+    Building.new(HOUSE)
+  end
+end

data/lib/flora_generator.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+#
+# Generates flora for the given tiles
+#
+class FloraGenerator
+  attr_reader :tiles
+
+  def initialize(tiles)
+    @tiles = tiles
+  end
+
+  def generate(config)
+    return unless config.generate_flora
+
+    puts 'generating flora...' if config.verbose
+    tiles.each do |row|
+      row.each do |tile|
+        next unless tile.biome.flora_available
+
+        range_max_value = tiles[(tile.y - tile.biome.flora_range)...(tile.y + tile.biome.flora_range)]&.map do |r|
+          r[(tile.x - tile.biome.flora_range)...(tile.x + tile.biome.flora_range)]
+        end&.flatten&.map(&:height)&.max
+        tile.add_flora if range_max_value == tile.height
+      end
+    end
+  end
+end

data/lib/map.rb

@@ -2,6 +2,9 @@
 
 require 'map_tile_generator'
 require 'map_config'
+require 'road_generator'
+require 'town_generator'
+require 'flora_generator'
 
 class Map
   attr_reader :config
@@ -30,6 +33,35 @@ class Map
   # rubocop:enable Naming/MethodParameterName:
 
   def tiles
-    @tiles ||= MapTileGenerator.new(map: self).generate
+    return @tiles if @tiles
+
+    generate_tiles
+    generate_flora
+    generate_roads
+    generate_towns
+
+    @tiles
+  end
+
+  private
+
+  def generate_tiles
+    @tiles = MapTileGenerator.new(map: self).generate
+  end
+
+  def generate_flora
+    FloraGenerator.new(@tiles).generate(config)
+  end
+
+  def generate_roads
+    road_generator = RoadGenerator.new(@tiles)
+    road_generator.generate_num_of_random_roads(config.road_config)
+    road_generator.generate_roads_from_coordinate_list(config.road_config.roads_to_make, config.verbose)
+  end
+
+  def generate_towns
+    town_generator = TownGenerator.new(@tiles, seed: config.town_config.town_seed)
+    town_generator.generate_random_towns(config.town_config)
+    town_generator.generate_towns_from_coordinate_list(config.town_config)
   end
 end

data/lib/map_config.rb

@@ -25,25 +25,57 @@ class MapConfig
   DEFAULT_TEMP_X_FREQUENCY = 2.5
   DEFAULT_TEMP_ADJUSTMENT  = 0.0
 
+  DEFAULT_ROAD_SEED                  = 100
+  DEFAULT_NUM_OF_ROADS               = 0
+  DEFAULT_ROAD_EXCLUDE_WATER_PATH    = true
+  DEFAULT_ROAD_EXCLUDE_MOUNTAIN_PATH = true
+  DEFAULT_ROAD_EXCLUDE_FLORA_PATH    = true
+  DEFAULT_ROADS_TO_MAKE              = [].freeze
+
+  DEFAULT_TOWN_SEED                  = 500
+  DEFAULT_NUM_OF_TOWNS               = 0
+  DEFAULT_TOWNS_TO_MAKE              = [].freeze
+
+  DEFAULT_VERBOSE                    = false
+
   PERLIN_CONFIG_OPTIONS = %i[width height noise_seed octaves x_frequency y_frequency persistance adjustment].freeze
-  PerlinConfig = Struct.new(*PERLIN_CONFIG_OPTIONS)
+  ALL_PERLIN_CONFIGS    = %i[perlin_height_config perlin_moist_config perlin_temp_config].freeze
+  ROAD_CONFIG_OPTIONS   = %i[road_seed roads road_exclude_water_path road_exclude_mountain_path road_exclude_flora_path roads_to_make verbose].freeze
+  TOWN_CONFIG_OPTIONS   = %i[town_seed towns towns_to_make verbose].freeze
 
-  attr_reader :generate_flora, :perlin_height_config, :perlin_moist_config, :perlin_temp_config, :width, :height
+  PerlinConfig = Struct.new(*PERLIN_CONFIG_OPTIONS)
+  AllPerlinConfigs = Struct.new(*ALL_PERLIN_CONFIGS)
+  RoadConfig = Struct.new(*ROAD_CONFIG_OPTIONS)
+  TownConfig = Struct.new(*TOWN_CONFIG_OPTIONS)
 
-  def initialize(perlin_height_config: default_perlin_height_config, perlin_moist_config: default_perlin_moist_config, perlin_temp_config: default_perlin_temp_config, width: DEFAULT_TILE_COUNT,
-                 height: DEFAULT_TILE_COUNT, generate_flora: DEFAULT_GENERATE_FLORA)
-    raise ArgumentError unless perlin_height_config.is_a?(PerlinConfig) && perlin_moist_config.is_a?(PerlinConfig)
+  attr_reader :generate_flora, :perlin_height_config, :perlin_moist_config, :perlin_temp_config, :width, :height, :road_config, :town_config, :verbose
 
+  # rubocop:disable Metrics/ParameterLists:
+  def initialize(all_perlin_configs: default_perlin_configs, width: DEFAULT_TILE_COUNT,
+                 height: DEFAULT_TILE_COUNT, generate_flora: DEFAULT_GENERATE_FLORA, road_config: default_road_config, town_config: default_town_config, verbose: DEFAULT_VERBOSE)
+    validate(all_perlin_configs)
     @generate_flora = generate_flora
-    @perlin_height_config = perlin_height_config
-    @perlin_moist_config = perlin_moist_config
-    @perlin_temp_config = perlin_temp_config
+    @perlin_height_config = all_perlin_configs.perlin_height_config
+    @perlin_moist_config = all_perlin_configs.perlin_moist_config
+    @perlin_temp_config = all_perlin_configs.perlin_temp_config
     @width = width
     @height = height
+    @road_config = road_config
+    @town_config = town_config
+    @verbose = verbose
+    town_config.verbose = verbose
+    road_config.verbose = verbose
   end
+  # rubocop:enable Metrics/ParameterLists:
 
   private
 
+  def validate(all_perlin_configs)
+    unless all_perlin_configs.perlin_height_config.is_a?(PerlinConfig) && all_perlin_configs.perlin_moist_config.is_a?(PerlinConfig) && all_perlin_configs.perlin_temp_config.is_a?(PerlinConfig)
+      raise ArgumentError
+    end
+  end
+
   def default_perlin_height_config
     PerlinConfig.new(DEFAULT_TILE_COUNT, DEFAULT_TILE_COUNT, DEFAULT_HEIGHT_SEED, DEFAULT_HEIGHT_OCTAVES,
                      DEFAULT_HEIGHT_X_FREQUENCY, DEFAULT_HEIGHT_Y_FREQUENCY, DEFAULT_HEIGHT_PERSISTANCE, DEFAULT_HEIGHT_ADJUSTMENT)
@@ -58,4 +90,17 @@ class MapConfig
     PerlinConfig.new(DEFAULT_TILE_COUNT, DEFAULT_TILE_COUNT, DEFAULT_TEMP_SEED, DEFAULT_TEMP_OCTAVES,
                      DEFAULT_TEMP_X_FREQUENCY, DEFAULT_TEMP_Y_FREQUENCY, DEFAULT_TEMP_PERSISTANCE, DEFAULT_TEMP_ADJUSTMENT)
   end
+
+  def default_road_config
+    RoadConfig.new(DEFAULT_ROAD_SEED, DEFAULT_NUM_OF_ROADS, DEFAULT_ROAD_EXCLUDE_WATER_PATH, DEFAULT_ROAD_EXCLUDE_MOUNTAIN_PATH, DEFAULT_ROAD_EXCLUDE_FLORA_PATH, DEFAULT_ROADS_TO_MAKE,
+                   DEFAULT_VERBOSE)
+  end
+
+  def default_town_config
+    TownConfig.new(DEFAULT_TOWN_SEED, DEFAULT_NUM_OF_TOWNS, DEFAULT_TOWNS_TO_MAKE, DEFAULT_VERBOSE)
+  end
+
+  def default_perlin_configs
+    AllPerlinConfigs.new(default_perlin_height_config, default_perlin_moist_config, default_perlin_temp_config)
+  end
 end