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.

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.

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.

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.

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.


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.


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 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.

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 revealmaps an area for a player and/atlas marker givegives 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.

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.

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.