defaultsoftware/gen-biome

🧩 Procedural generation of 2D maps with distinct biomes

Procedural generation of 2D maps with distinct biomes

.

Demo

Documentation

• Install
• Generator
• Biomes
• Generation
• World
• Example

.

Install

npm i gen-biome

.

Generator

Create world generator

new WorldGenerator<T>(config: WorldConfig)

[config] - World config

Prop	Description	Default	Range
width	Map width
height	Map height
frequencyChange	Frequency of biomes change	0.3	0.0 - 1.0
borderSmoothness	Smoothness of biomes borders	0.5	0.0 - 1.0
heightRedistribution	Redistribution of biomes height	1.0	0.5 - 1.5
heightAveraging	Averaging of biomes height	true
falloff	Scale of falloff area	0.0

.

Biomes

Add biome

generator.addBiome(
  config: WorldBiomeConfig, 
  data: T,
): WorldBiome<T>

[config] - Biome config

Prop	Description	Default
lowerBound	Lower biome bound	0.0
upperBound	Upper biome bound	1.0

[data] - Biome data that will be stored in the world matrix

Get current biomes

generator.getBiomes(): WorldBiome<T>[]

Clear all biomes

generator.clearBiomes()

.

Generation

Generate world

generator.generate(
  params?: WorldGenerationParams,
): World<T>

[params] - Generation params (optional)

Prop	Description	Default
seed	Generation seed	(autogenerated)
seedSize	Size of seed array	512
offsetX	Generation offset X	0
offsetY	Generation offset Y	0

.

World

Get matrix of biomes data

world.getMatrix(): T[][]

Each all positions

world.each(
  callback: (position: WorldPoint, data: T) => void,
): void

[callback] - Callback with position and biome stored data

Get biome data at position

world.getAt(
  position: WorldPoint,
): T | null

[position] - Position at matrix

Replace biome data at position

world.replaceAt(
  position: WorldPoint, 
  data: T,
): void

[position] - Position at matrix

[data] - New biome stored data

Get current world generation seed

world.seed: number[]

Get world width

world.width: number

Get world height

world.height: number

.

Example

const TILE_SIZE = 2;
const BIOMES = [
  { // WATER
    params: { lowerBound: 0.0, upperBound: 0.2 },
    data: { color: 'blue' },
  },
  { // GRASS
    params: { lowerBound: 0.2, upperBound: 0.7 },
    data: { color: 'green' },
  },
  { // MOUNTS
    params: { lowerBound: 0.7 },
    data: { color: 'gray' },
  },
];

const generator = new WorldGenerator({
  width: 100,
  height: 100,
});

for (const { params, data } of BIOMES) {
  generator.addBiome(params, data);
}

const world = generator.generate();

world.each((position, biome) => {
  const tileX = position.x * TILE_SIZE;
  const tileY = position.y * TILE_SIZE;

  ctx.fillStyle = biome.color;
  ctx.fillRect(tileX, tileY, TILE_SIZE, TILE_SIZE);
});