Antique Atlas 4
A hand-drawn clientside world map, with map sharing, structure discovery, and less! A map frontend for Surveyor based on hunternif's Antique Atlas.
Автор: sleepingdragoninn3 млн2,1 тыс.обновлён 5 янв. 2026 г.
ПриключенияОбщениеУтилиты
Описание
A hand-drawn clientside world map, with map sharing, structure discovery, and more!
A rewrite of Antique Atlas by Hunternif, as continued by Kenkron, asie, and tyra314.
Requires Surveyor Map Framework. Requires Connector and FFAPI on (neo)forge.
A rewrite of Antique Atlas by Hunternif, as continued by Kenkron, asie, and tyra314.
Requires Surveyor Map Framework. Requires Connector and FFAPI on (neo)forge.
Press [M] at any time to bring up the world map.
Drag the map to pan, scroll to zoom, and use the bookmark buttons to create and remove map markers.
Client-Side Features
- A physical-feeling map screen, with hand-drawn tiles representing chunks in the world:
- Waypoint markers in a variety of styles and accent colors:
- Hold the map in your hands by renaming a book "Antique Atlas" at an anvil:
- Automatic migration of waypoints from Xaero's Minimap, and a shared save format with Hoofprint.
- Extra features via addons like Antique Trains and Dead Reckoning!
Mixed-Side / Singleplayer Features
- Markers are automatically added for notable structures and active nether portals:
- Structures only appear on the map after you've looked at them or stood on them in-game:
- Map exploration and waypoints can be shared with friends via
/surveyor share [player]:
- Add AA4 Atlas to give the handheld atlas a full item ID and crafting recipe!
Troubleshooting / Suggestions
Antique Atlas 4 is a clientside map frontend for Surveyor Map Framework.
It renders surveyor save data as tiles on screen using respacks, and provides a GUI editor for waypoints.
Issues and suggestions regarding the screen, tiles, markers, and resource packs are Antique Atlas 4 Issues.
Issues and suggestions regarding map sharing, explored map area, and automatic markers are Surveyor Issues.
Crash reports must have AA4 and Surveyor on the latest version, and include logs/latest.log via mclo.gs.
Configuration
Antique Atlas can be configured from config/antique-atlas.toml or in-game using McQoy, including:
- Whether to require having an atlas item in the inventory in order to enable the map hotkey.
- Adjustments to the size and scale of the map screen.
- Adjustments to which structures to mark on the map.
- Adjustments for how to stylize player graves.
Additional options can be found in the Surveyor config in config/surveyor.toml.
Addon & Resource Pack Developers
Resource Packs
Tiles, markers, biome detection, and structure detection is fully data-driven via resource packs.
Without defined biomes, atlas "guesses" tiles via tags, and shows ??? if that fails.
For a how-to on AA4 resource packs, check out the resource pack tutorial.
API
Nothing stable! But feel free to poke around:
repositories {
maven { url "https://repo.sleeping.town/" }
}
dependencies {
modImplementation "folk.sisby:antique-atlas:3.0.0+1.20"
}
Try AtlasRenderer.registerOverlay() for non-surveyor mod compat (i.e. mods that already have client sync)
To automatically mark non-structure points of interest - instead use Surveyor's Landmark API.
Licensing + Credit
Please match your addon/respack licenses to LGPLv3 for code & CC BY-NC-SA for assets to help the ecosystem!
(LGPLv3 and CC BY-NC-SA are a copyleft licenses, so this is required for anything directly adapted from AA4)
If you've made an addon/respack, hit us up and we might link it here! If it's still WIP feel free to ask us questions.
Devs can reach out to us on mastodon, via email, or in #projects->Surveyor on ModFest.
Afterword
All mods are built on the work of many others.
The art for antique atlas was created by Hunternif (DA) and lumiscosity (Neocities).
Click here for detailed art credit.
This mod is a loveletter rewrite, and relies heavily on contributions of many developers and artists before us.
Галерея
Последние версии
Все версии →release
3.1.2+1.21
3.1.2+1.215 янв. 2026 г.263,2 тыс.Minecraft: 1.21.1fabric, neoforge, quilt
Что нового
**Changes:**
- Fix crash when placing a custom marker without an associated stack
- Add `PLAINS` setting for biome fallbacks that just uses a `minecraft:plains` provider.
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.2+1.20
release
3.1.2+1.20
3.1.2+1.205 янв. 2026 г.122,1 тыс.Minecraft: 1.20.1fabric, forge, quilt
Что нового
**Changes:**
- Fix crash when placing a custom marker without an associated stack
- Add `PLAINS` setting for biome fallbacks that just uses a `minecraft:plains` provider.
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.2+1.20
release
3.1.1+1.21
3.1.1+1.2131 дек. 2025 г.3 тыс.Minecraft: 1.21.1fabric, neoforge, quilt
Что нового
**Fixes:**
- Prevent editing global landmarks via GUI to avoid confusion
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20
release
3.1.1+1.20
3.1.1+1.2031 дек. 2025 г.3,6 тыс.Minecraft: 1.20.1fabric, forge, quilt
Что нового
**Fixes:**
- Prevent editing global landmarks via GUI to avoid confusion
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20
release
3.1.0+1.21
3.1.0+1.2130 дек. 2025 г.503Minecraft: 1.21.1fabric, neoforge, quilt
Что нового
## The Dimensions Update!!
**Changes:**
* Update to [Surveyor 1.1](https://modrinth.com/mod/surveyor/version/1.1.0+1.20) - supporting cross-dimensional client side mapping.
* Allow viewing other dimensions by pressing `[TAB]` or clicking the new vertical bookmarks.
* Bookmarks have custom icons via `namespace/textures/atlas/dimension/path.png` and color/name via mcmeta.
* Dimension order and relative scale can be tweaked through the config.
* Add a small `...` indicator in the bottom right of the atlas screen when tiles are loading.
* Include stack components with placed markers so they look better for [Hoofprint](https://modrinth.com/mod/hoofprint) players. (vice versa later)
* Correct bookmarks to use base / entity dye colors again - old markers will need colors reset.
<img width="854" height="480" alt="java_hAGKnuUqEl" src="https://github.com/user-attachments/assets/7db6fcf9-f126-4d28-9b12-303b744ab9dd" />
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20
release
3.1.0+1.20
3.1.0+1.2030 дек. 2025 г.659Minecraft: 1.20.1fabric, forge, quilt
Что нового
## The Dimensions Update!!
**Changes:**
* Update to [Surveyor 1.1](https://modrinth.com/mod/surveyor/version/1.1.0+1.20) - supporting cross-dimensional client side mapping.
* Allow viewing other dimensions by pressing `[TAB]` or clicking the new vertical bookmarks.
* Bookmarks have custom icons via `namespace/textures/atlas/dimension/path.png` and color/name via mcmeta.
* Dimension order and relative scale can be tweaked through the config.
* Add a small `...` indicator in the bottom right of the atlas screen when tiles are loading.
* Include stack components with placed markers so they look better for [Hoofprint](https://modrinth.com/mod/hoofprint) players. (vice versa later)
* Correct bookmarks to use base / entity dye colors again - old markers will need colors reset.
<img width="854" height="480" alt="java_hAGKnuUqEl" src="https://github.com/user-attachments/assets/7db6fcf9-f126-4d28-9b12-303b744ab9dd" />
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20
release
3.0.0+1.21
3.0.0+1.2114 дек. 2025 г.7,1 тыс.Minecraft: 1.21.1fabric, neoforge, quilt
Что нового
## Antique Atlas 3.0!
**Major Changes**:
* Update to [Surveyor 1.0](https://modrinth.com/mod/surveyor/version/1.0.0+1.20) - with major improvements to mod compatibility, memory use, and map sharing.
* Allow editing existing map markers by right clicking them.
* Add `emptyHandling` option that allows unexplored chunks to appear as cloud tiles.
* Hold ALT to see the debug / tile information at any time.
* Add nether biomes ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/264))
* Fix atlas rendering with shaders by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/332))
* Badlands, dripstone caves and lush caves tiles + image compression by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/228))
**Minor Changes**:
* Marker texture is now derived from landmark ID, allowing for more flexible marker texturing.
* Renderers for new landmark components like lore (in [Surveystones](https://modrinth.com/mod/surveystones)) and chunks (in [Surveyalot](https://modrinth.com/project/surveyalot))
* Refactor rendering to share code between the screen atlas and handheld atlas, improving consistency.
* stay in delete mode when holding shift by ([PR by @justliliandev](https://github.com/sisby-folk/antique-atlas/pull/233))
* config to require an item to open the map by ([PR by @cassiancc](https://github.com/sisby-folk/antique-atlas/pull/298))
* Some tile cleanup by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/335))
* Redo lush caves tiles by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/339))
* Optimize assets, again by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/340))
* Update texture credits by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/341))
**API**:
* New API for overlays (e.g. [Antique Trains](https://modrinth.com/mod/antique-trains))
* make buttons easier to use in addons by ([PR by @justliliandev](https://github.com/sisby-folk/antique-atlas/pull/331))
**Fixes**:
* Fix being able to interact with map elements underneath the add marker modal
* Fix resizing the window causing visual glitching with the add marker modal
* Shader support workarounds by ([PR by @NoPyro](https://github.com/sisby-folk/antique-atlas/pull/310 (obsoleted)))
* Add .mcmeta for the taiga village tall house by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/319))
* Fix missing null check on terrainToTileNether by ([PR by @limelier](https://github.com/sisby-folk/antique-atlas/pull/202))
* Fix issues with scaling when mapScale != guiScale. by ([PR by @murphy-slaw](https://github.com/sisby-folk/antique-atlas/pull/273))
**Translations**:
* Update Traditional Chinese (zh_tw.json) by ([PR by @dirtTW](https://github.com/sisby-folk/antique-atlas/pull/204))
* updated Ukrainian translation by ([PR by @Tarteroycc](https://github.com/sisby-folk/antique-atlas/pull/207))
* Update Polish translation by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/320))
* upd ru_ru.json by ([PR by @prokrams](https://github.com/sisby-folk/antique-atlas/pull/315))
* es_mx Update by ([PR by @TheLegendofSaram](https://github.com/sisby-folk/antique-atlas/pull/285))
* Update es_ar 1.20 by ([PR by @Texaliuz](https://github.com/sisby-folk/antique-atlas/pull/346))
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.0.0+1.20
release
3.0.0+1.20
3.0.0+1.2014 дек. 2025 г.9,4 тыс.Minecraft: 1.20.1fabric, forge, quilt
Что нового
## Antique Atlas 3.0!
**Major Changes**:
* Update to [Surveyor 1.0](https://modrinth.com/mod/surveyor/version/1.0.0+1.20) - with major improvements to mod compatibility, memory use, and map sharing.
* Allow editing existing map markers by right clicking them.
* Add `emptyHandling` option that allows unexplored chunks to appear as cloud tiles.
* Hold ALT to see the debug / tile information at any time.
* Add nether biomes ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/264))
* Fix atlas rendering with shaders by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/332))
* Badlands, dripstone caves and lush caves tiles + image compression by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/228))
**Minor Changes**:
* Marker texture is now derived from landmark ID, allowing for more flexible marker texturing.
* Renderers for new landmark components like lore (in [Surveystones](https://modrinth.com/mod/surveystones)) and chunks (in [Surveyalot](https://modrinth.com/project/surveyalot))
* Refactor rendering to share code between the screen atlas and handheld atlas, improving consistency.
* stay in delete mode when holding shift by ([PR by @justliliandev](https://github.com/sisby-folk/antique-atlas/pull/233))
* config to require an item to open the map by ([PR by @cassiancc](https://github.com/sisby-folk/antique-atlas/pull/298))
* Some tile cleanup by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/335))
* Redo lush caves tiles by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/339))
* Optimize assets, again by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/340))
* Update texture credits by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/341))
**API**:
* New API for overlays (e.g. [Antique Trains](https://modrinth.com/mod/antique-trains))
* make buttons easier to use in addons by ([PR by @justliliandev](https://github.com/sisby-folk/antique-atlas/pull/331))
**Fixes**:
* Fix being able to interact with map elements underneath the add marker modal
* Fix resizing the window causing visual glitching with the add marker modal
* Shader support workarounds by ([PR by @NoPyro](https://github.com/sisby-folk/antique-atlas/pull/310 (obsoleted)))
* Add .mcmeta for the taiga village tall house by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/319))
* Fix missing null check on terrainToTileNether by ([PR by @limelier](https://github.com/sisby-folk/antique-atlas/pull/202))
* Fix issues with scaling when mapScale != guiScale. by ([PR by @murphy-slaw](https://github.com/sisby-folk/antique-atlas/pull/273))
**Translations**:
* Update Traditional Chinese (zh_tw.json) by ([PR by @dirtTW](https://github.com/sisby-folk/antique-atlas/pull/204))
* updated Ukrainian translation by ([PR by @Tarteroycc](https://github.com/sisby-folk/antique-atlas/pull/207))
* Update Polish translation by ([PR by @lumiscosity](https://github.com/sisby-folk/antique-atlas/pull/320))
* upd ru_ru.json by ([PR by @prokrams](https://github.com/sisby-folk/antique-atlas/pull/315))
* es_mx Update by ([PR by @TheLegendofSaram](https://github.com/sisby-folk/antique-atlas/pull/285))
* Update es_ar 1.20 by ([PR by @Texaliuz](https://github.com/sisby-folk/antique-atlas/pull/346))
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.0.0+1.20
release
2.12.0+1.21
2.12.0+1.2113 окт. 2025 г.47,2 тыс.Minecraft: 1.21.1fabric, neoforge, quilt
Что нового
**Changes:**
* Add nether biomes by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/264
* Badlands, dripstone caves and lush caves tiles + image compression by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/228
* Fix issues with scaling when mapScale != guiScale. by @murphy-slaw in https://github.com/sisby-folk/antique-atlas/pull/273
* Shader support workarounds by @NoPyro in https://github.com/sisby-folk/antique-atlas/pull/310
* Require an item to open the map by @cassiancc in https://github.com/sisby-folk/antique-atlas/pull/298
* stay in delete mode when holding shift by @justliliandev in https://github.com/sisby-folk/antique-atlas/pull/233
* Fix missing null check on terrainToTileNether by @limelier in https://github.com/sisby-folk/antique-atlas/pull/202
* Add .mcmeta for the taiga village tall house by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/319
* Update Traditional Chinese (zh_tw.json) by @dirtTW in https://github.com/sisby-folk/antique-atlas/pull/204
* updated Ukrainian translation by @Tarteroycc in https://github.com/sisby-folk/antique-atlas/pull/207
* Update Polish translation by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/320
* upd ru_ru.json by @prokrams in https://github.com/sisby-folk/antique-atlas/pull/315
* es_mx Update by @TheLegendofSaram in https://github.com/sisby-folk/antique-atlas/pull/285
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v2.12.0+1.20
release
2.12.0+1.20
2.12.0+1.2013 окт. 2025 г.135,5 тыс.Minecraft: 1.20.1fabric, forge, quilt
Что нового
**Changes:**
* Add nether biomes by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/264
* Badlands, dripstone caves and lush caves tiles + image compression by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/228
* Fix issues with scaling when mapScale != guiScale. by @murphy-slaw in https://github.com/sisby-folk/antique-atlas/pull/273
* Shader support workarounds by @NoPyro in https://github.com/sisby-folk/antique-atlas/pull/310
* Require an item to open the map by @cassiancc in https://github.com/sisby-folk/antique-atlas/pull/298
* stay in delete mode when holding shift by @justliliandev in https://github.com/sisby-folk/antique-atlas/pull/233
* Fix missing null check on terrainToTileNether by @limelier in https://github.com/sisby-folk/antique-atlas/pull/202
* Add .mcmeta for the taiga village tall house by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/319
* Update Traditional Chinese (zh_tw.json) by @dirtTW in https://github.com/sisby-folk/antique-atlas/pull/204
* updated Ukrainian translation by @Tarteroycc in https://github.com/sisby-folk/antique-atlas/pull/207
* Update Polish translation by @lumiscosity in https://github.com/sisby-folk/antique-atlas/pull/320
* upd ru_ru.json by @prokrams in https://github.com/sisby-folk/antique-atlas/pull/315
* es_mx Update by @TheLegendofSaram in https://github.com/sisby-folk/antique-atlas/pull/285
Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v2.12.0+1.20