Repository navigation
Knowledge Base
Go to Tools -> Heightmap (read the options that appear) -> use the brushes that appear on the top right
Bigger like covering more distance. Go to Tools -> Units and increase the '1 map pixel' distance scale. Adding more land outside of the map is not possible in FMG, you have to export the image, edit it in an external editor and reimport it back to the FMG via the image importer (Tools -> Heightmap -> Erase -> Image Converter)
Go to Tools -> Heightmap, select any edit mode (Keep, Risk or Erase) and click on Preview. A small monochrome heightmap appears at the bottom left, click on it to download a screen-sized image. For a bigger image exit the customization, set Style preset to Monochrome, keep only the Heightmap layer visible and export the map as .png
Native FMG heightmap resolution is very low, so you'll probably have to add details using external software. You can also try to export the map as an image with the Heightmap layer on
Could be cause you don't have a culture over that area or that the biome on that area its not habitable, most commonly Glacier
For real-world maps open Options -> Heightmap and pick one from the gallery (Earth, Europe, Africa and more). Maps made by others are shared at https://cartographyassets.com/asset-category/specific-assets/azgaars-generator. To recreate any other map from its image, use Tools -> Heightmap -> Erase -> Image Converter
To get a blank map go Tools -> Heightmap -> Erase and use the brushes on the top right to delete all the land
Labels are shown and hidden based on zoom bounds defined per label group. Open Tools -> Labels and click on the groups configuration button. There you can check 'Show all labels' to ignore zoom bounds completely, or raise the max zoom value for a specific group
Open Tools -> Labels, click the groups configuration button and set the state group's Mode to 'full'. 'Auto' uses the full name only when it fits, 'short' always uses the short one
Yes, it can be done via the Image Converter. Go to Tools -> Heightmap -> Erase -> Image converter
This its because the border of states or provinces follow the border of the cells while the river flows through the centre of the cell (for making them pretty)
There is an autosave. Go to Options -> Configure -> Advanced -> Autosave interval and set the interval in minutes (0 disables it). The five latest autosaves are kept in the browser storage and listed in the Load menu, where each can be loaded, downloaded as a .map file or removed. Browser storage can be cleared accidentally, so also save .map file backups to your machine from time to time
There is no global undo for the whole map, but undo and redo (Ctrl + Z / Ctrl + Y) work in the editors that support it: Heightmap brushes and Template Editor, Paint brushes, Wrap Tool, Notes Editor, Routes Overview and Transform tool. It's still recommended to save the project as a .map file at least once every 30 minutes of work
Use Tools -> Create -> Transform: it rebuilds the map with a different points number and tries to keep the details. Submap does the same for a part of the map
Climate sets the map's position on the globe, temperatures and precipitation. Lore sets the map name, calendar and world description. Advanced holds map size, the cell grid, growth rate, autosave and other settings; hover one to see what it does. Reset restores all options to their defaults and reloads the page, so save the map first
Yes. Open Options -> Advanced (bottom row), pick a Lattice preset such as Hex board, Square board or Isometric board, then generate a new map. It applies to new maps only. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Advanced-options
Yes. Most overviews in Tools (Burgs, States, Rivers, Markers and others) have a download button that saves the table as .csv. Export also offers GeoJSON for GIS tools and JSON for your own scripts. Only the CSV tables, notes, namesbases, heightmap templates and styles can be uploaded back: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Data-import
Yes, to update existing entries. In an overview such as Tools -> States or Burgs, download the table as .csv, edit it in a spreadsheet and upload it back with the button next to download. A preview shows every change and anything that won't be applied; press Apply to confirm. Rows are matched by Id, and empty cells keep the current value. Columns per editor: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Data-import
No, an upload only updates existing entries. If an Id is not on the map, nothing is changed and the missing ids are listed. Create the entries in the editor first, download the CSV again to see their ids and fill them in
The upload preview lists each skipped value with the reason. Usually a name that points at another entry (a culture, state or capital) doesn't match exactly, or the column is calculated from the map (cells, area) and can't be uploaded. Names cannot contain " < or >
Only comma-separated files. A spreadsheet in a language with decimal commas may save with semicolons, so choose the comma when saving. Save from Excel as CSV UTF-8 so names with accents survive
Yes, add and remove relief icons on the map with the Relief Editor: turn the Relief icons layer on and click on an icon, or use the bulk add and bulk remove brushes. You can also switch between the bundled icon sets (Simple, Colored, Gray, Illustrated and Stickers). To use your own art, see "Can I use my own images as relief icons?"
Yes. In the Relief Editor select an icon and press the plus button in the bottom line to give it any icon, including your own uploaded or linked image. To make a biome generate your icons, open Tools -> Biomes, edit its Relief column ("Add any icon...") and press "Apply and re-place". See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Icons
Open Tools -> Measurers (Shift + =) and pick a ruler, an opisometer (curve length), a route opisometer (follows routes) or a planimeter (area), then draw on the map. Remove them in the same editor and style them in Style -> Rulers
Water must be able to flow to the sea, so when you finish a heightmap edit, closed hollows are filled or turned into lakes. To see them while editing, tick "Show drainage" in the Tools tab of the heightmap editor: arrows show where water flows and hatched areas are hollows. Lower a rim or raise the floor until the hatching is gone
Open Tools -> Heightmap and pick an edit mode, then use the brushes on the top right with a small radius. If the elevation is already right and you only dislike the outline, reshape the cells themselves with the Wrap Tool (Tools -> Create -> Wrap, or Shift + W)
To give land to another state, province, culture, religion, biome or zone, open its editor, click the brush button and paint over the cells. To only reshape the border line, use Tools -> Create -> Wrap (Shift + W)
Open Tools -> Coastlines and pick a preset (Smooth, Rocky, Fjords, Skerries) or tune roughness and bays, for the whole map or a single island or lake. It changes only how the shore is drawn; to move the coast itself, edit the heightmap. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Coastline-Editor
Use the Wrap Tool: Tools -> Create -> Wrap (Shift + W). Drag on the map and the cell corners under the brush move with the pointer, so coastlines, lake shores and all cell-based borders bend with them. It is meant for small adjustments only — do 99.9% of the shaping with the Heightmap tool and finesse the result with Wrap
You may have pushed cell shapes too far with the Wrap Tool, in which case use its Revert all button and do the changes of land with the Heightmap tool, or you may have a way too complex shape for the generator
There is no a thing as time at the moment on the generator. The era and year thing in Options -> Configure -> Lore is just to define time messages on legends of military regiments, battles and similar things with a date on the notes
Zoom out the browser (ctrl and the wheel) to 100%. Or set Interface size to 1 in Options
Go to tools and select the desired option. Click on the brush button on the bottom, click and drag to paint on the map, remember to confirm the changes when done
Habitability is determined by biomes. Go to Tools -> Biomes, here you can change biome habitability percentage
You need to know the dungeon seed. Create a new marker, and edit the notes. Then click the Source code button on the top-left and enter something like this (change YOUR_SEED):
Click here to go to the dungeon
<iframe src="https://watabou.github.io/one-page-dungeon/?seed=YOUR_SEED"></iframe>
Options -> Configure -> Climate -> Change the temperature of the poles. After that, Tools -> regenerate ice
Edit the heightmap in Erase or Risk mode. Alternatively go to the Tools -> Units editor, then the altitude subsection and change the exponent a bit
Hover it over, you will see some tips at the bottom on the page
Open Tools -> Heightmap, choose Risk mode (it keeps states, burgs and other data), lower the land with the brushes and finish the edit. Land under a burg is never sunk, so remove or move those burgs first
Burg is an internal name used for all settlements in the Fantasy Map Generator. It comes from German 'burg' meaning 'fortified settlement'
Search the existing issues first, then report at https://github.com/Azgaar/Fantasy-Map-Generator/issues/new?template=bug_report.yml with the FMG version, browser, steps to reproduce and the .map file in a ZIP. On Discord, use /bug or ask in #fmg-bugs. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Reporting-bugs-and-ideas
Say what happened, what you expected and how to repeat it, for example: "Load the attached map, rename Northport to Southport, save and reload: the name is Northport again." Add the FMG version, browser and OS, the .map file in a ZIP and any error text or screenshots
No, chatting only gets advice. To file a report on Discord use /bug or /idea, or the message menu's Apps -> Report this as a bug. A moderator reviews it before it reaches GitHub; follow the GitHub link you get. You can also use the GitHub forms directly
Turn off layers you don't need, especially Relief icons. Set the Performance preset in the Options tab to Speed. Generate maps with fewer points, such as 10K. Use a recent Chrome or Edge and close other heavy tabs. A smaller browser window also renders faster
You. The Generator is licensed under MIT license and derivative works such as maps are free of charge. You can sell them or make them available for free
Maps saved since v0.70.0 are updated automatically on load; older ones need the matching old version of the Generator. If a newer map fails, report it at https://github.com/Azgaar/Fantasy-Map-Generator/issues/new?template=bug_report.yml with the .map file in a ZIP, the exact error and the versions used to save and load it
Yes. Open the menu (Tab) and click Export at the bottom. Pick .svg for the full map as a vector image, .png or .jpeg for the current view (up to 8x resolution), tiles for a ZIP of image chunks, or GeoJSON and JSON for data. To keep an editable copy, use Save instead, which makes a .map file
Not directly: image exports always include the ocean. Export .svg, open it in a vector editor such as Inkscape, delete the ocean group and export a PNG from there
Yes, in Chrome and Edge: Save to machine (Ctrl + S) asks for a name and location and creates a new file each time. To overwrite the last saved file, press Ctrl + Shift + S. Firefox and Safari save to the browser's download folder
Yes. Tick View-only at the bottom of the Save dialog and save to machine or Dropbox. The map then opens for browsing only: layers, zoom, search, notes and export work, editing doesn't. It is not a protection, as the file can still be edited by hand
Open the generator, click on Load and select the file. Or just drag and drop the file onto the Generator window
.map files are plain text, so it's technically possible, but it's better not to do it as broken formatting makes the file unloadable. The common error is that most text editors automatically split the embedded svg into separate lines. .gz files are gzip-compressed and have to be decompressed first
Yes. Install the desktop app from https://github.com/Azgaar/Fantasy-Map-Generator/releases, which works offline. Or install the web version as a PWA (the Install button in Chrome's address bar) and open it once online so it gets cached. External fonts and styles still need a connection
Yes, for Windows, macOS and Linux: download the installer from https://github.com/Azgaar/Fantasy-Map-Generator/releases. It's the same Generator in its own window, works offline and checks for updates. Without installing anything, Chrome and Edge can install the web app with the Install button in the address bar
The builds are not code-signed yet, so the system warns on the first launch. On macOS right-click the app -> Open -> Open, on Windows click More info -> Run anyway
Chrome, Edge and other Chromium browsers work best, as the tool is developed in Chrome. Firefox and others work but may be slower. Old browsers like Internet Explorer are not supported
You can, but I doubt you will enjoy the experience. The Generator GUI is not suitable for mobile devices and performance is subpar. In general, I would say mobile devices are not supported
The interface is translated into several languages; change it in Options -> Interface settings -> Language. Generated names and notes stay in English. The Assistant and the docs use English button names, so look for a control in the same place rather than by its name
It's a nickname of the Generator creator, it has no meaning. The full name of the tool is Azgaar's Fantasy Map generator. The short form is FMG
Use it, report bugs at https://github.com/Azgaar/Fantasy-Map-Generator/issues/new?template=bug_report.yml, suggest or upvote ideas at https://github.com/Azgaar/Fantasy-Map-Generator/discussions/categories/ideas, share the Generator with your community, or support it on Patreon: https://www.patreon.com/azgaar
There is no team, but there is a Community. The tool is created by me, Azgaar. The community is based on our Reddit and Discord servers. Thanks for contributors, Community moderators and all our community members
Yes, you can support the project on Patreon. If you don't want to pay monthly, you are able to decline the donation at any moment in time. Other donation platforms are not supported
Yes, we have a dedicated Discord server and Reddit community. Both have a very active and supportive community
You cannot using the UI, but if you are comfortable with dev tools, you can amend the svg part directly. Open the console (F12) and run: document.querySelector('#labels-capital').style.textDecoration = 'underline'. Use another burg group name instead of capital if needed. The change may be lost when labels are re-rendered
Azgaar's Fantasy Map Generator (FMG) and Roblox Studio are two separate tools that aren't compatible with each other. FMG heightmaps are just an array of values, but you can also set Layer preset to Heightmap and Style to Monochrome in FMG and then export an image in png format. This format should be possible to use in Roblox Studio
Yes, you can use Submap tool for that. Submap is a tool that generates a new map out of a part of the current one. Menu -> Tools -> Submap
Is there a way to generate heightmap based on current one? Basically I want to keep roughly same shape of continents but regenerate details \ add more islands
You can use the Submap tool (for a part of the map) or the Transform tool (for the whole map). Both recreate the map based on the current one and try to keep the shape, but details are regenerated. Both are available in Tools -> Create
Rulers and dynasties are not supported as data. As a workaround describe the ruler in the state's notes (legend); the Notes Editor can also generate the text with AI if you provide your own API key or run a local Ollama model
To make your map cover more distance, go to Tools -> Units and increase the '1 map pixel' distance scale value
Open the States Editor and set the state type to Nomadic: nomads have a huge sea and lake crossing penalty. Then open the regeneration menu (cog button) in the same editor and click on 'Recalculate states'. The type is inherited from the state's culture on generation, so you may want to change the culture type in the Cultures Editor as well
Fantasy Map Generator (FMG) is a free tool that procedurally generates highly customizable fantasy maps. You can use auto-generated maps or create your own world from scratch
Press New map! for a random world and explore it with the presets in the Layers tab. Change Options (template, number of states and so on) and generate again to get closer to what you want. Then edit anything with the editors in the Tools tab. To shape your own continents, use Tools -> Heightmap: erase the land and paint it, apply a template, or convert an image. New here? Try the Quick Start Tutorial: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Quick-Start-Tutorial
Yes, the video tutorial is available. Here is the YouTube link: https://www.youtube.com/playlist?list=PLtgiuDC8iVR2gIG8zMTRn7T_L0arl9h1C
You can ask questions here or go to our Discord server. If you want a basic guide, check out the Quick Start Tutorial: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Quick-Start-Tutorial
We have a Reddit community on https://www.reddit.com/r/FantasyMapGenerator
Yes, with the Battle Simulator. Click a regiment, press Attack foreign regiment and click a regiment of another state: the attacker moves to it and the battle opens. Unit power, set in the Military units editor, decides the strength
Open Style -> Icons, select the burg group (city, town and so on) and click its icon. Pick a bundled icon or emoji, or open Custom to upload or link your own image. All burgs of the group use it. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Icons
Click any icon to open the icon picker (burg groups, goods, markers, regiments, relief and so on), open Custom and upload an image (SVG up to 200 kB, or PNG, JPEG or WebP up to 2 MB) or paste a link. Uploading is safer: a linked icon disappears if its site removes the image. Replace swaps the picture everywhere it is used. Guide: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Icons
They are saved in the .map file, so they travel with the map. The browser also keeps them for your next new maps. Linked icons show only while their website is reachable
A linked icon is loaded from its website each time, so it is missing offline, when the site removes the image or when the site blocks other pages from using it, which also drops it from PNG exports. Upload the image instead: select the icon in the picker's Custom list, press Replace and upload the file
To create a new country open the States editor: Go to "Tools" -> "States". Look for a button to add a new state at the bottom of State Editor. Click on it and then click on a map to place a new state there. You can adjust the borders of your country using the States editor brush tool
Open Tools -> States, click the brush button and paint the invader's state over the conquered land. To mark the war, set the states as Enemy in the Diplomacy editor or add markers
Create a namesbase in Tools -> Namesbase (or upload a .txt list) and assign it to a culture in the Cultures Editor; new names for that culture come from it. To rename existing entries in bulk, download the overview table as .csv, edit the names and upload it back
The map maker works better for country-sized regions. It doesn't have city blocks, buildings or anything for city-sized mapping.
Culture sets themselves are hardcoded and cannot be extended. You can create custom namesbases in Tools -> Namesbase and assign them to individual cultures in the Cultures Editor
You can use custom namesbases: create them one by one in Tools -> Namesbase and then set the namesbase per culture in the Cultures Editor; states and burgs use the namesbase of their culture
Send them the .map file; they open it in the Generator and can explore layers, search and notes. Tick View-only in the Save dialog if they shouldn't edit it. You can also embed the map in a web page: https://sites.google.com/view/fantasy-map-generator-embedded/home
Generic, Naval, Lake, Highland, River, Nomadic and Hunting. The type comes from where the culture starts: Nomadic in deserts and grasslands, Highland in mountains, Lake by big lakes, Naval on coasts and islands, River along big rivers, Hunting in forests, tundra and wetlands, Generic elsewhere. It decides which land the culture spreads into easily. Change it in Tools -> Cultures
An optional label such as Elfish, Dwarven or Human, set in Tools -> Cultures. It shows next to the culture name in tooltips, and cultures with the same ancestry share a Folk religion when religions are generated
Use the Image Converter: Tools -> Heightmap -> Erase -> Image Converter. Load an image, ideally a grayscale heightmap where lighter means higher, assign heights to its colors (auto-assign helps) and confirm. Then edit the new map with the usual tools
Is there a way to take a very basic heightmap and apply some template to it in order to achieve better feature placement than I can do by hand?
Not within the tool, I'm afraid. You can import heightmaps, but there's no function to generate more patterns onto it. You could, for example, generate a random map from which you like the features, export it as an image, then use some Photoshop-adjacent tool to mix it with your basic heightmap and then import that
You can manually add as many cultures as you want. Or change the Cultures set to Random, it'll let you move the slider up to 100
Population depends mainly on by area / biome, but there are other factors as well: river or lake nearby, specific featurs like river estuary or if there is a safe sea harbor, cell elevation, burg status, etc.
A lake needs a heightmap edit: Tools -> Heightmap in Risk mode keeps most data. With 'Allow water erosion' on, rivers are regenerated when you finish, so lock the rivers you want to keep first (the lock button in Tools -> Rivers)
I have issues with download. The button disappeared after I clicked it. Even though I didnt download the app
The browser's Install button only appears until the PWA is installed, check your desktop or app launcher. You can also install the tool using Chrome menu: Chrome menu -> Cast, save and share -> Install page as app. If you want a regular installer instead, download the desktop app from https://github.com/Azgaar/Fantasy-Map-Generator/releases
Yes, a desktop app for Windows, macOS and Linux: https://github.com/Azgaar/Fantasy-Map-Generator/releases. There is no mobile app. Chrome and Edge can also install the web version with the Install button in the address bar
I want to move the point at which the ice caps start further away from the equator, but I don't want to change my biomes. Any ideas?
The Ice layer is generated from temperature with a fixed threshold, so the starting point cannot be moved without changing temperatures, which also affects biomes. What you can do is edit the ice manually: turn the Ice layer on and click on a glacier or iceberg to edit or remove it, and add new icebergs from the same editor
Go to Tools -> edit States. Click the State name, you'll see 2 buttons, a refresh icon and a book icon, click the book icon to re-roll the name using the namesbase of its culture: click the refresh icon if you just want a random name
Open Heightmap editor in Erase or Risk mode and then add the new land using the Brushes
Yes. Unit types are edited in Tools -> Military -> Edit Military Units. Applying the changes keeps the regiments: a renamed unit keeps its troops, a removed unit's troops are disbanded, and a change of icon, crew or power applies at once. For a new unit, or one whose share, type, limits, goods or separate flag changed, a dialog offers to update just those units (their troops join the nearest regiments, which keep their names, places and other troops), regenerate all regiments from scratch, or keep the current troops. To recalculate one state's forces, select the state in the Regiments Overview and click Recalculate
They equip it. Each unit in Tools -> Military -> Edit Military Units lists goods, such as arms for infantry or horses, camels and tack for cavalry. Once the economy has run, a state fields a unit only as far as its goods can equip it. The remaining conscripts are not lost: they are raised as levies, so the army keeps its size but is weaker. A unit with no goods is always fully equipped. If no unit has the levies type, unequipped conscripts are not raised at all
Any of them, and they add up. Cavalry listing horses, camels and tack is equipped by horses alone, and a state with some of each sums them
They share. A good several units list is split between them by their troops: infantry and archers both use arms, so a state with enough arms for half of them equips half of each. Goods are not unlimited per unit
Just have them. What counts is what the state consumes: what its townspeople and rural people buy or keep from their own output, and what the state buys with its budget. Imports count, so a state that makes no arms but buys them is equipped. Exports do not count, so a state that sells all its arms abroad is not
No. The army only reads what the state consumes, it does not buy goods of its own, so the economy is the same with or without it. Troops are paid for separately, from the state's military spending
One unit a day equips 365 troops × the good's military coverage, shown in its Demand Coverage in the Goods editor. Arms have coverage 2, so one unit of arms a day equips 730 troops. Horses have 0.9, so 4 horses a day equip about 1 300 cavalry. This holds at the default population rate of 1 000 people per point; troops scale with the rate
Neither exactly: a unit is an abstract lot, not a set number of items. Only the ratios between goods matter (their prices, what they cover, how far they travel, how common they are), so think of beer and cloth by the cartload, and jewelry and boats by the piece. For the army, one unit of a good a day keeps 365 troops × its military coverage equipped, so 3 arms a day equip about 2 200 troops
The state does not consume enough of its units' goods, such as arms, horses, artillery, gunpowder or boats, to equip them. To field fewer levies, remove goods from a unit in Tools -> Military -> Edit Military Units. Equipment is worked out when troops are raised, so after regenerating the economy, recalculate the military in the Regiments Overview to equip them from the new economy
Is there any way I can, after making a map, select a specific state and only work on that state as a seperate map?
No, but you could visually fog the other states by pinning the State you want on the Sates Editor window, or make a submap that mostly encompasses the territory of the desired state (zoom in until your state is occupying most of the screen and then use the Submap tool)
Map size in pixels is irrelevant, the detail is assigned by the points number: the more points, the more detail. If you mean the size of the map in km or miles, go to Tools -> Units and increase the '1 map pixel' distance scale. To change the number of cells on an existing map use the Transform tool
Every state must have a capital, so it cannot be removed. You can only hide capitals visually: toggle off the whole Burg icons or Labels layer, or set the opacity of the capital group to 0 in the Style menu
Is there any way to get the system to automatically number the hexes on the map? I have a grid layer, set to 16 mile hexes on my map. Is there a way to count how many hexes are in the grid, or a way to set the system to automatically number each hex?
No, grid overlay is just visual
No, fog edges cannot be made blurry
Go to Tools -> Units and change the '1 map pixel' distance scale. To change how much of the world the map covers, use Map size in Options -> Configure -> Climate
Open Tools -> Provinces, click Annex provinces (crown icon), click the province that absorbs the others, then click the ones to merge (hold Shift for several). Only provinces of the same state can be merged
Not per icon. Style -> Relief sets the outline color and opacity of all relief icons and switches between the Simple, Colored, Gray, Illustrated and Stickers sets. For your own colors, use your own art as custom icons: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Icons
Edit the heightmap in Risk mode, change some land cells, it should help. Probably your coastline is too complex, the algorithm cannot handle it
How do I make it so whenever I generate a state I get names from a specific language? I wanted to create states with portuguese sounding names
You need to change the namesbase of the culture where you're spawning states and regenerate burg names for this culture. Tools -> edit Cultures
Search and upvote ideas at https://github.com/Azgaar/Fantasy-Map-Generator/discussions/categories/ideas, or post a new one there with the problem and how you'd use the feature. On Discord, use /idea or #fmg-suggestions
Describe the problem and how you'd use the feature, for example: "Group journeys by campaign. I run two campaigns on one map, and filtering by campaign would show only its journeys." Search existing ideas first and upvote instead of duplicating
Ask the community or a moderator in the FMG Discord server: https://discord.com/invite/X7E84HU. Use #fmg-bugs for problems and #fmg-suggestions for ideas. You can also ask usage questions at https://github.com/Azgaar/Fantasy-Map-Generator/discussions/new?category=q-a
I'm just an AI bot who can help you with the tool
Open Tools -> Heightmap in Risk mode, lower an area below sea level and finish the edit: it becomes a lake. Then rename it or change its type (freshwater, salt, frozen and so on) in the Lake Editor
Install the desktop app from https://github.com/Azgaar/Fantasy-Map-Generator/releases: it runs in its own window and works offline. Or, in Chrome or Edge, install the web version with the Install button in the address bar and open it once online
The tool and created maps are availalbe for free under the MIT license, see the details https://github.com/Azgaar/Fantasy-Map-Generator/blob/master/LICENSE
Using States Editor you can paint with the color of other state in that region. Alternatively in Provinces Editor you can make the province independent and then merge that state into another one in States Editor
State borders can be changed using Tools => States Editor. You can paint with a brush with the state that wins that terrain
There's an Image Converter on the Heightmap Editor, but the tool cannot generate random terrain on top of an imported map.
Is there any way to generate a map without any cultures or population? I like to work on those by hand
You can set States number to 0 in Options and regenerate. Cultures number cannot be set below 1, but you can remove cultures one by one in the Cultures Editor (and burgs in the Burgs Overview) after generation. Population is calculated from cells and burgs, so removing burgs and states leaves you with neutral lands to work on by hand
Follow the steps. 1. Save the map to the browser (F6). 2. Go to Options -> Configure -> Advanced and set 'On load' to 'Open last saved map'. 3. Add URL parameters to make it look like this: https://azgaar.github.io/Fantasy-Map-Generator/?scale=4&x=800&y=200. 4. Change scale, x and y values as you need and use the link
The browser draws the map as SVG, which is not fully GPU-accelerated, so big maps can lag. If it does, set the Performance preset in the Options tab to Speed
Press enter when on the seed input in Options
The map is static. Over-time simulation is planned, but not yet implemented
Follow the generator's own order: heightmap and climate (Options -> Configure), biomes, cultures, states, burgs and routes, religions, provinces, then the economy, military, zones and markers
No, only the width at the river mouth is available. Click on the river to see its details, or open Tools -> Rivers to see length, discharge and mouth width for all rivers
Rendering of ocean cells can be set via the checkbox in Style -> Heightmap -> oceanHeights group
Is temperature the averaged temperature across the entire year (all temps added, then divided by 365)? Or is it something else?
Temperature is annual average
Not automatically. Load the screenshot in Tools -> Heightmap -> Erase -> Image Converter: a heightmap image converts almost by itself, a political map needs you to assign land or sea to each color. States, burgs and the rest then have to be redone by hand
Yes. You can put it as Texture. Click on Style -> select element -> Texture. And next to the image dropdown there is a Plus icon. Provide the URL of the image and apply. Make sure the server where the image is hosted allow CORS requests. You can put any image there
Underwater towns and cultures are not supported. However some users suggested a workaround: style your ocean to look like land and land to look like an ocean. Then roleplay like that land is water from an ocean and the outside water has no population
Yes, Journeys: Tools -> Journeys (Shift + J). Add a journey and pick a transport for each leg (on foot, horse, ship and so on); it finds the route along roads, sea lanes and rivers and calculates distance and travel time. To just measure a distance, use Tools -> Measurers. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Journeys
Reduce layers: the program has a lot of steps in height and it may look too crowdy. "Reduce layers" skips each x-th step in heightmap. So the higher the value is, the less steps is rendered
Simplify line defines line simplification level. Heightmap isoline consists of multiple points to draw a curve, simplification defines how many points can be skipped to make the line less detailed and more smooth
In Style, Dash array makes a line dashed: the numbers are dash and gap lengths, such as '2 1'; leave it empty for a solid line. Linecap sets how line and dash ends look: butt cuts them flat, round rounds them, square extends them slightly
Lower Growth rate in Options -> Configure -> Advanced: states expand less and leave neutral land. On an existing map, use the same slider in the States Editor's regenerate menu (cog button) and press Recalculate states. You can also lower individual states' Expansion
Tools -> Heightmap -> Erase or Risk and make sure that whatever cells you put under sea level are surrounded by land cells. It'll automatically be considered a lake. See also 'Can I create a lake?' above
You can change the layer order on the Layers Tab: the sort button at the end of the Layers preset row opens a list where you drag the layers. It can be done for most of layers
It looks that you have a browser extension like Dark Mode that affects the map colors. You need to toggle it off or disable to run on the Generator page
Let's find out. Open Tools -> edit States. Make sure the list of states is sorted by Area. The first state displayed in the list should be the biggest one. If you want, you can change the table sorting
To start a battle ensure the Military layer is on. Then click on any Regiment and press the button to attack. Then select a regiment you want to attack. It will open the Battle Simulation dialog, where you can add more regiments, change battle settings and simulate the battle
Open Tools -> States and click a state's color box to open the Color Picker; pick a color and the map updates. Repeat for each state. The same picker works for provinces, cultures, religions, biomes and zones
Yes. In the Color Picker click a hatching pattern in the row below the preset colors, then pick a color above to color the hatching. Click the selected pattern again to go back to a solid fill
You can either regenerate emblems for all states (via Tools -> regenerate Emblems) or for an individual state, province or burg. For that click on an emblem and click on Regenerate in the Edit Emblem dialog
We recommend to set Precipitation to 100 for a Earth-like world. Obviously, the real climate is different and it depends on multiple factors, but 100 is considered to be default setting for a "pretty wet" world
To make your map more desert-like, adjust the precipitation level in Options -> Configure -> Climate. Setting it to zero will create an unlivable desert across most of the map
Keep wind directions default. The default settings are already similar to Earth
Click on the route or river. In the Editor dialog click on the button to show the Elevation profile. It will display burgs the route/river is passing
Each state must have a capital. So to remove the capital burg, you need to reassign the capital status to another burg first and then remove the initial burg. Alternativelly you can remove the entire state, it will make the old capital a usual neutral burg
Remove its market first: in Tools -> Markets delete the market (trash icon), or move it to another burg with Relocate in the Market Stock dialog. Then the burg can be removed
Yes. Post or upvote ideas at https://github.com/Azgaar/Fantasy-Map-Generator/discussions/categories/ideas, or use /idea on Discord. A chat message alone doesn't create a suggestion
Please use the Units Editor. It's available in Tools
Go to the "Tools" menu and select "States". There, you can find the specific state you want to rename, click on its name, and use the available options to regenerate the name. If you want to change the culture, do it first using States Editor as well
No, this feature is not supported. You can only adjust borders manually using the States Editor
Yes. Uncheck 'Allow water erosion' in the heightmap editor before finishing: rivers stay, ending at the new coast. With erosion on, rivers are regenerated except locked ones (the lock button in Tools -> Rivers)
Not really. The size mostly depends on the points number and cannot be changed for an existing map; turning off some layers can help a bit. You can gzip the file with an external tool: the Generator loads gzip-compressed files (.gz) directly, so there is no need to unpack it before loading
Open Chats in the Azgaar Assistant title bar. New chat starts an empty chat for the open map. Each chat stays in this browser until you delete it with the trash button. A chat from another map or answerer can be read, but you must start a new chat to continue.
Go to Options -> Interface settings and set Azgaar Assistant to Hide. This hides the call bubble.
The free daily allowance is set by the Azgaar server. A Guest can sign in with Discord for a larger allowance, or connect an AI key or local model for unlimited questions.
Guest and Member questions send only your question and the server chat id to the Azgaar server. Nothing from the open map is sent. A connected key or local model sends your questions, chat history, a map summary, and results of map reads directly to that Provider. The Policy page has details.
Yes, with a connected AI key or local model. Ask in the same panel you use for Generator questions. The Assistant can read the open map to answer exact questions, and can download CSV or JSON built from it. Guests and Members can ask documentation questions but the Azgaar server cannot see their map.
Guests and Members on the official site can ask documentation questions without a key. Connect a key to ask about your map, edit it and remove the daily limit. A local model needs no key. On a self-hosted copy or in the desktop app, connect a key or local model to use the Assistant.
Anthropic, OpenAI, Mistral, Qwen, DeepSeek, and an OpenAI-compatible local server such as Ollama. Choose a Provider in the key sheet. The Assistant discovers models available to the key and also accepts any typed model id. One default is offered while discovery is pending.
Yes, with a connected key or local model that supports images. It can look at the map or a place on it, and you can paste up to four images, such as a sketch or a style reference, into the question box. Guests and Members cannot attach images
Your question and any images you paste, earlier messages in the chat, the Assistant's instructions, a summary of the open map, the open note and selection if any, and results of the map reads the Assistant performs. Those results can include names, statistics, note text or pictures of the map. Your key and data go directly to the Provider, never through the Azgaar server.
Yes, with a connected key or local model. It proposes changes as a card listing each change before -> after; nothing happens until you press Apply, and Discard drops it. If a detail is missing, such as where to place a new state, it asks first
Most of what the editors do: renaming, recoloring and retyping; notes; creating, removing and moving states, provinces, burgs, cultures, religions, rivers, routes, markers, zones, labels, regiments and journeys; repainting territories and merging states or provinces; diplomacy, taxes and treasuries; population; emblems, lake types and coastlines; goods and market names; and the map's name, year and description. Just ask: it says when it can't do something
The heightmap, relief icons, ice, name bases, transport types, the placement of goods and markets, styles and settings. Use the editors for those. The Assistant should tell you when it has no operation for a request
Press Undo on the applied card in the chat; it reverts the whole batch. If you have edited the same things since, the button reads Changed since and can't undo
The project charges nothing; your chosen Provider may bill you. The footer shows the tokens used by this chat. Each question resends the chat's earlier messages, so long chats cost more and take longer. When a chat gets long, start a new one from the notice.
Open Tools -> Rivers, press Add River and click a cell: the river is generated downhill from there (also Tools -> Add -> River, Shift + 4). To draw one by hand, use the 'Create a new river selecting river cells' button
Click the river to open the River Editor and change Source width (extra width at the source, 0 by default) or Width modifier (a multiplier for the whole river width, 1 by default). The mouth width follows
You can Transform the map into a new one with larger amount of cells. The new map will be based on the existing one and the Generator will try to keep the details as they were, but it's still a new map, so some data can be changed. You can find the Transform tool in Tools
You can create a new Regiment using the Regiments Overview. In can open if you click on a button with list icon in the Military Overview (available in Tools). In the Regiments Overview you can select a state and add a Regiment for this state. Then you can click on this new Regiment to edit its name, icon and military forces
Open Tools -> States, click Annex states (crown icon), click the state that absorbs the others, then click the states to annex (hold Shift for several). Or use 'Merge several states into one' to pick from a list. Tick the checkbox in the confirmation to keep annexed states as provinces
The Generator doesn't simulate wars, but you can set a Diplomatic relations between countries to "Enemy", which means a state of war in the Tool. You can also start a Battle between two or more Regiments. The Generator has a simple Battle Simulator
You can create a heightmap of any region of the Earth using the Heightmapper tool available at tangrams.github.io/heightmapper
The Tools tab is one of the main tabs of the Menu. You can open the Menu if you click on the arrow button at the top left corner of the screen
No, dynasties are not currently supported
Rivers, lakes, islands and oceans get names automatically; mountains and forests don't. Rename features in Tools -> Features. To show a name on the map, add a label with Tools -> Add -> Label (Shift + 2)
Open Options -> Interface settings -> Language, pick a language and press Reload. Save the map first, as the page reloads
Probably. The Assistant and the docs use English names, such as Tools -> Edit -> States. In another language, look for the control in the same place: tabs, buttons, icons and shortcuts don't move. Hover a control to see its tooltip, or switch to English for a moment
The generator is supposed to work with Earth-like maps, but with some creativily you can use Style to make your map look like a Galactic map. You may find some examples on our Discord server
Yes. Open Tools -> Heightmap, choose Erase and paint your land with the brushes, or apply a template. Finish the edit, set the climate in Options -> Configure -> Climate, then shape biomes, cultures, states and burgs with the editors in Tools. Save the .map file often
No. You can create Provinces inside States, but not Provinces inside other Provinces and not States inside other States
Yes, you can add a city. Use the shortcut Shift + 1 (Tools -> Add -> Burg) and click on the map to add a burg. Then open the burg and change its group to 'city'; burg groups and their criteria are configured in the Burg Groups configurator. Alternatively you can add new burgs from the Burgs Overview
A shanty town feature refers to a type of settlement characterized by informal housing and typically lower living conditions. In the context of the Tool, it represents a specific attribute of a burg, indicating that the area may be populated by lower-income individuals or lacks formal infrastructure.
The see the latest changes, please check out the Changelog: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Changelog
The "growth rate" setting defines how far states and cultures will expand into neutral lands during generation. A lower value will result in more lands remaining politically neutral. It is in Options -> Configure -> Advanced
The "size variety" setting determines how much the areas of states should differ from each other. A lower value results in more uniform state areas. It is in Options -> Configure -> Advanced
Yes, the application data is stored in browser cache, so it's important to clear it in case of issues. Cache issues are common after major releases, it's happening because browser is still using the old files instead of the new, updated ones. Cookies are not used by the Tool, so no need to clear them
No, temperature can only be set for the entire world
You cannot import it, but you can set it up using the Biomes Editor in Tools
Yes. In Style -> Heightmap turn on Contours for elevation lines (set Font size above 0 to label them) or Hachures for slope strokes. Both change only the look, not the heights
Pick Ink, Cinderwood or Frostbite in the preset select at the top of the Style tab. To mix their effects into your own style, see https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Map-embellishments
They are Performance presets in the Options tab. Quality looks best; Speed is fastest, as it hides state halos and redraws the map only after you stop zooming; Balance sits between. They change only the display, not the map
You can select one of the available heightmap color schemes or create a custom one in Style -> heightmap element
The meridian length and world size can be adjusted in the World Configurator (Options -> Configure -> Climate), specifically using the Map Size parameter. After that, you can further refine settings in the Units Editor
If you mean states, you can change them using the State Editor. You can find it in Tools
Reload the page: the version is displayed under the logo on the loading screen and is also appended to the browser tab title. To see what changed check the Changelog: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Changelog
To see the whole map set the zoom to a minimal level. You can also press the '-' key to zoom out. If it's still not the whole map, try changing the Zoom Extent min value to a fraction of 1, e.g. 0.6. This will help is the map canvas you are working is bigger than your browser window.
Yes. The countryside produces raw goods, burgs make products, markets trade them and states tax the deals. It shows one typical day; the numbers change only when you regenerate the economy. Turn on the Goods, Markets and Trade layers to see it, and read https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Economy
Resources and products like grain, iron, wood or wine. The countryside produces raw goods, and burgs make products from them. Open Tools -> Goods to see them all, add your own or click a good to edit its price and demand
Yes. Open Tools -> Goods, click a good, then click its icon to open the icon picker. Choose a bundled icon or emoji, or open Custom to upload or link your own image
A trade hub at a big burg. The countryside around it sells its produce there, and burgs buy and sell goods there. Turn on the Markets layer to see their areas, click one for its stock and prices, or open Tools -> Markets
On the biggest burgs, favoring capitals, ports and crossroads. To change them, open Tools -> Markets: add a market on any burg, remove one, paint market areas or move a market to another burg
A market buys below its price and sells above it by its margin, which goes to the merchants of the burg at its center, so busy markets make their hub rich. It is 4% where the market pays little or no license, as under unions and most republics, and rises with the state's license fee: 5% under a typical monarchy, up to 6% under a greedy theocracy. See it in the Markets overview
Sales is what burgs paid the market for its goods, Buys is what it paid burgs for theirs, and Value is Sales minus Buys plus its unsold stock
The countryside produces raw goods depending on its people and biome. Burgs make products from those goods and sell where they get the most. Prices differ between markets with supply and demand. To see what a burg makes, click its pie on the Goods layer or the chart button in the Burg Editor; Tools -> Goods -> production chains shows what each product needs
For a raw good, change its biome output or deposits in the Goods Editor: its price and demand coverage do not change how much is gathered. For a manufactured good, workers choose what pays best, so use multipliers first, then its recipe, demand coverage and base price, and combine them for a big change. See the Economy page
Each cell in the color of its most valuable good, icons on deposits, and pies of each burg's main goods. Select goods in Tools -> Goods to show only them, and click a burg pie's ring to see its production. Style -> Goods turns the cells, icons and pies on or off
How well people live, from 0% to 100%, based on what they can buy; bare needs is about 17%. It is not happiness. See it in Tools -> Burgs, the Burg Editor and Tools -> States
A land's technology from 1 to 100 (0 where nobody lives), from hunter-gatherers to a post-human civilization; up to the Late Middle Ages every era takes three points, so 12 is the Bronze Age, 18 the Iron Age, 30 the High Middle Ages and gunpowder, 36 established artillery and 40 the printing press. Each culture has its own level, set by the culture set: most sets give a medieval world with a few leaders such as dwarves at 50–53 and elves at 44–46, and laggards such as orcs at 18 and giants at 8; the Antique set gives a classical world. It spreads from each culture's center along routes. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Development
Its capital's development is under 12, before the Bronze Age, so its people know no kingdoms: monarchies become Tribes, Chiefdoms or Paramount Chiefdoms (Hordes for nomads), republics Tribal Councils, unions Clans Unions and theocracies Shamanates. Change the form in the States editor, or raise the culture's level in the Cultures editor and regenerate development and states. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Development
Goods need development to be made or gathered, by the era they were first traded in: grain and cattle 6, tools 15, iron 18, paper and books 21, glass 24, gunpowder 30, artillery 36. A burg in a less developed region cannot make them and buys them instead. Past 30, development also raises output: every good yields development / 30 times as much, so 1.5 times at 45. Development is set when the map is generated; see and paint it in Tools -> Development (Shift + X), then regenerate the economy. A culture's own level is set in the Cultures editor's Development column, a biome's effect in the Biomes editor's; regenerate development to apply. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Development
Burgs buy from their own market; when it lacks a good, they buy it from the cheapest other market they can reach. They sell to whichever market pays best. Turn on the Trade layer to watch the deals
Moving goods costs carriage along roads and sea routes; sea is five times cheaper. Each good has a Carriage Price in its editor (Tools -> Goods): bulky goods stay local, valuable ones travel far
It animates the day's deals as flows between burgs. Click a flow to see the deals behind it. Tools -> Trade changes the animation's speed and look
Open Tools -> States: Prosperity shows how well a state's people live, and Balance, shown from the column menu, what the state keeps of the day's taxes. Click either to open the state's Economy dialog with its product, wealth, trade and main goods
A sales tax on every sale, a poll tax per person, a license fee from each market and tariffs on imports. Rates start from the state form: monarchies tax most, republics lightly, anarchies not at all. To change them, see "How do I change a state's taxes?"
Open Tools -> States and click the state's Prosperity to open its Economy dialog, then press the bank button. There you set taxes, tariffs and how the budget is spent
A tariff is a tax on goods a burg buys from or sells to another state's market, levied by the state the goods go to; an embargo stops that trade both ways. Set them per state and per good in the state's taxes dialog. They start from diplomacy: allies trade freely, rivals pay more, enemies are under embargo
A fixed fee a day that each market's center burg pays its state, whatever its trade. Unions and anarchies charge nothing, trade republics little, monarchies more and theocracies the most. States with dear licenses get fewer markets, farther apart, their markets charge a higher margin, and a quiet market under a greedy state goes into debt
The share of state spending officials pocket. It depends on the form of government, the state's size and its minorities, and is higher in far provinces. Spending on administration lowers it. Set it in the state's taxes dialog
Court and clergy, administration, infrastructure and military; what is left stays in its balance. Change the shares in the state's taxes dialog
Military keeps the army strong in battles, infrastructure raises prosperity, administration cuts corruption, and court and clergy support stability. A bigger state must spend more for the same effect
How firmly a province holds together, from 0% to 100%. Prosperity, court and clergy and a well-paid army raise it; distance from the capital, minorities, corruption and high taxes lower it. Unstable states get more rebels. See it in Tools -> States and Tools -> Provinces
They have no taxes or budget of their own. To see a province's economy, click its Prosperity in Tools -> Provinces
What the burg has at the end of the day after selling, buying and paying taxes. See it as Day Balance in the burg's Economy Overview (the chart button in the Burg Editor). It can be negative
Open the burg's Economy Overview, expand its Adjustments row and add lines, each with a name and an amount a day; use a negative amount for debts. They apply when you regenerate production
Tools -> Regenerate -> Economy, and the regenerate button in the Goods Editor and in the Markets Overview, all open the Economy Regeneration dialog, where you tick what to run: restore the default goods, deposits, markets, market areas, production
Burgs make what pays best for their workers, so an expensive product with a long chain, dear inputs or high taxes can lose to a simpler one. On maps made before 1.153.0, run Tools -> Regenerate -> Production to use the corrected planner
Yes. Your goods carry over to new maps and survive a page reload. Only multipliers set for specific cultures, states, religions or zones stay behind, because those belong to one map. Opening a .map file replaces your goods with that map's. To start over, use Restore default goods in Tools -> Regenerate -> Economy.
Yes. Open Tools -> Goods, click the brush button and paint the good on the map; each cell holds one good. To change where a good appears on generation, edit its spread function: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Goods-spread-functions
Open Tools -> Markets and click on the compare button, or open a good in the Goods Editor and use the compare option there. The Compare Prices dialog shows the stock and the price of the selected good in every market, so you can find where it's cheap and where it's expensive
Yes. In the Layers tab switch View mode to 3D scene. Press O for settings like height scale, lighting, sky and water. You can't edit the map in 3D
Yes, open the Layers tab and switch the View mode to Globe. The map is projected onto a sphere with an equirectangular projection, so maps with a 2:1 aspect ratio look best and distortion is the strongest near the poles. Texture resolution and auto-rotation speed can be set in the 3D settings dialog
Yes. In the 3D settings turn on 'Eroded terrain' for ridges and valleys and 'Satellite texture' for a satellite-like look. Neither changes your map
Yes. The 3D settings dialog has a screenshot button that saves the current view as a .jpeg, and an OBJ export button that saves the terrain mesh as an .obj file for Blender and similar tools (the eroded mesh produces large files). OBJ export is not available in Globe mode
Use the Layers preset select at the top of the Layers tab: Political, Cultural, Religions, Provinces, Biomes, Heightmap, Physical, Places of interest, Goods and production, Trade map, Military, Emblems and Pure landmass. You can also toggle individual layers and save the current combination as your own preset with the plus button
Yes, press Space and type a name: states, burgs, rivers, markers and most other things are found, also by their notes. Select a result to open its editor. Start with > to search commands. See https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Omnibar
It lists everything at that spot across all layers, including what is hidden under other elements or on hidden layers. Click a row to open its editor. Shift + right-click opens the browser's own menu
In the Journey path editor, press Backspace to undo the last drawn point, and double-click a control point to remove it
Yes, Tools -> Show -> Minimap. It displays the whole map with the current viewport marked, click anywhere on the minimap to center the view there
Open Tools -> Cells (Shift + E) and move the pointer over the map. The Cell info panel shows the cell id, coordinates, latitude, longitude, geozone, area, feature type, elevation and depth, temperature, precipitation, river, biome, population, state, province, culture, religion, burg, assigned good, market and production
Yes, Tools -> Show -> Charts (Shift + A). You can plot states, cultures, religions, provinces, biomes and other entities by total, urban or rural population, land area or number of cells, group them by another entity and display the result as a stacked or normalized bar chart
Ctrl + click on a layer button in the Layers tab opens the Style tab with that element already selected. Most editors also have a style button (brush or adjust icon) that opens the Style editor for their layer
Religions are generated from cultures: Folk religions follow one culture, Organized ones spread across cultures and states, Cults are small and Heresies split off. Edit them in Tools -> Religions: rename, recolor, repaint borders with the brush, add or remove
Highlighted areas for events such as invasions, rebels, plagues, famines or disasters. Zones follow the economy: invasions strike rich border land, rebels rise in unstable states (as a tax revolt where taxes weigh heavily), disease breaks out in busy markets and ports, and famine in the poorest countryside. Each generated zone has a short legend: hover it on the map to read what is happening there. Edit them in Tools -> Zones (Shift + Z): add a zone, paint its cells and set its type, color and description
Roads, trails and sea routes are generated between burgs. To add one, use Tools -> Add -> Route (Shift + 5) and click the cells it should pass. Click a route to edit it, and manage all of them in Tools -> Routes
Yes, route groups are configurable. Open a route (or the Routes Overview) and go to the route groups editor: there you can add a group, set its style and move routes between groups
Click the object (a state, burg, marker, river and most others) and press its notes button. The notes editor supports formatting, links and images. Tools -> Notes lists all notes
Yes. In the Notes editor press 'Generate note with AI' and use an OpenAI or Anthropic key, or a local Ollama model: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Ollama-text-generation
States, provinces and burgs get generated emblems. Click an emblem (or open Tools -> Emblems) to regenerate it, edit it in Armoria, download it or upload your own image. Tools -> Regenerate -> Emblems re-rolls all of them
Markers are icons for points of interest. Add one with Tools -> Add -> Marker (Shift + 3) and click the map, then click it to change its icon, size and colors. Type a new name in its Type field to make your own type; style changes apply to all markers of a type. Tools -> Markers lists them all
Use locks. States, provinces, cultures, religions, burgs, routes and markers have a lock icon, and locked elements are skipped by the corresponding Regenerate command. Options rows have lock icons too - a locked option keeps its value when you generate a new map
Yes. Tools -> Regenerate -> Provinces opens a dialog listing all states with their province counts. Check one or several states (or All states) and click Regenerate: only the selected states get new provinces, others keep theirs, and locked provinces stay as they are
Groups like capital, city, town, village or fort set a burg's icon and label style. They are assigned by population, but you can change a burg's group in the Burg Editor and edit the groups in the Burg Groups configurator
Yes. Click on a burg to open the Burg Editor - it shows a live preview generated by Watabou's generators: the City generator for cities, the Village generator for smaller settlements and Dwellings for the smallest ones. You can zoom and pan the preview, open the full generator in a new tab, or set a custom link for the burg
Open the Style tab and click on the plus button next to the preset select to save the current style as a custom preset. The Style Saver dialog also lets you download the style as a .json file and load a style file back, so styles can be reused and shared between maps
Yes. In the Style editor, next to a font select there is a plus button that opens the Add font dialog. You can add a Google font by name, use a font installed on your machine, or provide a font name together with a direct URL to a font file (woff2). Fonts loaded from external URLs require an internet connection
In the States, Cultures, Religions, Biomes, Zones or Goods editor press 'Toggle Legend box'. Drag the box to place it, click it to hide it, and style it in Style -> Legend. You can show several at once
Yes, press the Legend box button in the Units editor to show the heightmap colors with their elevations
Dialog positions and sizes are remembered by the browser between sessions. When a dialog has a saved position, column layout or sort, a reset button (circular arrow) appears in its title bar next to minimize and close. It restores the default position and, for tables, the default columns and sorting. Table filters and map data are kept
Yes, use the focus (pin) icon. Open Tools -> States (or Provinces) and click on the pin icon of the element you want to focus on - everything else gets covered by the fog of war. Click the pin again to remove the fog
Yes: Tab toggles the menu, F2 makes a new map, Ctrl + S saves, single letters toggle layers and Shift + letter opens editors. Full list: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/Hotkeys
In the wiki: https://github.com/Azgaar/Fantasy-Map-Generator/wiki. Start with the Quick Start Tutorial; the About tab in the app links to the key pages
Yes. Press F1 or open the About tab in the menu, then click 'Interactive Tour'. It walks you through the map, the menu tabs, layers and presets, and the main tools step by step
The seed is the number behind a random map, shown in Options -> Map seed. The same seed gives the same map only with the same options, window size and version, so share the .map file to be sure. The copy icon next to the seed gives a link to the map
Save the map to Dropbox (Save -> Dropbox, or Ctrl + C), then open the Load dialog and use the Share button to create a sharable link. Anyone who opens the link gets the map loaded into FMG. The file has to be hosted on a server that allows CORS requests - Dropbox does, Google Drive doesn't
Press Ctrl + Q to turn the save reminder off, and press it again to turn it back on. The reminder shows up every 15 minutes and is independent of the autosave
Use Export -> Export to GeoJSON: cells, routes, rivers, markers and zones can be saved as separate GeoJSON files and opened in QGIS, ArcGIS and similar tools. There is a step-by-step guide in the wiki: https://github.com/Azgaar/Fantasy-Map-Generator/wiki/GIS-data-export
Overview dialogs (Burgs, Rivers, Routes, Markers, Labels, Features, States and others) have a search field that filters the table, sortable columns, and pagination for big maps. The sliders button in the dialog header lets you show or hide columns. Click on the target icon in a row to zoom to that element on the map
In Tools -> Burgs click the Burg column header, then the Province header. Burgs are then grouped by province and alphabetical inside each
Yes, Tools -> Features (Shift + F) lists every island, lake and ocean with its type and area. Use the target icon to zoom to one
Open Tools -> Features (Shift + F) and type the new name in its row. To show the name on the map, add a label with Tools -> Add -> Label (Shift + 2)
Islands, lakes and oceans come straight from the heightmap: an island exists because those cells are above sea level. To add or remove one, change the terrain in Tools -> Heightmap. The Features Overview only changes how an existing feature is named, classified and drawn
The subtype is what the feature is, and generation uses it: dry, frozen and lava lakes get no ports, for example. The group only sets how it is drawn
Changing a subtype relabels the feature, it does not regenerate anything - same as the other editors. Ports, goods and markers stay as they were until you regenerate them yourself (for example Tools -> Regenerate -> Burgs)
Click a lake, press the plus next to Group and name a new group; the lake moves into it. Style the group in Style -> Lakes and move more lakes into it from Tools -> Features
Yes, the project is open source and pull requests are welcome. Discuss your idea on our Discord first, then follow CONTRIBUTING.md in the repository
Main Page | Quick Start Tutorial | Q&A | Shortcuts | URL parameters | Changelog | Report a bug or suggest an idea | Policy
These pages are maintained in the main repository and synced automatically. Edits made here will be overwritten — please open a pull request instead.