Back to mods
Ember's Atlas project artwork

CurseForge · Minecraft mod

Ember's Atlas

A fast, configurable, and powerful map mod built for modpacks and servers

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Ember's Atlas release should I use?

Updated today
Latest stable file Ember's Atlas 1.0.0 (Forge 1.20.1)
Game version 1.20.1
Loader Forge

Ember's Atlas 1.0.0 (Forge 1.20.1) targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Ember's Atlas required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Ember's Atlas 1.0.0 (Forge 1.20.1) need?

Ember's Atlas 1.0.0 (Forge 1.20.1). Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

1 listed on this file 2 pulled in by those mods
KubeJS Optional for Ember's Atlas 1.0.0 (Forge 1.20.1)
optional
Matching file found Matched file: KubeJS Forge 2001.6.5-build.26
Rhino Needed by KubeJS
pulled in
Matching file found Matched file: Rhino Forge 2001.2.3-build.10
Architectury API Needed by KubeJS
pulled in
Matching file found Matched file: [Forge 1.20(.1)] v9.2.14

2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Ember's Atlas without breaking your instance.

Built for Ember's Atlas 1.0.0 (Forge 1.20.1). Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Ember's Atlas 1.0.0 (Forge 1.20.1). It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Ember's Atlas 1.0.0 (Forge 1.20.1). It opens that exact file at the source.

About this project

What does Ember's Atlas add?

Ember's Atlas

Ember's Atlas adds a minimap, a world map, markers, waypoints, pings and a radar. It only needs to be on the client. If the server also has it, the server can turn each map feature on or off per player, based on things like the dimension, a held item or a finished quest.

The world map, half in the Modern style and half in the Antique style

Getting started lists the default keys and shows how to place a marker.

The maps

The minimap is a square or a circle, north locked or rotating, and you can drag it anywhere on the screen. Above or below it, it can show coordinates, biome, time, facing, speed, light level, FPS, ping and more. It marks your position with an arrow, your player head or a small cross.

Looking over a coast with the minimap in the corner and a waypoint in the distance

Press M to open the world map. Drag it or use WASD to move around, and scroll to zoom from 8 pixels per block out to 1 pixel per 128 blocks. You can also jump to coordinates and switch dimensions. From the right click menu you can add a marker, send a ping, copy coordinates and, if you are an operator, teleport.

The world map over forest, lakes, snowy peaks and ocean

Hills are shaded, and cliffs and trees cast short shadows. Water is see-through, so you can spot shipwrecks and ocean monuments from the map. Underground, both maps switch to the cave layer you are in. At night the surface map gets darker, except where torches or lava light it up.

The minimap in cave mode next to a mineshaft

Map styles

There are five map styles, with Modern as the default. Biome colors the land by biome and Topographic colors it by height. Parchment uses the colors of a vanilla map item, and Antique draws trees, hills and waves as ink symbols on paper.

The minimap in the Modern, Parchment and Antique styles, square and round

The world map in the Antique style, shown as an open book

Each style is a single JSON file, so a modpack or resource pack can add its own. See Themes.

Markers and waypoints

A marker has one of 82 icons, a color, a group and a note. If you set a marker as a waypoint, it also shows in the world as a beam with an icon you can see through blocks. The mod places markers on its own when you die, see a structure or activate a waystone. A temporary marker removes itself when you reach it.

The marker list groups your markers and sorts them by distance, name or newest, and you can hide a whole group at once. In singleplayer it can also import waypoints from Xaero's Minimap, JourneyMap and FTB Chunks.

The marker list with three groups

The marker editor with the icon grid and the color picker

Pings and radar

Middle click to ping whatever you are looking at. Pinging a hostile mob gives a red ping that follows it around, and pinging a chest or a dropped item gives a yellow one. Hold the button to open a wheel with more ping types, such as Danger, Going here, Defend and Need help. If the server has Ember's Teams and Claims, your party sees your pings.

The ping wheel

