ReferenceReference

Settings

Every Orbital Atlas setting in the settings drawer, with its default and what it does, for 1.0.0-beta.1.

Open the world map with M, then choose Settings or press T. The Mods list's Config button opens the same settings.

The drawer slides in from the right edge of the world map, so you see every change on the map at once. The icon tabs on its left edge pick a group, and the search field at the top finds settings in every group by name or description.

The settings drawer open on the right of the world map at its World map page: Grid and coordinates, World clock and Region names, with Undo and Done at the bottom
The settings drawer at its World map page. The icon tabs on the left open the other groups.

Changes apply and save immediately, except Terrain detail shading, which needs a restart, and Block texture storage, which applies the next time a map opens. Undo steps back through the changes made while the drawer is open. Done or Esc closes the drawer and ends that undo history. Actions that delete something ask first. The defaults below are those of a fresh installation of 1.0.0-beta.1; choices you saved in an earlier build are kept.

Server fair-play rules can turn off the minimap, cave views, radar classes, Seek, Show all underground, teleport and Create train overlays. A local setting cannot override a server rule. Tools that use a world's data appear after you join a world. Integration rows appear only when their mod is installed.

Minimap#

SettingDefaultWhat it does
Show minimapOnShows the corner minimap. The Toggle 3D minimap key (no key by default) changes the same setting.
PositionTop rightChooses Top left, Top right, Bottom left or Bottom right.
Size512 pxSets the map's physical pixel size, from 192 to 1024 px in steps of 16. Its displayed size also fits the game window.
ZoomAutoAuto learns zoom levels for activities such as walking, riding, flying and caves. Manual uses one saved level.
Manual zoom160 blocksSets the span used in Manual mode, from 32 to 512 blocks in steps of 16. A smaller span shows a closer view.
OrientationFacing upNorth up keeps north at the top; Facing up turns with you; Fixed uses Fixed angle.
Fixed angle45°Rotation used with Fixed orientation, adjustable from −180° to 180° in 5° steps.
Tilt55°Sets the downward viewing angle from 25° to 85°. Higher values look more directly down.
Info plaqueCoordsOff, Coords, + Biome or + Time. The last option shows coordinates, biome and time.
Compass headingOnShows your heading in degrees and compass points.
Heading showsBothChooses Both, Degrees or Compass. Requires Compass heading.
While flyingBalancedWhen travel outruns loaded terrain, Far keeps the requested span, Loaded frames loaded and drawn ground, and Balanced lies between them. Saved terrain keeps the requested span.
ShadowOnAdds a soft shadow beneath the minimap.
Minimap refreshNormalRefreshes animated water and lava when the view is otherwise unchanged: Still every 1000 ms, Normal every 250 ms or Live every 50 ms.
Minimap edgeStrataStyles the round map's cut side: Strata, Ink, Mirror or Off.

Hold the map key to use Quick Tune: scroll to change zoom, or Shift + scroll to change tilt. Release the key to keep the changes; Esc cancels them. See Minimap.

World map#

SettingDefaultWhat it does
Grid and coordinatesOnShows grid lines, coordinates and compass letters.
World clockOnShows the in-game day and time in the top bar.
Region namesBiomes + named placesOff hides labels; Biomes labels biome areas; Biomes + named places adds generated names for notable places. Right-click a region label to name it yourself.
Label styleClassicHow region names look: Classic, Chart (biomes lettered onto the land, named places on plaques), Plaques or Ink.
Illustrated chartOnDraws the illustrated chart over unexplored ground.
Animated frontierOnAnimates newly mapped land as it appears.
Chunk and region bordersOffDraws chunk and 512-block region lines on both maps.
Border linesBothChooses Both, Chunks or Regions when borders are enabled.
Spawn lightingOffShows nearby locations where mobs could spawn.
Day, night and weatherOnLights terrain by the world's time and weather while keeping nights readable.
Terrain detail shadingOnAdds sun and contact shading. Restart Minecraft after changing it. Older saved areas update as you revisit them.
Height shadowsOnAdds shadows on known ground beneath bridges, overhangs and other raised terrain, on both maps.
Update speedNormalLow, Normal, High or Max. Higher values allow more map work per frame and can fill the map faster at an FPS cost.
Edit replayNormalControls how quickly distant block changes reach the map: Slow, Normal or Fast. Slower can help near large farms.
Map image exportOnLets you save the map as a PNG.
Export map imageActionSaves the current view as a PNG of 512, 1024 or 2048 px in screenshots/atlas/. Needs Map image export and a loaded world.

Radar#

Radar settings affect players and mobs on the maps. The server controls which radar categories are allowed.

