Modrinth · Fabric, Forge, NeoForge, Quilt

Surveyor Map Framework auf deinem Minecraft Server

Surveyor Map Framework läuft auf Minecraft Servern mit Fabric oder Forge oder NeoForge oder Quilt. Bestell deinen Server, stell den Loader im Panel ein und installiere die Mod mit einem Klick im Mod-Browser.

Maps with friends! A world map backend with multiplayer sharing, automatic structure/POI marking, and unified mod compatibility.

Downloads
2.6M
Autor
sleepingdragoninn
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.20.1 – 26.1.2
Aktualisiert
–

Screenshots

So sieht Surveyor Map Framework aus

Alle 11 Bilder auf Modrinth

Bilder: Surveyor Map Framework auf Modrinth, vom Projektteam veröffentlicht.

Einrichtung

Surveyor Map Framework auf dem Server installieren

Server und Spieler brauchen denselben Loader und dieselbe Minecraft-Version. Sichere die Welt, bevor du Mods hinzufügst oder aktualisierst.

  1. 01

    Konfigurieren

    4 GB RAM sind vorausgewählt. Laufzeit und Add-ons wählst du selbst, bezahlt wird per Kreditkarte oder PayPal.

  2. 02

    Loader einstellen

    Stell im Panel die Serversoftware auf Fabric oder Forge oder NeoForge oder Quilt und wähl die passende Minecraft-Version, zum Beispiel 26.1.2.

  3. 03

    Mod installieren

    Such im Mod-Browser nach „Surveyor Map Framework“ und installiere die Version für deinen Loader. Alternativ lädst du die .jar per SFTP in den Ordner mods. Erforderliche Abhängigkeiten stehen auf der Projektseite.

  4. 04

    Verbinden

    Surveyor Map Framework ist auf dem Client optional. Spieler verbinden sich über die Serveradresse aus dem Panel.

Auf dem Server
Optional
Auf dem Client
Optional
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.1.2, 1.21.8, 1.21.1 +1 weitere
Lizenz
GNU Lesser General Public License v3.0 or later

Das Panel

Mods installieren, Fehler finden.

Echte Screenshots aus dem Mado Panel. Beides ist bei jedem Minecraft Server enthalten.

Mod-Browser

Modrinth und CurseForge direkt im Panel.

Der Browser filtert nach deiner Minecraft-Version. Mods installierst du mit einem Klick, ohne .jar-Dateien hochzuladen.

Browser im Mado Panel mit Suche, Quellenwahl CurseForge oder Modrinth und Install-Buttons.

KI-Crash-Analyse

Wenn ein Mod crasht, liest die Analyse das Log.

Mods scheitern oft an einer falschen Loader-Version, Java-Version oder fehlenden Abhängigkeit. Die Analyse nennt eine wahrscheinliche Ursache und einen Lösungsvorschlag.

Optimierungsseite im Mado Panel mit aktiviertem KI-Log-Analyzer und der Meldung „Server Crashed“ samt Button „Analyze Now“.

Versionen

Veröffentlichte Versionen

Nimm die Datei, die zu Loader und Minecraft-Version deines Servers passt. Server und Spieler brauchen dieselbe Version.

Surveyor Map Framework · Modrinth
Originalbeschreibung des Projektautors
surveyor banner
An open-source backend (and API) for co-op-enabled world map and waypoint mods!
Requires Connector and FFAPI on (neo)forge.

Surveyor is the backend for map mods like Antique Atlas 4, Hoofprint, and Dead Reckoning.

When installed client-side, Surveyor allows you to:

  • View explored terrain and mark points of interest with waypoints
  • See on-map landmarks for other mods via compatibility addons, like for Waystones and OPAC
  • Swap map frontends at any time, retaining all map data
  • Automatically migrate waypoints directly from an existing Xaero's Minimap save

When installed on both sides, Surveyor allows you to:

  • Explore map terrain and edit waypoints in co-operative groups (server-wide by default)
  • See other players on your map, even far away or in other dimensions
  • Swap instances or computers, with your map data restored from the server
  • Use op commands to create server-wide landmarks for POIs like spawn, shops, warp hubs, etc.
  • Copy exploration from and to vanilla maps by sneak+using a cartography table (style configurable)

vanilla map integration preview

