McOSM

McOSM

A Mod that imports OpenStreetMap data into Minecraft, compatible with Build The Earth.

by
1.2K Downloads
forgeutilityworldgen
Rent Server with this Mod

Screenshots

Sparse city generated by McOSM
Dense city generated by McOSM

About this Mod

McOSM

A Mod that imports OpenStreetMap data into Minecraft, fully compatible with CubicChunks, Terra121 and the Build The Earth map projection.

Features

  • Making building shells.
    • Making each house the right height based on its OSM data height.
    • Adding windows on buildings based on how many floors they have.
    • Set building material based on OSM material data.
    • Set building material based on OSM building color data.
  • Making roads.
    • Creating different road types based on OSM data.
    • Including walkways, stairs and corridors inside houses. (TODO)
    • Automatically making tunnels. (TODO)
    • Adding pedestrian crossings to roads.. (TODO)
  • Making railroads. (TODO)
    • Building train platforms. (TODO)
  • Making vegetation
    • Making trees, tree rows and hedges based on OSM data.
  • Gui to auto download API data and build in one command.
  • Load data from a file or from the API.
  • Building in Cubic or Non-Cubic chunk worlds.

Commands

There are several commands to load map data into minecraft, here are all of them:

  • /osm or /osm [lat1] [lon1] [lat2] [lon2] to open the download and build gui
  • /osmshell to start building the building right under you without a gui
  • /osmfile [path] to open data from a file and open the build gui
  • /osmapi [lat1] [lon1] [lat2] [lon2] to copy a link of the api url to your clipboard to manually open it
  • /osm stop to stop all current tasks
  • /osmcoords <to/from> <x/lat> <z/lon> to convert GPS coordinates to/from ingame coordinates

Usage

  • Go on a map (like Google maps), then find the latitude and longitude of the northwest and southeast corners of the area you want to download (How?), and save those coordinates for later.

  • Then run the /osm command which will open the builder gui

  • Select the features you want on the left (The [Global/Local] toggle changes the building placement from on the terra121 map location to locally around the player)

  • Then paste the latitude/longitude you copied from earler into coordinate boxes. the map preview should now vaguely line up (It doesn't enterly line up! As long as it isn't on the other side of the earth it should be fine)

  • Then click the Download Button and wait for it to download, If it wasn't successful it should say an error in the output box

  • If it successfully downloaded, you can click on the Start button to start building (you don't have to be in the chunks its building in for it to build)

Important:
When using the mod in a Terra121 world, turn the map direction to upright and BTE projecttion!
Also turn off roads and building outlines for the best result!

Available Versions

McOSM 0.4.1release
MC 1.12.2forge
November 13, 2022

How to Install McOSM on Your Server

1

Order Server

Order a Minecraft Java server with at least 4 GB RAM (6 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).

3

Install Mod

Open the mod browser in the dashboard and search for "McOSM". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

forge

Minecraft Versions

1.12.2

Server-side

Unsupported

Recommended RAM

6 GB(min. 4 GB)

Frequently Asked Questions

McOSM server crashes on startup – what to do?

Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 4 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.

Is McOSM compatible with forge?

McOSM officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with McOSM – how to optimize performance?

Recommended RAM: 6 GB (per 5 players). Use /spark profiler to check if McOSM consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install McOSM with just one click on your server.

Recommended RAM
6 GBab €12/mo
Min. 4 GB | +1 GB pro 5 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

1.12.2