SettingDefaultWhat it does
PlayersOnShows other players available to the client.
Hostile mobsOnShows hostile mobs, including bosses.
Passive mobsOnShows peaceful mobs and animals.
Your petsOnShows tamed animals, including pets belonging to other players.
Player namesOnAdds name slips beside player markers.
StyleTagsChooses Tags, Medallions or Dots for radar markers.
SizeMediumChooses Small, Medium or Large markers.
Minimap showsAllAll includes all enabled categories. Threats removes passive mobs from the minimap. Minimal keeps only players, bosses and pets, plus hostile mobs within 16 blocks, on both maps.
Faces within32 blocksChooses 8, 16 or 32 blocks for nearby mob faces on the minimap. Crowded faces become dots so the map stays legible.
HeadsFloatingChooses heads Floating above the terrain or Printed on it.
Stack crowdsOnGroups crowded world-map markers into a single mark with a count. The minimap uses dots and nearby faces.
Boss glowOnAdds a pulse and glow to boss markers.
Height range±32Shows mobs within ±16, ±32, ±64 or ±128 blocks of your height.

Trails & routes#

SettingDefaultWhat it does
Explorer trail+ RoadsOff stops the trail; Recent draws the recent tail; + Roads adds paths you use often; All draws the trail throughout the selected window.
InkIron-gallChooses Iron-gall, Sepia, Vermilion or Indigo for your route and roads.
StyleInkedChooses the Inked trail or older Classic lines.
Recent tail10Keeps the solid recent tail for 2, 5, 10 or 30 minutes.
On the world mapSessionChooses a visible trail window of 10 min, Hour, Session or All. This controls drawing, separately from retention.
RoadsFadeOff stops road drawing and recording; Fade fades roads unused for 30 days; Keep retains their appearance.
Keep history7 daysKeeps the trip log for 1 day, 7 days or 30 days. Expired history is removed from disk.
Privacy zonesNoneStops new trail recording within 32, 64 or 128 blocks of waypoints marked private. None disables the zones. Select the private waypoints from their map menu.
Pause trailUnboundAssigns the key that pauses or resumes recording.
Clear my trailActionClears your trail in the current world after confirmation. Requires a loaded world and an enabled trail.

Trail recording, visible history, roads and explicit route sharing have separate controls. See Waypoints, journeys and teams.

Waypoints#

SettingDefaultWhat it does
In-world markersOnShows waypoint badges, distances, tracking pointers and beams in the game view.
In-world icon opacity55%How solid waypoint, ping and team-mark icons and beams are near your crosshair, from 20% to 100% in 5% steps. Away from the crosshair they stay solid, and names stay readable.
Track nearest waypoint;Assigns the tracking key. It tracks the waypoint near your crosshair, or the nearest one; pressing it again stops tracking. In Controls it is Track waypoint (looked-at or nearest).
Death points3Keeps Off, 1, 3 or 10 death markers. Off records none.
Waypoint setsOnEnables named waypoint groups that can be shown or hidden.
Manage setsActionCreates, renames, shows or hides sets. Requires Waypoint sets and a loaded world.
Measuring toolOnEnables route distances and estimated travel times.
Measure a routeActionStarts measuring: click map points; right-click removes the last point. Requires the Measuring tool and a loaded world.
DistanceFlatChooses Along terrain or Flat for measurement. This choice lasts for the session. Requires the Measuring tool and a loaded world.
Chat coordinate linksOnAdds coordinate actions such as [add to Atlas] and sharing to recognised coordinates in chat.
Teleport to waypointOnOffers waypoint teleport where the server and your permissions allow it; intended for operators.
Waypoint importsOnEnables imports from Xaero's and JourneyMap, including /atlas import.
Import waypointsActionOpens the importer with an Undo option. Requires Waypoint imports and a loaded world.

Team#

SettingDefaultWhat it does
Show teammatesOnAdds teammate tracking, including edge arrows when teammates are far away.
Player tags size50%Scales player heads and names in the game view from 25% to 150%, in 5% steps. Map icons and waypoints keep their size.
Ping and mark size100%Scales compact team pings and marks, including text, from 50% to 150%, in 5% steps. They also shrink with distance.
Teammate tails2 minChooses Off, 30 s, 2 min or 10 min for lines behind teammates.
Pings and marksOnEnables pings, marks and pins from keys, commands and the map menu.
PingUnboundAssigns a key to ping the spot under your crosshair.
Team markUnboundAssigns a key to mark the spot under your crosshair for your team.
Ping soundOnPlays a short tone for pings; your own plays quieter. Uses Minecraft's Players volume.
Pings by team chatOffAllows team-chat delivery when the server add-on is unavailable.
Share my roadsOffContributes roads you wear to your team's roads.
Share routes in chatOnEnables sending a saved route as chat lines when you choose to share it.
Open shared routesOnOffers [Add route] on routes shared with you.
Use the server add-onOnUses the add-on for team pings and routes when the server provides it.

Caves & rooms#