As a mod developer, Surveyor allows you to:

  • Create pure map frontends by handling all map data itself - terrain, structures, and waypoints
  • Create addons for custom on-map landmarks, with a flexible component-style data system
  • Create any kind of frontend - server-optional, ingame/mixed-side, external/browser-based, etc
  • Utilize the waypoint system on its own, for small, lightweight waypoint/compass mods
Configuration

Surveyor can be configured via config/surveyor.toml, McQoy, or QoMC. Most changes require a restart.

  • Disable server-wide co-op by setting globalSharing=false (recommended for public servers)
  • Tweak what data is synchronized between players, groups, and the server in the Networking section
  • Toggle builtin automatic waypoints (e.g. nether portals, grave markers) in the Builtins section
Commands

Surveyor can mostly be interacted with via map frontends, but comes with a few useful commands:

  • When globalSharing=false, use /surveyor share/unshare to form groups to share waypoints and map data
  • Use /surveyor, /waypoints, and /landmarks to review your waypoints and explored map data
  • Use /waypoints new/remove to create/edit custom waypoints (e.g. if a frontend is not installed)
  • Use /landmarks new/remove (op 2) to create/edit operator-level global waypoints (e.g. for server spawn)

Troubleshooting

Report any unique replicable issue to the issues page with logs, screenshots, and replication steps where possible.

Client data is stored in .minecraft/data/surveyor/[world]/[dim], singleplayer/server data in [world]/[dim]/data/surveyor

c.X.X files contain terrain regions, s.X.X files contain structures, and landmarks.dat contains waypoint data.

When encountering issues, you might like to try any of the following:

  • Backing up the affected data and deleting it (e.g. for a structure-related error, wipe structure data)
  • Disabling networking for a subsystem (e.g. for a terrain packet client kick, set networking.terrain to NONE)
  • Disabling a subsystem (e.g. for extreme server memory usage, set terrain to DISABLED on the server)

Contributions / Addons

Feel free to reach out if you'd like to develop something with surveyor - or just go for it! We appreciate:

  • PRs making shots at surveyor enhancements and bugs
  • PRs containing ports to an older established versions (1.4.7, 1.17.10, 1.12.2, 1.16.5, 1.18.2) - or latest, per policy
  • PRs containing API features that you'd benefit from - ideally post an issue first, and we can workshop it
  • Compat addons, world maps, minimaps, and waypoint frontends utilizing surveyor!

Check out the frontend dev guide for a breakdown of the complicated parts of the internals.

Licensing / Credit

Please match your addon licenses to LGPLv3 if possible - it helps improve the surveyor ecosystem!

(LGPLv3 is a copyleft license, so this is required for anything directly adapted from Surveyor)

If you've written something, hit us up and we might link it here! We'll also answer questions for in-progress projects.

Devs can reach out on mastodon or via email.

Afterword

Surveyor was built on the thoughts, advice, opinions, and past works of many modders in the community.

Thanks to everyone who helped make this project happen, even just by fluttering on the sidelines - it means a lot.

We made surveyor because it sounded cool - we hope it helps other artists/modders to make cool things!

FAQ

Fragen zu Surveyor Map Framework

Deine Frage fehlt? Frag unser Team.

Surveyor Map Framework Server crasht beim Start – was tun?

Häufige Ursachen: Loader- oder Minecraft-Version passen nicht zur Mod-Datei, eine Abhängigkeit fehlt oder der RAM reicht nicht. Such im Log (latest.log) nach „OutOfMemoryError“, „Mixin“ oder fehlenden Mods. Bei Mado wertet die KI-Crash-Analyse das Log aus und schlägt eine Ursache vor. Loader und Version änderst du im Panel.

Mit welchem Loader läuft Surveyor Map Framework?

Laut Modrinth unterstützt Surveyor Map Framework Fabric, Forge, NeoForge, Quilt für Minecraft 26.1.2, 1.21.8, 1.21.1. Forge- und Fabric-Dateien sind nicht untereinander austauschbar: Wähl einen Loader für Server und Clients.

Wie viel RAM braucht ein Server mit Surveyor Map Framework?

Als Orientierung 3–4 GB für einen Server mit dieser Mod. Das ist eine Schätzung, keine gemessene Mindestanforderung. Weitere Mods, viele Spieler und große Sichtweiten brauchen mehr. Ob eine Mod die Tick-Zeit belastet, siehst du mit dem spark-Profiler.

Bereit für deinen Server mit Surveyor Map Framework?

4 GB RAM ab 8,00 € im Monat. 35 % auf den 1. Monat mit MADO35.

Server bestellen