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.

2.5M загрузок2K подписчиковLGPL-3.0-or-laterfabricforgeneoforgequilt

Обновлён 5 января 2026 г. · опубликован 6 января 2024 г.

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.

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.

Версии

Версия	Канал	Игра	Загрузчики	Дата	Скачать
3.1.2+1.21	Релиз	1.21.1	fabric, neoforge, quilt	5 января 2026 г.	.jar (871 КБ)
3.1.2+1.20	Релиз	1.20.1	fabric, forge, quilt	5 января 2026 г.	.jar (866 КБ)
3.1.1+1.21	Релиз	1.21.1	fabric, neoforge, quilt	31 декабря 2025 г.	.jar (870 КБ)
3.1.1+1.20	Релиз	1.20.1	fabric, forge, quilt	31 декабря 2025 г.	.jar (866 КБ)
3.1.0+1.21	Релиз	1.21.1	fabric, neoforge, quilt	30 декабря 2025 г.	.jar (870 КБ)
3.1.0+1.20	Релиз	1.20.1	fabric, forge, quilt	30 декабря 2025 г.	.jar (866 КБ)
3.0.0+1.21	Релиз	1.21.1	fabric, neoforge, quilt	14 декабря 2025 г.	.jar (853 КБ)
3.0.0+1.20	Релиз	1.20.1	fabric, forge, quilt	14 декабря 2025 г.	.jar (848 КБ)
2.12.0+1.21	Релиз	1.21.1	fabric, neoforge, quilt	13 октября 2025 г.	.jar (1.4 МБ)
2.12.0+1.20	Релиз	1.20.1	fabric, forge, quilt	13 октября 2025 г.	.jar (1.4 МБ)
2.11.2+1.21	Релиз	1.21.1	fabric, neoforge, quilt	16 февраля 2025 г.	.jar (825 КБ)
2.11.2+1.20	Релиз	1.20.1	fabric, forge, quilt	16 февраля 2025 г.	.jar (821 КБ)
2.11.1+1.21	Релиз	1.21.1	fabric, neoforge, quilt	27 января 2025 г.	.jar (825 КБ)
2.11.1+1.20	Релиз	1.20.1	fabric, forge, quilt	27 января 2025 г.	.jar (820 КБ)
2.11.0+1.21	Релиз	1.21.1	fabric, neoforge, quilt	13 января 2025 г.	.jar (825 КБ)

Показаны последние 15 из 97 версий. Все версии — на Modrinth.

Ченджлог

3.1.2+1.21Релиз1.21.1 · 5 января 2026 г.

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

3.1.2+1.20Релиз1.20.1 · 5 января 2026 г.

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

3.1.1+1.21Релиз1.21.1 · 31 декабря 2025 г.

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

3.1.1+1.20Релиз1.20.1 · 31 декабря 2025 г.

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

3.1.0+1.21Релиз1.21.1 · 30 декабря 2025 г.

The Dimensions Update!!

Changes:

Update to Surveyor 1.1 - 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 players. (vice versa later)
Correct bookmarks to use base / entity dye colors again - old markers will need colors reset.

Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20

3.1.0+1.20Релиз1.20.1 · 30 декабря 2025 г.

The Dimensions Update!!

Changes:

Update to Surveyor 1.1 - 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 players. (vice versa later)
Correct bookmarks to use base / entity dye colors again - old markers will need colors reset.

Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.1.0+1.20

3.0.0+1.21Релиз1.21.1 · 14 декабря 2025 г.

Antique Atlas 3.0!

Major Changes:

Update to Surveyor 1.0 - 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)
Fix atlas rendering with shaders by (PR by @lumiscosity)
Badlands, dripstone caves and lush caves tiles + image compression by (PR by @lumiscosity)

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) and chunks (in 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)
config to require an item to open the map by (PR by @cassiancc)
Some tile cleanup by (PR by @lumiscosity)
Redo lush caves tiles by (PR by @lumiscosity)
Optimize assets, again by (PR by @lumiscosity)
Update texture credits by (PR by @lumiscosity)

API:

New API for overlays (e.g. Antique Trains)
make buttons easier to use in addons by (PR by @justliliandev)

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)
Add .mcmeta for the taiga village tall house by (PR by @lumiscosity)
Fix missing null check on terrainToTileNether by (PR by @limelier)
Fix issues with scaling when mapScale != guiScale. by (PR by @murphy-slaw)

Translations:

Update Traditional Chinese (zh_tw.json) by (PR by @dirtTW)
updated Ukrainian translation by (PR by @Tarteroycc)
Update Polish translation by (PR by @lumiscosity)
upd ru_ru.json by (PR by @prokrams)
es_mx Update by (PR by @TheLegendofSaram)
Update es_ar 1.20 by (PR by @Texaliuz)

Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.0.0+1.20

3.0.0+1.20Релиз1.20.1 · 14 декабря 2025 г.

Antique Atlas 3.0!

Major Changes:

Update to Surveyor 1.0 - 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)
Fix atlas rendering with shaders by (PR by @lumiscosity)
Badlands, dripstone caves and lush caves tiles + image compression by (PR by @lumiscosity)

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) and chunks (in 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)
config to require an item to open the map by (PR by @cassiancc)
Some tile cleanup by (PR by @lumiscosity)
Redo lush caves tiles by (PR by @lumiscosity)
Optimize assets, again by (PR by @lumiscosity)
Update texture credits by (PR by @lumiscosity)

API:

New API for overlays (e.g. Antique Trains)
make buttons easier to use in addons by (PR by @justliliandev)

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)
Add .mcmeta for the taiga village tall house by (PR by @lumiscosity)
Fix missing null check on terrainToTileNether by (PR by @limelier)
Fix issues with scaling when mapScale != guiScale. by (PR by @murphy-slaw)

Translations:

Update Traditional Chinese (zh_tw.json) by (PR by @dirtTW)
updated Ukrainian translation by (PR by @Tarteroycc)
Update Polish translation by (PR by @lumiscosity)
upd ru_ru.json by (PR by @prokrams)
es_mx Update by (PR by @TheLegendofSaram)
Update es_ar 1.20 by (PR by @Texaliuz)

Changelog: https://github.com/sisby-folk/antique-atlas/releases/tag/v3.0.0+1.20

Полная история изменений — на Modrinth.

Client-Side Features

Mixed-Side / Singleplayer Features

Troubleshooting / Suggestions

Configuration

Addon & Resource Pack Developers

Resource Packs

API

Licensing + Credit

Afterword

Версии

Ченджлог

The Dimensions Update!!

The Dimensions Update!!

Antique Atlas 3.0!

Antique Atlas 3.0!

Комментарии