Skip to content

About

Explore real cities, mountains and streets in Minecraft. RealWorldMC brings Google 3D maps and Street View to Java Edition with Fabric. Recommended for 1.21.1; experimental 26.2 available. Requires your own map API keys.

Topics

Resources

Code of conduct

Stars

134 stars

Watchers

2 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RealWorldMC

Explore real cities, fly over mountains and step into Google Maps Street View inside Minecraft Java. RealWorldMC brings Google Earth-style scenery into the game, with Minecraft blocks and mobs alongside street-level photos.

Download · Website · Setup guide · API keys and costs

RealWorldMC gameplay: New York, the Grand Canyon, Paris and the Golden Gate Bridge

Watch the flight preview

What you can do

  • Fly over real-world 3D scenery and travel to places by name or coordinates.
  • Use automatic glide and hover without wearing an elytra.
  • Explore Street View, follow its arrows, place blocks and spawn mobs.
  • Start each new world at one of 100 locations, including the Palace of Parliament in Bucharest.
  • Try experimental space flight, including Earth orbit and Moon or Mars flyovers. Moon and Mars do not have walkable surfaces.

Recommended: Minecraft Java 1.21.1 with Fabric and Java 21. Other Minecraft builds are experimental and have fewer features. See the setup guide for compatibility.

Get started

  1. Download the 1.21.1 .mrpack from Releases and import it into Modrinth App or Prism Launcher. Already have a Fabric profile? Install the matching release JAR and Fabric API instead.
  2. Launch Minecraft. The RealWorldMC setup screen opens on first launch.
  3. Choose Google or Cesium, enter your own credentials and test the connection. Add a Google Map Tiles API key for in-game Street View. Follow the account setup steps.
  4. Select Save & finish. The mod starts its local map services automatically.
  5. Create a Creative world with commands enabled and choose Real World as the world type. Wait for the scenery to load, then explore.

Windows x64 releases include the service runtime. macOS and Linux need Node.js 22+; full gameplay testing on those platforms is still pending. Bedrock, mobile, Forge and NeoForge are not supported.

Useful controls

Command Action
/earth help Show commands
/earth setup Change or test your keys
/earth fly Toggle automatic glide and hover
/earth goto 44.427454, 26.087287 Visit the Palace of Parliament
/earth streetview Enter the nearest Street View photo
/earth back Return from Street View

F5 changes the camera. In Street View, look toward a yellow arrow and tap W to travel. V toggles a small walking area. See all controls.

Before you play

  • Internet access and your own provider credentials are required. Map usage can cost money. Read limits and billing before adding keys.
  • Coverage varies. Blocks approximate the scenery, and Street View photos do not provide building interiors or accurate wall depth.
  • Shader and add-on compatibility varies. Check known limitations and troubleshooting.
  • When updating, back up your worlds, close Minecraft and replace the old JAR. Keep only one copy of RealWorldMC installed.

Documentation

All guides · Recording guide · Architecture · Build instructions · Changelog

Credits and licence

Earth data comes from Google and OpenStreetMap, with Cesium available for 3D map access. Moon and Mars have separate imagery credits. Keep provider attribution visible when sharing captures.

Code: Apache License 2.0. Map and imagery assets have their own terms. Not affiliated with Mojang, Microsoft, Google or Cesium.

NOTICE · Licensing notes · Code of conduct

About

Explore real cities, mountains and streets in Minecraft. RealWorldMC brings Google 3D maps and Street View to Java Edition with Fabric. Recommended for 1.21.1; experimental 26.2 available. Requires your own map API keys.

Topics

Resources

Code of conduct

Stars

134 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages