![]()
![]()
Getting started
Install Orbital Atlas on Minecraft 1.21.1 with NeoForge, find your instance folder, set the map key and back up before updating.
Orbital Atlas adds a 3D minimap and a full-screen world map to Minecraft. Install it in your game; a server does not need Atlas for the map to work. Installing it on a server as well is optional and adds team play and fair-play rules (see Server setup).
Requirements#
| Component | Requirement |
|---|---|
| Minecraft | 1.21.1 |
| Loader | NeoForge 21.1.248 or newer in the 21.1.x series |
| Java | 21 |
| Memory | Give the game at least 4 GB, or more if your modpack asks for it |
| Other mods | None required |
| Where to install | Client. A server install is optional and adds team play. |
Fabric, Quilt, Forge and other Minecraft versions are not supported.
Download and install#
Orbital Atlas is published on CurseForge (opens in a new tab). While it is in beta, files are on CurseForge's Beta release channel; make sure your launcher shows beta files.
With the CurseForge app: open your Minecraft 1.21.1 NeoForge profile, add content, search for Orbital Atlas and install it. You can also press Install on the project page (opens in a new tab).
With any other launcher:
- Download
orbital-atlas-neoforge-1.21.1-1.0.0-beta.1.jarfrom the CurseForge Files tab. - Close the game.
- Put the jar in your instance's
modsfolder. Keep only one Orbital Atlas jar there. - Start the game. Under Mods, Orbital Atlas should show version 1.0.0-beta.1.
Find your instance folder#
Your instance folder holds mods/, config/, logs/ and usually saves/. Atlas keeps its map data in orbitalatlas/ and its settings in config/orbitalatlas* in the same folder. Use the launcher's folder button for the instance you actually play.
| Launcher | Open the folder |
|---|---|
| CurseForge app | Right-click the profile, then Open Folder |
| Prism Launcher | Select the instance, then Folder |
| Official launcher, Windows | %APPDATA%\.minecraft |
| Official launcher, macOS | ~/Library/Application Support/minecraft |
| Official launcher, Linux | ~/.minecraft |
Give the map its own key#
The world map key is M. Xaero's World Map, FTB Chunks and Simple Voice Chat may also use M, and JourneyMap may use = and -, which Atlas uses to zoom the minimap.
In Options > Controls > Key Binds, give the conflicting actions different keys. Atlas's keys are in the Orbital Atlas category. About ten seconds after you join a world, Atlas says in one chat line when its world map key is also bound to another action. It never changes your keys itself. See Controls and commands for every default key.
First launch#
The minimap appears in the top-right corner when you enter a world. About ten seconds after your first join, Atlas tells you in chat which key opens the world map; on the map, T or the Settings button opens the settings drawer and H shows the controls.
- Tap M to open the world map. Press M or Esc to close it.
- Hold M during play and scroll to zoom the minimap, or Shift and scroll to tilt it. This is Quick Tune.
- Hold O and scroll to change how much the view cuts away in caves and buildings. Tap O to go back to Auto. See the View button.
Terrain fills in as your game loads and explores it. Parchment outside explored land is expected: walk a little and the map appears. To bring in waypoints from Xaero's Minimap or JourneyMap, use Import waypoints in the settings drawer or type /atlas import; you see a preview first, and Undo takes an import back.
Radar and cave views are on by default. Follow your server's rules; a server can switch these features off (see fair play).
Compatibility#
Orbital Atlas is tested in depth on Windows with NVIDIA graphics and on Apple silicon Macs. AMD, Intel and Linux are supported on a best-effort basis, and shader packs are lightly tested. Macs use a lighter graphics path automatically; you do not need to change anything.
Sodium has been tested alongside Atlas. Other map mods can stay installed: you may want to hide one minimap and give the maps different keys. Atlas draws with OpenGL, so a Vulkan renderer such as VulkanMod may not work with it. Integrations with other mods appear only when those mods are installed; see Integrations and claims.
Update and back up#
- Close the game.
- Copy the whole
orbitalatlas/folder and everyconfig/orbitalatlas*file from your instance folder to a backup location. - Replace the old Atlas jar in
mods/with the new one, or update it in your launcher. Keep one Atlas jar. - Start the game and check the version under Mods.
Saved data from earlier builds, including the closed beta, keeps working. Do not run the same instance twice at once, and do not start an older Atlas jar on data a newer one has used. To go back to an older version, restore the complete backup you made before updating, together with its settings files. Never merge map files from different backups.
Remove Atlas#
Close the game and remove the jar from mods/. Your worlds still open: Atlas adds no blocks or items. Keep orbitalatlas/ and config/orbitalatlas* if you may install it again; delete them only when you want to discard Atlas's local data. Map images you exported stay in screenshots/atlas/.
If you shared team routes or region names on a server, remove them first or ask the server operator: removing Atlas from your game does not remove what is already stored on a server.