What Is the Surveyor Map Framework?
If you have ever wished your Minecraft world map felt more alive, shared, and persistent across play sessions, the Surveyor Map Framework is about to become your new best friend. This open-source backend and API handles all the heavy lifting for world map and waypoint mods, so you can focus on exploring instead of worrying about lost data or incompatible addons. Think of Surveyor as the invisible engine behind mods like Antique Atlas 4, Hoofprint, and Via Romana — it stores terrain, tracks waypoints, and even lets you see other players hundreds of chunks away.
Unlike standalone minimap mods that lock you into a single interface, Surveyor keeps your map data completely separate from how you view it. That means you can swap between a full-screen atlas and a corner minimap at any time without losing a single explored chunk. It is designed from the ground up to be modular, so mod developers can tap into its waypoint system without enabling terrain scanning, and you can mix and match frontends however you like.
Why Surveyor Changes the Map Game
Traditional map mods often tie your progress to one specific mod’s file format. Lose your computer or switch servers, and you might have to start exploring all over again. Surveyor flips that on its head by storing everything in plain NBT files under data/surveyor. Even better, if your local map data gets corrupted or you move to a new machine, the server can restore your exploration history automatically. That alone makes it a must-have for anyone who plays on multiple devices or servers.
The framework also brings live map sharing to the table. With a simple command, you can form a sharing group with friends and instantly see each other’s terrain discoveries, waypoints, and player positions. It feels like a cooperative cartography project, and it works seamlessly whether you are on a private server or a massive public one. Server admins can even configure a global sharing group so every player contributes to a unified world map.
Core Features That Make Surveyor Stand Out
- Persistent exploration tracking — your map data follows you across computers and servers, restored from the server when needed.
- Live player visibility — see other players on your map even when they are hundreds of chunks away, with configurable update rates.
- Flexible frontend swapping — change your map interface (Atlas, minimap, HUD) anytime without losing terrain or waypoints.
- Waypoint import — pull in existing waypoints from Xaero's Minimap so you do not have to start from scratch.
- Mod integrations — works with Waystones, OPAC, and other mods to display their landmarks automatically.
- Full modularity — terrain, structure, and landmark subsystems can be toggled independently, keeping performance in check.
Getting Surveyor up and running requires Connector and FFAPI on (Neo)Forge, but managing those dependencies is far from a chore. A convenient way to handle the whole setup is through the foxygame.net launcher — a modern, flexible launcher where you can install mods right from the menu, making it effortless to grab Surveyor and its required libraries without digging through file folders. Once installed, Surveyor quietly begins recording your world the moment you step into a dimension.
Commands That Put You in Control
Even if you do not have a map frontend installed, Surveyor includes a set of handy commands that work right from the chat box. Server admins and solo players alike will appreciate the transparency and control these offer.
/surveyor
Running /surveyor displays a quick summary of how many chunks and structures you have explored, plus the number of waypoints you have recorded. It is a great way to check your progress without opening any GUI.
/surveyor share [player] and /surveyor unshare
These commands let you join or leave map sharing groups on the fly. Once shared, terrain and waypoints sync between group members in real time, turning exploration into a team effort.
/waypoints
The /waypoints command opens an interface for viewing and editing your personal waypoints. You can add, remove, or rename them without needing a separate waypoint mod.
/landmarks
For server-wide points of interest, /landmarks allows ops (level 2 and above) to create and edit global waypoints that every player can see. This is perfect for marking spawn towns, community farms, or event locations.
Under the Hood: Data and Configuration
All Surveyor data lives in plain NBT format, making it both human-readable and easy to back up. In singleplayer and on servers, per-dimension data sits under data/surveyor; on the client side, it is stored in your .minecraft folder. This transparent structure means you can manually copy or share map files if you ever need to.
Configuration is handled through config/surveyor.toml or in-game using McQoy. You can toggle terrain, structure, and landmark subsystems, decide what data gets networked between clients and the server, set how often player positions update, and even force all players on a server into one global sharing group. The level of control makes Surveyor equally comfortable on a small friend server or a large public network.
A Boon for Mod Developers
Surveyor was built with the modding community in mind. Its API is fully documented, and the team actively encourages addon creation, compatibility patches, and even ports to older Minecraft versions like 1.12.2 or 1.16.5. If you have an idea for a web map, a new minimap style, or a waypoint frontend, Surveyor gives you the backend to make it happen without reinventing the wheel.
The project is licensed under LGPLv3, a copyleft license that asks addon developers to keep their work open as well — a move that strengthens the entire ecosystem. Pull requests for enhancements, bug fixes, or version ports are warmly welcomed, and the team can be reached through the ModFest Discord or via email. A frontend development guide is available to walk you through the internals, so you can hit the ground running.
Why Surveyor Is the Future of Minecraft Cartography
The Surveyor Map Framework does not just add another minimap to your mod list — it rethinks how map data should be stored, shared, and displayed. By separating the data from the presentation, it gives you freedom to customize your experience while keeping your exploration safe. The built-in player tracking, live sharing, and easy command access turn a solo activity into a collaborative adventure, and the developer-friendly API promises a steady stream of creative frontends in the future.
Whether you are a casual builder who wants to keep track of every village, a server admin looking to unite your community’s exploration, or a modder itching to craft the next great atlas, Surveyor provides a solid, open foundation. Install it once, and your world map finally becomes as persistent and connected as your builds deserve to be.
--- **Update May 13, 2026:** Added 3 files for version 26.1, 1.21.1, 1.20.1 (Fabric).