MapRegionizer is a tool for generating strategic maps from a simple mask that defines land and water areas.
The project is designed as a step-by-step procedural map generation pipeline: from tectonics and terrain to climate, rivers, and regional subdivision.
⚠️ The project is currently in an early stage of development. The API, configuration format, and individual generation stages may change.
The following generation stages are currently implemented:
- Planetary tectonics generation: tectonic plates, crust types, and related base structures.
- Surface generation: terrain and river network generation.
- Climate generation.
- Region generation.
MapRegionizer can be used in several ways.
This option provides the most flexibility for customizing the generation pipeline. You can disable individual stages, change their order, or add custom stages.
See the documentation: docs/generation-pipeline.md.
The CLI pipeline is intended for using the generator from external applications, scripts, and automated workflows.
A desktop client based on Avalonia is available for manual work with the generator.
The client source code is located in AvaloniaRegionizer.
An example of practical use of the map generator in a web application:
docs/generation-pipeline.md— generation pipeline overview.docs/tectonics.md— tectonics generation.docs/elevation.md— elevation generation.docs/hydrology.md— hydrology generation.docs/climate.md— climate generation.docs/agent-pipeline.md— notes on CLI and agent-assisted development.
- Improve repository structure and documentation for more convenient and efficient agent-assisted development.
- Improve tectonics generation and orogenic province generation to produce more interesting terrain.
- Add mineral deposit generation.
- Add optional terrain-aware region generation.
- Add brushes for manual terrain editing and river creation.
- Add volcano generation and areas of increased seismic activity.
- Add a satellite-like presentational render.
- Add stylized renders.
- Add tile export.
- Add tests for individual generation stages.
The project is under active development and does not yet provide a stable public API. For production-like scenarios, it is recommended to pin a specific version or commit.
This project is licensed under the MIT License. See LICENSE.txt for details.
Mask
Climate
Elevation
(seed 42)
MapRegionizer — программа для генерации стратегических карт на основе простой маски, задающей разделение на сушу и водную поверхность.
Проект предназначен для поэтапной генерации процедурных карт: от тектоники и рельефа до климата, рек и регионального деления.
⚠️ Проект находится на ранней стадии разработки. API, формат конфигурации и отдельные стадии генерации могут меняться.
На текущий момент реализованы следующие стадии генерации:
- Генерация тектоники планеты: тектонические плиты, типы коры и связанные с ними базовые структуры.
- Генерация поверхности: рельеф и речная сеть.
- Генерация климата.
- Генерация регионов.
MapRegionizer можно использовать несколькими способами.
Этот вариант предоставляет наибольшие возможности для кастомизации pipeline генерации: можно отключать отдельные стадии, менять их порядок или добавлять собственные этапы.
Подробнее см. в документации: docs/generation-pipeline.md.
CLI-пайплайн подходит для использования генератора из сторонних приложений, скриптов и автоматизированных сценариев.
Для ручной работы с генератором предусмотрен десктопный клиент на Avalonia.
Исходный код клиента находится в каталоге AvaloniaRegionizer.
Пример практического использования генератора карт в веб-приложении:
docs/generation-pipeline.md— описание pipeline генерации.docs/tectonics.md— генерация тектоники.docs/elevation.md— генерация рельефа.docs/hydrology.md— генерация гидрологии.docs/climate.md— генерация климата.docs/cli-pipeline.md— заметки по CLI и агентской разработке.
- Оформить репозиторий и документацию для более удобной и эффективной агентской разработки.
- Доработать генерацию тектоники и провинций орогенеза для получения более интересного рельефа.
- Добавить генерацию месторождений полезных ископаемых.
- Добавить опциональную адаптацию регионов к рельефу поверхности.
- Добавить кисти для ручного редактирования рельефа и речной сети.
- Добавить генерацию вулканов и зон повышенной сейсмической активности.
- Добавить satellite-like render для презентационного отображения карт.
- Добавить стилизованные рендеры.
- Добавить экспорт тайлов.
- Добавить тесты для отдельных стадий генерации.
Проект активно развивается и пока не претендует на стабильность публичного API. Перед использованием рекомендуется фиксировать конкретную версию или commit.
Проект распространяется под лицензией MIT. Подробнее см. LICENSE.txt.