Repository navigation
Releases
RealMap 1.3.0 — whole countries: towns, water and industries from Geofabrik extracts
Update the app and the mod (Mod Hub or realmap-mod-1.3.0.zip, then restart the game). The mod only changes its version number, which must match the app's.
Why this release
Players importing a whole country (Poland) hit two problems: first the preview stopped with « Maximum call stack size exceeded » (fixed in 1.2.2), then the map had no towns and no water, only the relief and the industries. The OpenStreetMap servers (Overpass) cannot handle a country in one request: they stop it after a few minutes and still answer « OK » with an empty list. RealMap took that empty answer as real data and even kept it in its cache. This release fixes the cause, and changes the way very large areas get their data.
Whole countries: Geofabrik extracts
Areas over 20,000 km² (a large region or a whole country) no longer use Overpass. The Overpass documentation itself says that country-sized extractions belong to downloadable extracts. RealMap now uses the free daily extracts of Geofabrik (OpenStreetMap data, ODbL).
Choosing what to download
- RealMap finds the extracts that cover your area, as fine as possible: Polish voivodeships, German Länder, Czech regions, small countries. It never picks a whole continent just because a corner of the map is at sea.
- Before anything is downloaded, a checklist shows each region with:
- its download size (or « in the cache », or « ready » if it was already read for this map);
- its estimated time (download and reading);
- the share of your area it covers.
- The total size and the total time update as you tick and untick. « Tick all » and « Untick all » are there too.
- Heavy neighbouring countries that only touch a thin strip of the map (under 1 % of the area, over 100 MB) start unticked; tick them back if you want their towns. A region left unticked gets no real towns, water or industries, and the journal names it.
- For the whole of Poland, the usual choice is about 6 GB (38 regions).
Downloading and reading
- Downloads are streamed straight to disk, resume after a cut where they stopped (on the same dated file, never mixing two versions), and check their size.
- Each region is read on your computer (in Rust, on all processor cores) as soon as it is downloaded, while the next one downloads. A 55 MB region reads in under a second.
- The step shows « 1.2 / 6.2 GB · region 5/38 · reading region 3/38 ».
- The estimated times learn from your own connection and computer after each run.
- Files stay in the cache for 30 days: the next maps in the same area start at once. Each region is read once per map frame and kept: ticking one more region only reads that one.
Same result as Overpass: on a test region (Opolskie), the extract gives the same places (111 / 111), roads (2,103 / 2,103), industrial sites (13 / 13) and land use (706 / 706) as Overpass, and 963 water areas against 961.
Very large areas: memory and data quality
- Relief: for a very large area, the Copernicus relief tiles are read at a resolution that suits the map (1/2 to 1/8, only the part needed is downloaded) instead of full 30 m resolution: a whole country needed about 2.5 GB of relief in memory (5 GB at peak), now a few tens of MB. The export reads them again at the finer level it needs.
- OpenStreetMap shapes are simplified to the map's precision (on maps where one cell covers more than about 40 m of real ground), keeping every road junction, and data outside the map frame is left out.
- Sea floor: the EMODnet sea floor of a very large area is requested at a suitable resolution (it used to ask for over 200 MB, fail, and silently fall back to the coarser ETOPO data).
- Project files: if the data of an area is too large for the project file, the project is saved without it (a warning says so); the data is read again from the cache when the project is opened.
- Usual maps are not affected: every reduction only starts beyond a threshold that regular map sizes and scales do not reach.
Lists of towns and industries
- You choose when the map is updated. Ticking or unticking towns, industries, roads or railways (in the lists or on the map) no longer recomputes the map every time. The bottom of the Lists panel shows « N changes pending » and an « Update the map » button. Tick « Update automatically » to get the old behaviour back. Changed lines are marked « pending » until the update.
- Many at once.
- Towns: filter by name, type (city, town, village), minimum population, ticked or not.
- Industries: filter by name, industry type and origin (OpenStreetMap, land cover, chain, added by hand).
- Then « Tick the N » or « Untick the N » applies to everything in the filter, in one click.
- A whole country has tens of thousands of places: the list shows the first 300 lines, the buttons always act on the whole filter.
- A warning shows when more towns are ticked than the game puts on a map of that size (they are placed if there is room).
- The automatic update of the advanced options only follows the options now, not these choices.
- The Lists panel is wider (520 px) and can be resized by dragging its right edge; its width is remembered.
Usual areas (Overpass)
- Towns no longer depend on the water. Places have their own light request. If a request fails, you get a clear error instead of a map without towns.
- Following the Overpass rules (usage policy):
- each request declares the time and memory it really needs, so busy servers accept it sooner (the maximum used to be requested from about 4,000 km² on);
- when a server asks to slow down (HTTP 429), RealMap waits 30 seconds as the documentation asks;
- it never runs more requests at once than the server allows;
- an answer cut short by the server (« runtime error », out of time or memory) is detected, never kept in the cache, and requested again in up to 256 smaller pieces.
Other fixes
- Download caches are written safely: an interrupted download no longer leaves a broken file that blocked the next imports. Empty answers kept by earlier versions are downloaded again.
- The technical journal now says when a download falls back to another source, is cut short, or is split, and gives the download and reading speeds.
- Region names from Geofabrik no longer show HTML tags («
»). - New texts are translated into German, Italian, Spanish and Simplified Chinese.
Thanks to the players who reported the Poland imports!
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.2.2 — very large areas no longer stop the preview
Update the app and the mod (Mod Hub or realmap-mod-1.2.2.zip, then restart the game). The mod only changes its version number, which must match the app's.
Fixes
- Very large areas (a whole country): the preview could stop with « preview: Maximum call stack size exceeded », whatever the map size. The OpenStreetMap data of the area (hundreds of thousands of villages, ponds, roads…) is now handed to the map computation in smaller batches. Thanks for the report!
- Journal: an error in the map computation now writes where it happened to the journal. If a problem persists, please send it to us (Journal panel, or the
log.jsonof the project).
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.2.1 — the experimental map sizes, a railway that keeps off the roads, the map follows the opened project
Update the app and the mod (Mod Hub or realmap-mod-1.2.1.zip, then restart the game).
New
- Map sizes beyond Very large: Huge, Megalomaniac, Gigantomaniac (up to 28.7 × 28.7 km), Tiny and the 1 : 4 and 1 : 5 formats are always listed. The game offers them only with
experimentalMapFeatures = truein itssettings.lua(game closed, PC, 16 GB of RAM advised): while that is off, they are greyed out and a link opens the file. RealMap reads the file again when its window gets the focus back, no need to restart the app. A project saved with an experimental size keeps it; the export waits until the game offers that size. Thanks for the report! - A railway that keeps off the roads: the line no longer weaves from one side of a road to the other. It foresees the roads the game will build between the linked towns and stays on one side, crossing them only where it has to. It may now leave the real line by up to 1,000 m (new projects; Advanced options › Distance from the real line, up to 2,000 m).
Fixes
- Railway under the roads (mod): the generation could stop at the railway (« attempt to perform arithmetic on field '?' ») when a line met several roads. The track under a road no longer makes a kink (« Excessive curvature »), the tunnel grows when a road comes too close to its mouth or a few roads are close together, the track climbs back between them instead of staying deep, and a piece refused in the cutting is tried again as a tunnel, not as a bridge.
- Opening a project (or switching to another one, or the projects of the last session at start) now centres the map on its area. Thanks for the report!
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.2.0 — map projects, rivers and lakes on demand, separate road networks, the railway under the roads
Update the app and the mod (Mod Hub or realmap-mod-1.2.0.zip, then restart the game).
New
- Map projects: each map is now a project you can keep. File › Save (Ctrl+S) writes a
.realmapfile in the folder you choose, with the settings, the downloaded data cut to the area, the result and the log: it reopens at once, even offline. File also has New, Open, Save as and Close (Ctrl+N, Ctrl+O, Ctrl+Shift+S, Ctrl+W). - Projet tab: the open projects as a tree (✱ = changes not saved; click to switch, right-click to save or close), with the log below it. The app reopens the projects of the last session and asks before closing a project, or the app, with changes not saved.
- Rivers and lakes can be turned off (Advanced options › Water): the game has a single water level, so rivers and lakes are dug down to it and their valleys lowered. Unticked, only the sea stays and river beds and lake floors keep their real relief. Thanks for the idea!
- Separate road networks at the start: towns are linked in small networks (3 towns at most by default, Advanced options › Roads) for you to join in game, never a lone town: each town has another town or an industry. Each industry is shown linked to its nearest town.
Changes in the game (mod)
- The railway goes under the roads: the mod now builds the roads before the railway (the game's road builder gives up on any track in its way), then lowers the track into a short tunnel under each road it crosses, with approaches at the line's gradient.
- The report lists the industries the game left without a road nearby (industries on water are never linked by the game).
Fixes
- No road between towns after moving the area: road links changed by hand on a previous map froze the choice and left the new map without any link. Changing the area now starts again from the automatic choice.
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.1.0 — turn the area, large maps, reliable relief downloads
Update the app. The mod only changes its version number (Mod Hub or realmap-mod-1.1.0.zip, then restart the game).
New
- Turn the area: hold the orange handle in the middle of the area and drag; the top of the game map points to the mouse (Shift: 15° steps). The angle can also be typed, to the tenth of a degree, in Area and data › Rotation, and « North up » puts it back. Relief, water, towns, industries, roads and the preview all follow the turned area.
Fixes
- Large maps (about 300 × 300 km and more): the preview stopped with « Failed to execute 'postMessage' on 'Worker': Data cannot be cloned, out of memory ». The data now goes to the computation in pieces, and the elevation tiles are cut to the area first. Thanks for the report!
- Relief downloads: a dropped connection (« Failed to fetch ») no longer stops the data step; each tile is tried again (the step shows the countdown). A tile that arrived incomplete and then failed every time (« incorrect data check ») is detected, deleted and downloaded again. When IGN does not answer, Copernicus fills the relief instead of stopping.
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.0.3 — fix the crash on roads between towns
Update both the app and the mod (Mod Hub, or realmap-mod-1.0.3.zip), then restart the game.
Fixes
- Crash during generation (« cannot write to read only member 'laneConfigs' », then « lc.segment0 not found »): the step that narrows the roads between towns made the game crash, on maps from 1940 on. Fixed.
- Roads between towns follow the map's year: always 2 lanes, as dirt country roads before 1940 and as tarmac country roads from 1940 (the dirt ones no longer exist then). Same route, bridges and tunnels as the game's; town streets and industry access roads are left as they are.
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.0.2 — simple roads, varied town needs
Update both the app and the mod (Mod Hub, or realmap-mod-1.0.2.zip), then restart the game.
Changes
- Roads between towns: when the game links towns with wide 4-lane country roads, the mod now turns them into simple 2-lane dirt country roads right after (same route, bridges and tunnels); town streets are left as they are.
- Industries: like a new game, the map starts with the first-tier industries only (farms, livestock, forest, fishing, clay pit, quarry, oil, refinery, saw mill, brick works…); with the automatic count every one of their chains gets at least one base resource, placed where it exists in reality when possible, like the game guarantees; the total can be slightly higher than the game's count.
- Town needs: each town starts with first-tier goods only, like in a new game (meat, vegetables, fish when the map has fishing grounds; bricks, fuel, planks…), spread over the towns like the game does, with a light preference for goods produced on the map. Before, a map with a single complete industrial chain made every town ask for the same good.
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.0.1 — clearer when the game does not answer
Update both the app and the mod (Mod Hub, or realmap-mod-1.0.1.zip), then restart the game.
Fixes
- "The game does not answer" on game build 40423 and later: since that update the game only lets mods read and write a few of its folders, and the one RealMap used is no longer one of them, so the mod never saw the app's requests. The app and the mod now exchange their files in the
towns_industriesfolder (files namedrealmap_…, they also show in the Map Editor's Towns / Industries import list: leave them there). - The mod no longer compares its clock with the app's to accept a request. A request sent while the Map Editor is still loading is now sent again automatically.
- Explicit causes: when the game does not answer, the app now says why: the mod gives no sign of life (game closed, mod not enabled or out of date), the mod runs in another game folder (another Steam account), the game is not in the Map Editor, another map is still being generated, the mod and the app versions differ.
- Game log: the mod writes every step it takes (loaded, watching, request accepted or left aside and why, files it cannot save) in the game's
crash_dump/stdout.txt. If the game still does not answer, the app tells you where that file is: send it with your report. - The app picks first the game folder where the RealMap mod last ran.
- Game version: the Export tab shows a discreet note when the game is a build RealMap was not tested with (tested: 40423, 40425).
Installation
Same as 1.0.0: see the README. Installed apps update themselves from the Export tab.
RealMap 1.0.0 — first public release
RealMap turns a real place into a Transport Fever 3 map: relief, sea, rivers and lakes, biomes, towns at their real size, named industries, road links and a railway, built for you in the game's Map Editor.
English ·
Français ·
Deutsch ·
Italiano ·
Español ·
简体中文
Highlights
- Any place in the world: game map size and format, scale from 1:1 to 1:8, area picked on a map.
- Open data: relief from IGN RGE ALTI (France) or Copernicus GLO-30, sea floor from EMODnet or ETOPO, land cover from ESA WorldCover, water, places, industrial sites, roads and railways from OpenStreetMap. Everything is cached.
- Water made for the game: continuous, navigable rivers with gentle banks, deep enough rivers, marshes and coasts, beaches without trees.
- Towns at their real size, with commercial and industrial shares from the real business areas, and starting goods drawn far from the factories that make them.
- Industries from real sites and land cover, named after the real ones, following the game's density and economy.
- Road links between towns, chosen automatically (each town linked to 1 or 2 others) or by hand with a right click; the game lays the roads.
- Railway following the real main line, adjusted to the game's relief (along the banks rather than across the rivers), with curve, gradient, bridge and tunnel design.
- Automatic generation: open a new empty map in the Map Editor, click Generate the map, and the RealMap mod builds everything step by step while the app shows the progress.
- Six languages in the app and the mod.
Installation
- App: Windows
RealMap_1.0.0_x64-setup.exe(or the.msi, orRealMap_1.0.0_x64-portable.zipwithout installation), Linux.AppImageor.deb, macOS.dmg. Tested on Windows; the Linux and macOS builds have not been tried yet. The installers are not signed yet: SmartScreen › More info › Run anyway, Gatekeeper › right click › Open. - Mod: subscribe to RealMap in the game's Mod Hub (mod.io), or unzip
realmap-mod-1.0.0.zipinto the game'smodsfolder (Steam:<Steam>\userdata\<SteamID>\3493540\local\mods\).
See the README for the full guide and the known limitations.