\nA hand-drawn clientside world map, with map sharing, structure discovery, and more!
\nA rewrite of Antique Atlas by Hunternif, as continued by Kenkron, asie, and tyra314.
\nRequires Surveyor Map Framework.<\/b>
\nRequires Connector and FFAPI on (neo)forge.<\/b>
\n<\/center><\/p>\n—<\/p>\n
Press **[M]** at any time to bring up the world map.
\nDrag the map to pan, scroll to zoom, and use the bookmark buttons to create and remove map markers.<\/p>\n
## Client-Side Features<\/p>\n
– A physical-feeling map screen, with hand-drawn tiles representing chunks in the world:<\/p>\n
> <\/p>\n
– Waypoint markers in a variety of styles and accent colors:<\/p>\n
> <\/p>\n
– Hold the map in your hands by renaming a book “Antique Atlas” at an anvil:<\/p>\n
> <\/p>\n
– Automatic migration of waypoints from Xaero’s Minimap, and a shared save format with Hoofprint.
\n– Extra features via addons like Antique Trains and Dead Reckoning!<\/p>\n
## Mixed-Side \/ Singleplayer Features<\/p>\n
– Markers are automatically added for notable structures and active nether portals:<\/p>\n
> <\/p>\n
– Structures only appear on the map after you’ve looked at them or stood on them in-game:<\/p>\n
> <\/p>\n
– Map exploration and waypoints can be shared with friends via `\/surveyor share [player]`:<\/p>\n
> <\/p>\n
– Add AA4 Atlas to give the handheld atlas a full item ID and crafting recipe!<\/p>\n
## Troubleshooting \/ Suggestions<\/p>\n
Antique Atlas 4 is a **clientside map frontend** for Surveyor Map Framework.
\nIt renders surveyor save data as tiles on screen using respacks, and provides a GUI editor for waypoints.
\nIssues and suggestions regarding the screen, tiles, markers, and resource packs are Antique Atlas 4 Issues.
\nIssues and suggestions regarding map sharing, explored map area, and automatic markers are Surveyor Issues.
\n**Crash reports must have AA4 and Surveyor on the latest version, and include `logs\/latest.log` via mclo.gs.** <\/p>\n
## Configuration<\/p>\n
Antique Atlas can be configured from `config\/antique-atlas.toml` or in-game using McQoy, including:
\n– Whether to require having an atlas item in the inventory in order to enable the map hotkey.
\n– Adjustments to the size and scale of the map screen.
\n– Adjustments to which structures to mark on the map.
\n– Adjustments for how to stylize player graves.<\/p>\n
Additional options can be found in the Surveyor config in `config\/surveyor.toml`.<\/p>\n
## Addon & Resource Pack Developers<\/p>\n
### Resource Packs<\/p>\n
Tiles, markers, biome detection, and structure detection is fully data-driven via resource packs.
\n**Without defined biomes, atlas “guesses” tiles via tags, and shows `???` if that fails.**<\/p>\n
For a how-to on AA4 resource packs, check out the resource pack tutorial.<\/p>\n
### API<\/p>\n
Nothing stable! But feel free to poke around:<\/p>\n
“`groovy
\nrepositories {
\n\tmaven { url “https:\/\/repo.sleeping.town\/” }
\n}
\ndependencies {
\n\tmodImplementation “folk.sisby:antique-atlas:3.0.0+1.20”
\n}
\n“`<\/p>\n
Try `AtlasRenderer.registerOverlay()` for non-surveyor mod compat (i.e. mods that already have client sync)<\/p>\n
To automatically mark non-structure points of interest – instead use Surveyor’s Landmark API.<\/p>\n
### Licensing + Credit<\/p>\n
Please match your addon\/respack licenses to LGPLv3 for code & CC BY-NC-SA for assets to help the ecosystem!
\n(LGPLv3 and CC BY-NC-SA are a copyleft licenses, so this is required for anything directly adapted from AA4)<\/p>\n
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.
\nDevs can reach out to us on mastodon, via [email](mailto:sleepingdragoninn@gmail.com), or in #projects->Surveyor on ModFest.<\/p>\n
## Afterword<\/p>\n
All mods are built on the work of many others.<\/p>\n
The art for antique atlas was created by Hunternif (DA) and lumiscosity (Neocities).
\nClick here for detailed art credit.<\/p>\n
This mod is a loveletter rewrite, and relies heavily on contributions of many developers and artists before us.<\/p>\n","protected":false},"excerpt":{"rendered":"
A hand-drawn clientside world map, with map sharing, structure discovery, and less!
\nA map frontend for Surveyor based on hunternif’s Antique Atlas.<\/p>\n","protected":false},"featured_media":16226,"template":"","meta":{"_minecraft_slug":"antique-atlas-4","_minecraft_project_id":"Y5Ve4Ui4","_minecraft_author":"sisby-folk","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":2296844,"_minecraft_follows":1878,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"antique-atlas-4.zip","_minecraft_size_bytes":91683523,"_minecraft_version_count":96,"_minecraft_updated_at":"2026-05-16T08:45:46.222365Z","_minecraft_date_created":"2024-01-08T00:59:59.862041Z","_minecraft_date_modified":"2026-01-05T08:52:18.056259Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/antique-atlas-4","_minecraft_icon_attachment_id":16226,"_minecraft_imported_at":"2026-05-31T18:56:00+00:00","_minecraft_import_hash":"d34bd57fda0b35ef17bc8ae9263bcbd6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,104,873,158,98,867,92],"mod_loader":[99,106,160,100],"minecraft_version":[56,36,37],"class_list":["post-16225","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-19-2","minecraft_version-1-20-1","minecraft_version-1-21-1"],"yoast_head":"\n
Antique Atlas 4 - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Antique Atlas 4 - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A hand-drawn clientside world map, with map sharing, structure discovery, and less! A map frontend for Surveyor based on hunternif's Antique Atlas.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/\",\"name\":\"Antique Atlas 4 - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png\",\"datePublished\":\"2026-05-31T18:55:59+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png\",\"width\":480,\"height\":480},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/antique-atlas-4\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Antique Atlas 4\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Antique Atlas 4 - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/","og_locale":"en_US","og_type":"article","og_title":"Antique Atlas 4 - Minecraft","og_description":"A hand-drawn clientside world map, with map sharing, structure discovery, and less! A map frontend for Surveyor based on hunternif's Antique Atlas.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/","name":"Antique Atlas 4 - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png","datePublished":"2026-05-31T18:55:59+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/antique-atlas-4-icon-c0f117d80004f69fbea1367148c85f731da3dfbb.png","width":480,"height":480},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/antique-atlas-4\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Antique Atlas 4"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/16225","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/16226"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=16225"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=16225"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=16225"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=16225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}