SettingDefaultWhat it does
Interior viewAutomaticAutomatic cuts into the cave, canopy or room you are in; Surface keeps the surface; Manual uses the floor set below. In the Nether, Automatic shows the full height in the open and the cut layer in tunnels and buildings. See World map and views.
Toggle interior viewOThe interior view key, in play and on the world map. Tap it to step Automatic, Surface and Floor (in the Nether: Auto, Full height, Layer and Floor), or to go back to Auto after choosing a level. Hold it and scroll to change the view level.
Cut away the roofOnCuts the roof away to show the room you are in.
Zoom to fit the roomOnFits the minimap to the room while Zoom is Auto.
Center on the roomOnFrames the room rather than centering directly on you.
Smooth room motionOnEases zoom changes when entering or leaving a room.
Manual floorY 64Chooses the floor used by Manual interior view. The slider follows the dimension's build height.
Level height4 blocksShows 2 to 32 blocks above the manual floor.
Show all undergroundOffOff: ores under the surface are drawn as the rock around them, and the cave view shows only the caves you have explored. On: every underground block and cave shows as it is, where server rules allow it.
Interior wallsShort wall stubsChooses Short wall stubs or Full room height in Interior view.
Cave viewFloorsFloors shades the floors below you darker with depth; Rock shows caves cut into warm grey rock; Chart uses hatched sepia rock.
Cave view wallsOnCloses exposed sides of cave and Interior views with plain rock walls.

See World map and views for recorded floors, storeys, cave styles and Nether layers.

Other mods#

Integration rows appear only when the corresponding mod is installed. The claim style and border width appear with either supported claim mod. See Integrations and claims.

SettingDefaultWhat it does
WaystonesOnShows the waystones you have activated as waypoints, for the world you are in.
Create trains and stationsOnShows Create train lines, stations and trains on the world map.
FTB Chunks claimsOnDraws FTB Chunks claimed land with team colours and names.
Open Parties claimsOnDraws claims from Open Parties and Claims.
Claim styleBorderChooses Border, Frontier, Banner or Hatched, with a border and name for each claimed area.
Claim border width100%Scales border lines on both maps from 50% to 200%, in 10% steps. Fills and names keep their appearance.
Maps from other modsOnAllows markers and layers supplied by add-ons.
Add-on layer nameSet by the add-onEach registered map layer gets its own visibility switch, named by its add-on.

Look & sound#

SettingDefaultWhat it does
StyleFullFull adds the compass rose, minimap collar and brass ornament. Minimal removes those decorations.
UI soundsOnEnables themed page turns and waypoint chimes with Full style.

Storage#

Setting or actionDefaultWhat it does
Map storage limit8 GBChooses 2 GB, 4 GB, 8 GB, 16 GB, 32 GB or No limit for the saved maps of all your worlds. When they pass it, Atlas warns you and lists the oldest; it never deletes another world's map without asking. It also keeps 2 GB, or 5% of a small disk, free.
Block texture storage2 GBDisk space for close-zoom block textures, per map: 256 MB, 512 MB, 1 GB, 2 GB or 4 GB. When it is full, the places you saw longest ago show plain colours at close zoom until you see them again. Applies the next time a map opens.
Remove oldest mapsActionAppears during a storage warning. Lists exactly which maps would be removed and asks for confirmation.
Raise limitActionAppears during a storage warning. Raises the limit to the next step that holds your maps.
Dismiss for this sessionActionAppears during a storage warning. Stops further storage pop-ups until Minecraft restarts.
The Storage page of the settings drawer scrolled to Block texture storage, with 256 MB, 512 MB, 1 GB, 2 GB and 4 GB and 2 GB selected; above it the Map storage limit choices
The Storage page with Block texture storage at its default of 2 GB.

Advanced#

Setting or actionDefaultWhat it does
PerformanceMediumApplies a group of six settings. Custom means your settings do not match a preset. See the table below.
All Atlas keysActionOpens Controls at the Orbital Atlas key category.
Clear other worlds’ mapsActionClears other worlds' saved maps after confirmation, while keeping the world you are in. Requires a loaded world.
Send an Atlas reportActionOpens the report screen. You see every file first, and nothing is sent until you confirm. See Privacy and reports.
Reset all Atlas settingsActionRestores the settings and key bindings in this drawer after confirmation. Distance keeps its session choice. Undo can restore the changes while the drawer remains open.
The Advanced page of the settings drawer: Performance with Low, Medium (selected), High and Custom, All Atlas keys with an Open button, and Clear other worlds' maps
The Advanced page. Performance is at its default, Medium.
PresetUpdate speedEdit replayMinimap refreshHeight shadowsAnimated frontierFaces within
LowLowSlowStillOffOff8
MediumNormalNormalNormalOnOn32 blocks
HighHighFastLiveOnOn32 blocks

Saved preferences#

Atlas keeps map and decoration choices in config/orbitalatlas.properties, feature switches and options in config/orbitalatlas-features.properties, and the minimap zoom in config/orbitalatlas-zoom.properties. Minecraft saves key bindings in options.txt. A file is written only once you change something, and only the settings you changed are written. Use the settings drawer rather than editing the files.

Search settings, controls and guides. Use Tab to move through results.