Osmc
 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Author: | Denis Rakhmatullin (mrHalfer) | |||||||||||||||||||
| License: | MIT License (free of charge) | |||||||||||||||||||
| Platforms: | Windows and Linux | |||||||||||||||||||
| Status: | Active | |||||||||||||||||||
| Website: | https://osmc.pro/ | |||||||||||||||||||
| Source code: | https://github.com/mrHalfer/OSM2MC | |||||||||||||||||||
| Programming language: | C++ | |||||||||||||||||||
|
Desktop application that turns OpenStreetMap data into a playable Minecraft Java Edition world. | ||||||||||||||||||||
| ||||||||||||||||||||
OSMC is a desktop application that generates Minecraft Java Edition worlds from OpenStreetMap data. A selected area of the real map is rebuilt block by block, and the result is a regular Minecraft save that can be opened in the game without any additional tools.
The program runs on Windows, requires no installation or extra dependencies, and is distributed free of charge under the MIT license. The interface is available in English, Russian and Chinese.
Features
- Buildings with floors, windows, doors, furnished interiors and roofs. Heights, floor counts, materials and building types are taken from OpenStreetMap tags; where they are missing, the program estimates them. Schools, kindergartens, research institutes and churches get their own look and unique interiors.
- Roads with markings and crosswalks, bridges over water, railways with electrified tracks and trams, street lamps and signs with street names and house numbers.
- Nature: water, forests, parks, yards, fields and terrain relief. The climate zone is derived from the coordinates automatically (or set by hand); 12 zones, from tundra and taiga to deserts, savannas and tropical jungles, define the tree species, the ground surface and the biomes.
- Underground and hidden places: caves, metro tunnels with rails and lanterns, underground station halls with staircase shafts to the surface, church and laboratory dungeons, a stronghold and an Ancient City with secret passages, a Pale Garden with a mansion, bandit outposts and camps, shipwrecks, ruined portals and floating islands above the parks.
- Villagers, mannequins, furniture and chests with ordinary game loot.
- Seamless world: outside the exported area the terrain continues as a normal seed-based world (or as a superflat one), so the city does not end with a visible wall.
Workflow
- Choose an area on the built-in online OpenStreetMap map the search box accepts place names in any language or load a local
.osmor.pbfextract. - Draw a boundary polygon of up to 25 km; its size is shown on the map.
- Optionally mark the player spawn and the entrances to the stronghold, the Ancient City and the Pale Garden.
- Download the OpenStreetMap data for the selected area.
- Set the world options (Minecraft version, caves, a datapack for the
/locatecommand, climate, seed, the world outside the area) and press Export.
The export runs with a progress log and can be cancelled. Only objects inside the boundary are exported; a building or a lake on the edge is kept whole.
Export
The result is a .zip archive with a ready Minecraft world; it can be placed into the .minecraft/saves folder without unpacking. Alternatively, the world can be saved unpacked directly into the saves folder of a Minecraft launcher or into a Modrinth or CurseForge instance, so the game sees it immediately.
Worlds for Minecraft Java Edition 26.x and 1.21.x are supported. The archive also contains a datapack that lets the /locate command and the Eye of Ender find the generated structures, and an ATTRIBUTION.txt file with the OpenStreetMap attribution.
Command line
OSMC can run without a graphical interface, which is convenient for scripts and batch processing:
osmc.exe source.osm -o world.zip --nogui --log run.log
Main options: --format 26|1.21, --flat, --seed, --caves 0|1, --climate, --clip (export only a custom polygon), --spawn-lonlat, --download-osm (download an area and exit), --lang, --theme and --dry-run (only load and classify the data).
Data sources
- OpenStreetMap data, downloaded online for the selected area or loaded from a local
.osmor.pbffile. - Structure templates cut out of a real Minecraft world and shipped with the program (used for caves and some underground structures).
The built-in online map uses OpenStreetMap tiles; the program caches them and follows the OpenStreetMap tile usage policy.
License and data
OSMC is free software under the MIT license. The source code, issues and releases are published on GitHub.
Map data © OpenStreetMap contributors, available under the Open Database License (ODbL). A world made from OpenStreetMap data is a derived database: when it is published (for example, on a server or as a download), the attribution "Map data © OpenStreetMap contributors (ODbL)" must be kept and the ODbL terms must be followed. The exported archive contains this notice in ATTRIBUTION.txt.
Minecraft is a trademark of Mojang AB. OSMC is not affiliated with Mojang or Microsoft.
Documentation
- Project website: https://osmc.pro/
- Source code and releases: https://github.com/mrHalfer/OSM2MC
- User documentation: https://github.com/mrHalfer/OSM2MC/blob/main/README.md
- Changelog: https://github.com/mrHalfer/OSM2MC/blob/main/CHANGELOG.md