The radar shows players, mobs and dropped items on both maps. Mobs show up as their face, cut from the mob's own texture, so you can tell sheep colors and villager professions apart. Dropped items show in their rarity color, or as the item icon once you zoom in.

Mob faces on the minimap near a village

Performance

I measured Ember's Atlas against Xaero's Minimap with Xaero's World Map, and against JourneyMap. I had all three installed in the same client with default settings, so they ran in the same world at the same time. The test flies 2,700 blocks in a straight line through unexplored land and then stands still for one minute.

Ember's Atlas Xaero's Minimap + World Map JourneyMap
CPU time while flying through new land 18 to 21 ms per second 29 to 36 ms per second 217 to 257 ms per second
CPU time while standing still 1 to 2 ms per second 6 to 8 ms per second 8 to 11 ms per second
Memory allocated while flying 4 to 6 MB per second 20 to 23 MB per second 142 to 146 MB per second
Memory allocated while standing still 3 MB per second 29 MB per second 9 to 10 MB per second
Map data on disk after the flight 0.6 MB 1.1 MB 24.6 MB

The numbers are from two runs on NeoForge 1.21.1 at render distance 12 and 120 FPS, with Xaero's Minimap 26.6.0, Xaero's World Map 1.47.0 and JourneyMap 6.0.9. I measured CPU time with Java Flight Recorder, the profiler that is built into Java. It records which code is running many times a second, so it only covers Java code. Time spent in the graphics driver is not included for any of the three mods. Your results will depend on your hardware and settings.

On the same machine, the minimap takes about 0.05 ms per frame while standing still and 0.1 ms while flying. The world map takes about 0.1 ms per frame while it is open. Run /atlas profile to see these numbers in your own game.

For servers and packs

With the mod on the server, a rules file sets which features each player can use: minimap, world map, radar, coordinates, waypoints, teleport, cave maps and how far the map shows. A rule can check the dimension, the structure the player is in, held or carried items, effects, depth, combat and time of day. With Ember's Progression, Ember's Questing and Ember's Teams and Claims installed, a rule can also check stages, finished quests and claims.

  • Players can unlock map features in tiers that the pack defines.
  • Explored land can be shared with the party or the whole server.
  • /atlas reveal maps an area for a player and /atlas marker give gives a player a marker.
  • A Java API and KubeJS can do the same from other mods and scripts.
  • A pack can set default client settings and lock individual settings.
  • A server without the mod can still restrict the client with Xaero's fair play chat codes.

See Server rules and API.

Works with

Mod What you get
Ember's Teams and Claims Claims are drawn on both maps in party colors. Right click and drag on the world map to claim, unclaim, force load or edit chunks. Pings and explored land are shared with your party.
Voxy, Distant Horizons The map also uses the terrain the LOD mod has stored, including land far away that you have never walked to.
Waystones Each waystone you have activated gets a marker and a waypoint.
Create Aeronautics with Sable (NeoForge) Contraptions are drawn on both maps. Markers and pings placed on a contraption move with it. A contraption you assemble gets its own marker.
Ember's Questing, Ember's Progression Server rules can check finished quests and stages.
KubeJS Server scripts can give markers, reveal land and unlock tiers.

All of these are optional. See Integrations.

Claims on the world map with a dragged selection and its menu

Settings

Every option is in the settings screen, which has a search box. Each option has a tooltip and a reset button, and changes save right away.

The settings screen

License

Ember's Atlas is released under Ember's Modding License (EML) v2.0. You can play it, run it on servers and put it in modpacks that download it from CurseForge or Modrinth. The icons are from Pixelarticons by Gerrit Halfmann under the MIT license.

Docs and support

The docs are at tysontheember.dev/embers-atlas.

Found a bug or have an idea? Open an issue, and upload any logs to logs.tysontheember.dev.

Project description from CurseForge.

Pick your setup

Ember's Atlas by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

12 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Ember's Atlas versions and loaders

10 of 10 releases match

Looking for an older file? The official CurseForge project page is in Resources.