Teyvat Cartographia

A Genshin Impact inspired world map and minimap: painted explored map, cave layers, pins, waypoints in the world and a walking path.
Back to Files

2.0.1+mc26.3-fabric

File nameteyvatcartographia-v2.0.1-mc26.3-fabric.jar
Uploader
TapacywkaTapacywka
Uploaded
Nov 18, 2026
Downloads
3
Size
861.6 KB
Mod Loaders
Fabric
File ID
9689668
Type
R
Release
Supported game versions
  • 26.3

Curse Maven Snippet

Fabric

modImplementation "curse.maven:teyvat-cartographia-1764160:9689668"

Learn more about Curse Maven

What's new

Changelog

All notable changes to Teyvat Cartographia are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. Each release file is built for one game and loader, named in the build metadata after the version: 0.2.0+mc1.21.1-neoforge is version 0.2.0 for Minecraft 1.21.1 on NeoForge. Since 0.5.0 every version comes for both Fabric and NeoForge (+mc1.21.1-fabric, +mc1.21.1-neoforge), since 0.6.0 also for Minecraft 26.1.2 (+mc26.1.2-fabric, +mc26.1.2-neoforge), since 0.7.0 also for 26.2 and 26.3.

Unreleased

2.0.1 - 2026-11-18

Fixed

  • A region of the map pushed out of memory while its save failed is no longer lost: it is written with the next save, or before it is read again when you come back to it.

2.0.0 - 2026-11-18

Changed

  • Needs Actually Amazing Config Screen 2.0.0: update it beside the mod.

Fixed

  • A pin file with some pins this version cannot read is kept as markers.json.broken before those pins are left out, as it already was when no pin could be read.
  • The list of waystones seen is written through a temporary file, so a game closed in the middle of writing it no longer forgets every stone seen but not activated.
  • Two worlds or servers whose names are longer than 80 characters and begin alike no longer share one map. The map of such a world moves to a folder of its own the first time the world is opened.
  • Teleport on the world map put the player a block off at negative coordinates (west and north of 0); now they stand in the middle of the block clicked.
  • A region saved while the game stopped (a crash, power gone) no longer comes back with holes of blank land called explored: its picture is written before what it says about its chunks.
  • Closing the game while the map is still being saved waits for it to finish (up to a minute) instead of cutting it off after 5 seconds.
  • A region of the map that could not be written (a full disk, a file held by another program) is saved again with the next save instead of keeping its last changes only in memory.
  • Switching resource packs twice in a row no longer leaves the map with the block colours of the first pack.
  • Large ships of Sable on the radar no longer make the game stutter when several come into view at once (1.21.1).
  • A tracked pin whose file could not be read no longer comes back as a target without its pin after rejoining the world.

1.5.0 - 2026-11-17

Added

  • Create's railways on the maps (Minecraft 1.21.1): the tracks as rails with sleepers on both maps (one line far out), stations with their names and signals, every train of the world on the world map (its carriages near, joined by couplings, a badge far out, coloured by what it is doing) with a tooltip of its name, owner, destination and state, and the carriages near you on the minimap. Where each shows: Settings > Compatibility > Create.

Changed

  • Needs Actually Amazing Config Screen 1.5.0 (only its version number changed: update it beside the mod).
  • The preview card of the settings shows an example for every row of the radar: one of each kind round you, drawn as the radar draws them with your settings, on the world map and the minimap. On Minecraft 1.21.1 likewise for the rows of Create (a railway with a station, a signal and a train), Sable (a ship) and the faces of Vanilla Backport and Tiny Takeover Backport (off and on side by side).

Removed

  • Minecraft 26.x: the support of The Aether and The Sift (their own Fog of War, no cave map in the Aether, the shimmer of ichor and ichor snow), as both mods are made for 1.21.1 only.

Fixed

  • A map region the game could not read for want of memory is no longer set aside as damaged: its files stay as they are and the region loads when the world is opened again.
  • A map region whose data file cannot be read at all is kept beside the map as damaged (.broken) instead of being mapped anew over its old picture, and is no longer deleted as an old format when the map's folder is checked.
  • One damaged line of a map's index, or one damaged stone in the file of the waystones seen, no longer loses the others with it.
  • The import of the explored map from Xaero's World Map also finds the map of a single player world. Xaero's World Map draws such a world straight from its save and keeps no map files of its own, until you use its full resave (its map > the map's menu), which keeps them as "Converted World Save": the import now lists that one too.

1.4.1 - 2026-11-14

Changed

  • Settings: the check boxes of Cave map, View cone and the paths stand in the same columns as those of the pins (World map, Minimap, ...) instead of spreading over the whole row.
  • Settings > Radar: where each kind shows (and the radar of Sable in Compatibility) is a box for each map instead of the steps Off, Minimap, Both maps, so a kind can now show on the world map alone.
  • Settings > Map and the map's quick settings: Plants come before Cave map.
  • Settings > Radar: the radar itself is a box for each map, so it can show on the world map alone or on the minimap alone.
  • The map's quick settings follow the order of the settings screen (the Map tab's rows, then the radar, then the pins) and have a switch for the radar on the world map.
  • Shown after tracking says "1 min" instead of "60 s".

Fixed

  • In the Rounded interface style the world map's zoom slider and the settings' sliders and check boxes stopped a few pixels short of where they stand in the Rectangular style.

1.4.0 - 2026-11-14

Added

  • Settings > Pins > Path to the target: "Shown after tracking", how long the marker, beam and stars of a tracked pin show after you track it or press the key to show it again: 30 s, 60 s (as before), 2 min, 5 min or always.
  • A radar on the minimap and the world map: other players as arrows in their team's colour or as the heads of their skins in a frame of it (their name when you point at one on the world map), hostile mobs as red dots, peaceful mobs white, villagers and wandering traders yellow, your pets turquoise, boats, minecarts and items lavender, mobs of other mods by their kind. Those well above or below you are fainter, with a small arrow up or down. Settings > Radar, a new tab after Minimap: the radar, its range (2 to 16 chunks; in single player farther than the server sends mobs), the height arrows, mobs on servers, whether players are arrows or heads and mobs dots or the faces of the game's mobs in a frame of their kind's colour, every face as large (resource packs change them too; mobs of other mods stay dots), and where each kind shows (off, the minimap, both maps). A map shows the entities of the layer it shows: without cave layers only those on the surface; on the surface also those in caves up to two layers down, in layers mapped already; on a cave layer those up to two layers above or below it.
  • Fair play: on a server the radar shows only other players unless you allow mobs there, and nothing at all when the server forbids a radar with the code Xaero's Minimap reads.
  • Sable (1.21.1): its ships and other moving structures on the radar, drawn from their own blocks and turned as they sail, with a shadow and their name on the world map; a ship icon with an arrow of its course while they are too small on the map. Settings > Compatibility > Sable.
  • Vanilla Backport (1.21.1): the radar's mob faces for its creaking, copper golem (its eyes as it oxidizes), happy ghast and parched, and its warm and cold cows, pigs and chickens with the faces and colours of their own kind.
  • Tiny Takeover Backport (1.21.1): babies on the radar with the faces of its new baby models and their own colours, and grown rabbits in their new look; with Vanilla Backport too, its babies come first (the warm and cold calves, piglets and chicks in its colours).
  • Settings > Compatibility > Vanilla Backport > Mob faces and Tiny Takeover Backport > Baby faces, each shown with its mod.
  • Arrows at both ends of every scroll bar (the pin list and its search, the list of overlapping pins, the quick settings and the pin types on the world map, the settings, the plant list and long descriptions): a click scrolls a row, held it goes on scrolling; dim where the list cannot go further.
  • The map's quick settings: Cave map and View cone and glow, for the world map.

Changed

  • Actually Amazing Config Screen, the library of the settings screen, is no longer inside the mod's file: install it beside the mod, the file for the same game and loader (Prism Launcher, the Modrinth App and the CurseForge App offer it with the mod). A newer version of it then comes without waiting for this mod.
  • Settings > Pins: where each kind of pins and each path shows is a row of boxes instead of a slider in steps, one box for each picture on the card (the world map, the minimap, the marker, the beam or the stars); the beam only with the marker. The map's quick settings are the World map box of these rows.
  • Cave map and View cone and glow have a box for each map, the world map and the minimap.
  • The arrows of the plant list and of the sub-sections of Compatibility are white, gold under the pointer and while open.

1.3.2 - 2026-11-12

Fixed

  • A file of pins that cannot be read (cut short or broken by another program) is no longer replaced by an empty list with the next change: it is kept beside it as markers.json.broken.
  • A region of the explored map whose files cannot be read is no longer saved over as empty land: its files are kept beside it with the ending .broken, and the land is mapped again as you pass it.
  • Closing the game straight from a world saves the map and the pins like leaving the world does (up to a minute of explored land could be lost).
  • Which blocks count as plants on the map follows the world you are in: it was worked out once, from the first world opened in a game.
  • Settings are saved also on a drive that cannot replace a file in one step (some network drives), with Actually Amazing Config Screen 1.3.2 inside.

1.3.1 - 2026-11-11

Changed

  • On Minecraft 1.21.1 the world map and the minimap draw their pins, frames and buttons with fewer calls to the graphics card: shapes of one kind in a row now go as one, with the same pixels as before, so an open world map costs a little less (26.x groups them by itself).

Fixed

  • Small stutters: the map saved every minute while exploring is now written a couple of regions at a time instead of all in one frame (3 to 9 ms for 36 regions, more with more; now at most 0.3 ms a frame); a far path to a tracked pin is smoothed and laid out in small parts like its search (up to 3.7 ms in one frame before); turning Far land on stalls one frame less, as its table of answers (16 MB) is now made by its own thread.
  • The sparkles of the path behind you or far out of view are no longer built every frame, and land newly put on the map (and the far land filling it) is laid in with less work.
  • The far zoom of the world map and the minimap (1/8 and farther) no longer redraws a whole region's small copy every time one chunk of it changes, only that chunk's part: while mapping new land with the map zoomed out this took up to 0.6 ms a frame.
  • Map regions open at once while the map is being saved: reading a region no longer waits in one line behind the writes (a region asked for during a big save came late).
  • With Map edges at "No animation", a region whose chunks changed gets its edge laid again only around those chunks, not over the whole region.
  • A region file that another program holds for a moment (an antivirus, a backup) is written on the next tries instead of being left unsaved until the next save.

1.3.0 - 2026-11-09

Changed

  • Settings > Experimental > Map edges is now a slider: Off, No animation, Animated, Animated + waves. Animated, the edge of the explored map on the world map moves as in Genshin's map: it slowly swells out into the Fog of War in places and draws back, like water spreading and gathering. With waves, thin waves also run out from it into the fog and fade, and its glow swells and ebbs like the surf. Animated, the line is also smooth at every zoom, without the steps of the blocks when you zoom in close; No animation keeps the edge of 1.2.0, baked into the map a pixel a block. The minimap keeps the line still. With VulkanMod the edge stays still as before. The animated edge, its glow and waves run on across the borders of map regions without a step (found and fixed by MelonCode, thank you!).
  • Settings: System > Minimap update rate is a slider in steps (10, 20, 30, 60 redraws a second, then no limit), Minimap > Look > Opacity reads in percent, and Minimap > Extra information > Clock is a choice with arrows (Off, Game, Real, Both). A few rows moved where they belong: Minimap shape to the top of Minimap > Look, Route to the top of Pins > Path to the target (it holds for every kind of pin below it), Cave map to the top of Map > What the map shows.
  • The settings screen comes from Actually Amazing Config Screen 1.3.0 (packed inside the mod, nothing to install).

Fixed

  • Map edges: in a corner of explored land around a map region where nothing is explored yet, the line and its glow no longer break off straight along that region's borders: the part of the edge that reaches into it is drawn there too.

1.2.0 - 2026-11-08

Added

  • Settings > Experimental: a new tab for what is still being tried, may change, cost more or work another way later. Far land, Map edges and World border are there; the map's quick settings get such a setting only once its feature is out in full. The settings tabs no longer fit in the window, so they scroll: an arrow at each end of the row moves them a tab at a time, the mouse wheel over them too.
  • Explored map from Xaero: the window says about how long the import of the chosen folders takes, and while it runs, about how long is left besides the region count.
  • Settings > Experimental > Far land (single player, off by default, as it gives away what you have not found yet): the outline of the land you have not explored shows faintly under the Fog of War on the world map and the minimap, with a brighter line along the coast. It is worked out from the world's generator, no chunk is made, as far as the map shows, up to the world border: the same outline at every zoom, its coast in steps of a few blocks, worked out in detail only along the coasts. Mods that change the land through the game's generator are seen too. Lakes and rivers show; what the world adds later (streams from springs, villages, ice on the water) does not. While the map is closed it is worked out in the background, 2048 blocks around you, farther for the farther zooms.
  • Settings > Experimental > Map edges (off by default): instead of the steps of the chunks the explored map ends on a round, hand-drawn line with a thin turquoise outline and a soft glow into the Fog of War, on the world map at every zoom and on the minimap. It runs up to 30 blocks inside what you explored, and strips narrower than about 5 chunks fade away with it. Nothing changes in the saved map: switched off, everything is back at once.
  • Settings > Experimental > World border (off by default): the world border shows as a rough red line on both maps, over the Fog of War too, and all beyond it is darker. It keeps its width at every zoom and moves with the border, also on a server.

Changed

  • Settings > Compatibility > Xaero's Map: the Import link is white like the other texts (grey, it looked switched off).
  • The settings screen comes from Actually Amazing Config Screen 1.2.0 (packed inside the mod, nothing to install).

1.1.0 - 2026-11-06

Added

  • Settings > Compatibility > Xaero's Map: "Explored map from Xaero" brings the land you explored with Xaero's World Map onto this map: the Overworld's surface, so it does not have to be explored again (its caves, The Nether and the other dimensions are mapped as you go). Its window lists Xaero's map folders of this world with a switch each (the same server under another address, say); places already on this map stay as they are.
  • World map: everything on it now slides out as smoothly as it slides in. Side panels go back over the right edge; a new panel comes in over the one open, and a pin opened from the pin list slides off it again. The buttons and texts around the map leave over the nearest edge while a panel is open, those on the right also while the list of overlapping pins is. That list, the right-click menu, the layer buttons, the import choice and the export message slide too, and the map dims and clears with the panel.
  • World map: opening and closing it, the map dissolves into the game and back while its buttons slide in or out. Pressing the map key while it closes brings it back from where it is (on 1.21.1 under VulkanMod the map itself comes and goes at once).

Changed

  • The settings screen comes from Actually Amazing Config Screen 1.1.0 (packed inside the mod, nothing to install).
  • World map: like the settings screen, it is never larger than GUI 3 at 1080p (4 at 1440p, 6 at 2160p), whatever the GUI Scale of the game.
  • Settings > Compatibility: the sub-section of Xaero's mods is named "Xaero's Map", and its preview shows only the description of the setting under the pointer (no count of waypoints).
  • Settings: the preview card no longer repeats the setting's current value in a line under the picture, and the Cave map preview has no line under it either.
  • Settings > Minimap > Look: the preview is drawn as if the minimap's Size were 110, so it stays sharp.
  • Russian: The End is called «Край» everywhere on the map (it was «Энд» in the list of dimensions).

Fixed

  • Map: land mapped just before coming straight back to the same dimension could be lost, when a region still being saved was started anew and written over the saved one.
  • Entering a dimension or a new cave layer no longer holds up a frame while the map's folder is read.
  • A little memory was lost for good when a dimension was left while its map regions were loading.
  • "Explored chunks" could stay too low after a world was left, when the last regions had only been unloaded.
  • A chunk unloaded at the moment it was mapped could be listed under the wrong biome in the map search.

1.0.0 - 2026-11-03

The first stable release, for Minecraft 1.21.1, 26.1.2, 26.2 and 26.3 on Fabric and NeoForge.

Changed

  • The settings screen comes from Actually Amazing Config Screen 1.0.0, its first stable version (packed inside the mod, nothing to install).

0.9.0-beta.5 - 2026-11-03

A beta for every game: Minecraft 1.21.1, 26.1.2, 26.2 and 26.3. Please try it and report what you find.

Added

  • The quick settings of the world map have a section "Waystones" when the mod is in the game: "Show stones" and "Path to stones".

Changed

  • "Path to the target" in the quick settings of the world map is for custom and system pins; the stones of Waystones have their own switch.
  • The quick settings of the world map scroll when their rows do not fit above the All settings button (GUI 4 with Waystones), with a scroll bar like the pin list.
  • Settings > Compatibility: The Sift is named "The Sift" and sorted by name with the other mods (Minecraft stays first).

Removed

  • The switches Waystones, Sharestones, Warp Plates and Not activated in Settings > Compatibility > Waystones: every stone shows, the ones not activated yet in grey; "Show stones" decides where.

Fixed

  • Waystones: a tracked stone not activated yet stays grey on the minimap and in the world, as on the world map.

0.9.0-beta.4 - 2026-11-03

A beta for every game: Minecraft 1.21.1, 26.1.2, 26.2 and 26.3. Please try it and report what you find.

Changed

  • The mod list shows the earlier mod icon again, a much smaller file (the download is lighter).

Fixed

  • The rounded interface: a lighter line no longer runs down the middle of the scroll bars (the settings and the lists of the world map).
  • VulkanMod: a thin dark line across the world map at zoom 1 along a region border (seen while the map flew to a far pin).

0.9.0-beta.3 - 2026-11-02

A beta for every game: Minecraft 1.21.1, 26.1.2, 26.2 and 26.3. Please try it and report what you find.

Changed

  • Minecraft 26.1.2, 26.2 and 26.3: the settings screen comes from Actually Amazing Config Screen too, as on 1.21.1 since 0.9.0-beta.1 (the reset icon, other mods in Settings > Compatibility, the new mod icon).

0.9.0-beta.2 - 2026-11-02

A beta for Minecraft 1.21.1 only, as 0.9.0-beta.1.

Fixed

  • NeoForge: the game did not start with 0.9.0-beta.1. It asked for a version of the settings library newer than the one packed inside the mod.

0.9.0-beta.1 - 2026-11-02

A beta for Minecraft 1.21.1 only: please try it and report what you find. Minecraft 26.1.2, 26.2 and 26.3 stay on 0.8.0 until the settings library comes there too.

Added

  • Settings: a small reset icon beside a setting you changed, shown while you point at it; a click puts its default back.
  • Other mods can add their own part to Settings > Compatibility.

Changed

  • A new mod icon in the mod list.
  • The settings screen comes from Actually Amazing Config Screen, a library of the same author packed inside the mod (nothing to install). It looks and works as before, and the settings file stays the same.

0.8.0 - 2026-10-31

Added

  • Waystones support: the waystones, sharestones and warp plates you have activated show on the world map and the minimap with their names, like the teleport waypoints of Genshin Impact. Stones you have seen in the world but not activated yet show grey until you use them. A waystone a structure placed in a dungeon shows as a dungeon. Every stone can be tracked, with its path and beam, and found by name in the pin list. Teleporting stays with Waystones and its own rules. All their settings are in Compatibility > Waystones, shown only with Waystones in the game: which stones show, and where they and the path to them show (the map, the minimap, the marker, the beam, the stars). The stones are the interactive pins now.
  • Sodium Extra support: when its FPS counter (or its coordinates) is shown in the same corner as the minimap, the minimap moves clear of it, down from a top corner and up from a bottom one.

Changed

  • The settings preview shows its pictures at the same place for every setting, right under a description of at most three lines; the longest descriptions (the route, plants, the pin and path rows and a few more) are shorter.
  • The previews of the pin and path settings show every pin: the kind pointed at in white, the others grey. The route and terrain detail pictures stand one under another across the card, the choices not taken darkened.
  • The preview of the cave map setting is a picture now: on, a mapped cave with the layer buttons beside it as the world map shows them; off, the map around you alone.
  • The Plants setting has a preview too: the map around you, where plants switched on or off in their list appear or go a moment later.
  • With both clocks on, the real time is always on a line of its own under the game time; it went beside it when the two fitted the minimap's width, so changing the line spacing moved it from line to line.
  • The pin panel shows a pin's coordinates without the name of the dimension (always the one on the map).
  • The arrows of the minimap's Position go round the screen clockwise: top left, top right, bottom right, bottom left.
  • The settings screen is never larger than GUI scale 3 is at 1080p: at GUI 4 on a 1080p screen it looks as at GUI 3, with its preview beside it, and on a 1440p screen GUI 5 to 8 show it as GUI 4. Smaller scales are unchanged.

Removed

  • The interactive pin types sign, party and structure, and the Interactive section of the pin editor (its custom types are now one grid without a heading): their place went to the stones of Waystones. Pins of these types are removed from your maps and left out of imported files.

Fixed

  • In the settings, the sliders of where pins show ended a little short of the sliders of the path; all now end at the same place.
  • The minimap's Line spacing at 0 still left room: the first line kept a fixed gap below the map, and with see-through backgrounds the invisible pills kept the lines apart. At 0 the lines now sit right under the map and right under each other.
  • With plants off (or sea grass and kelp switched off in their list), the sea floor under them showed as dots of sand in the water; those spots stay water now. Places already mapped change when you pass by again.
  • A click on the zoom slider of the world map moved its handle there at once; it now glides there with the map.

0.7.0 - 2026-10-30

Added

  • Minecraft 26.2 and 26.3: Teyvat Cartographia now also comes for both, on Fabric and NeoForge, with everything the 26.1.2 version has (+mc26.2-fabric, +mc26.2-neoforge, +mc26.3-fabric, +mc26.3-neoforge). Like 26.1.2 they need Java 25. 26.2 works with VulkanMod, 26.3 with its own Vulkan renderer too.

Changed

  • Minecraft 1.21.1 gets version 0.7.0 too (+mc1.21.1-fabric, +mc1.21.1-neoforge), the same mod as 0.6.0.

Fixed

  • Minecraft 26.1.2 on Fabric with VulkanMod 0.6.9 or newer: the minimap and the mod's menus are no longer drawn upside down.

0.6.0 - 2026-10-30

Added

  • Minecraft 26.1.2: Teyvat Cartographia now also comes for Minecraft 26.1.2, on Fabric and NeoForge, with everything the 1.21.1 version has (+mc26.1.2-fabric, +mc26.1.2-neoforge). It needs Java 25, as the game does.

Changed

  • Minecraft 1.21.1 gets version 0.6.0 too (+mc1.21.1-fabric, +mc1.21.1-neoforge), the same mod as 0.5.1: from now on every version comes for both games under one number.

0.5.1 - 2026-10-30

Changed

  • The list of plants in the settings shows each plant's colour on the map instead of its item.

Fixed

  • Fabric with VulkanMod: the minimap, the settings lists, the zoom bar of the world map and the distance under the in-world marker were drawn upside down, and the menus had no blurred background.

0.5.0 - 2026-10-27

Added

  • Fabric: Teyvat Cartographia now also comes for Fabric (Fabric Loader and Fabric API for Minecraft 1.21.1), with everything the NeoForge version has. Mod Menu shows its settings button. Each version comes as two files of the same mod: +mc1.21.1-fabric and +mc1.21.1-neoforge. The Fabric file also runs on NeoForge through Sinytra Connector with Forgified Fabric API (Connector Extras adds the settings button to NeoForge's mod list).
  • A third choice of the Route setting (Pins > Path to the target): By air, a straight line to the tracked pin whatever lies between, for flying with elytra or aircraft. The pulse key away from the line draws it again from where you are. The line is near white (dark grey over unexplored land), with a cloud on it ahead of you. The choices are now named By land, By water and By air.

Changed

  • The settings are kept in config/teyvatcartographia-client.json, on both loaders. The settings of earlier versions (teyvatcartographia-client.toml) are taken over the first time the game starts with this version.
  • Pins show on the world map and the minimap at every zoom, 1/16 and 1/32 too: a pin made there no longer vanishes at once. Biome names and the region grid still start at 1/8.
  • Where the settings have no room for the preview beside them (GUI 4 at 1080p), pointing at a setting shows its description as a tooltip again, instead of the preview button; a description taller than the room scrolls.
  • Minimap > Extra information lists what the lines show first (coordinates, biome, clock, day counter), then their text size, background and spacing.
  • Clearer descriptions: the quick settings of the world map have their own, and the minimap's switch, zoom, size and opacity say more.

Fixed

  • The beam of light over a tracked pin far away (about 2000 blocks and more) no longer ends in a hard cut at its top: it fades out smoothly at any distance, and looking up at it does not clip it. Beyond 320 blocks the beam now grows with the distance, so it stays tall on the screen however far the pin is. Found and fixed by MelonCode, thank you!

0.4.0 - 2026-10-26

Added

  • A Route setting (Pins > Path to the target): On land, the path walks round deep water; Across water, it goes by boat across lakes and seas of any width. Sitting in a boat, the path goes by water either way.
  • The path over deep water is drawn in the colour of the sea, with a sea icon where each longer crossing begins; pointing at the icon on the world map tells that the way goes on over water.
  • The path line is drawn in from you to the pin over 3 seconds when you start tracking or the path is searched again (the pulse key away from the line); the line shown before is wiped the same way at the same time. On the world map, the minimap and the sparkles in the world.

Changed

  • The beam of light, the pulse, the sparkles, the path lines and the pointers of the tracked pin are golden for every kind of pin, like the path stars of Genshin Impact (they were orange, mint or violet by the kind of pin). The beam stays golden on a bright sky too (it turned almost white on blue).
  • The sparkles of the path show up to 64 blocks away (32 before) and look like Genshin Impact's path stars: about a third are large four-pointed sparkles with a light core, the rest small glowing motes. The preview in the settings shows the new sparkles and the golden beam too.
  • The path to a pin swims across narrow water (up to 16 blocks) instead of walking all the way round it, and wades through shallow water as if it were land.
  • The path through unexplored land is grey (it was near white).
  • A pin that cannot be walked to (on an island, across a wide river) no longer has its path end on a shore: the path walks to the shore nearest the pin and swims the rest of the way.
  • The tooltip of a cave layer under the surface names its heights from the top down ("Height 63 to 48"), the way the layers go from the surface; the layers above it still count upwards ("Height 64 to 79").
  • The cave layer buttons have their stacked layers icon back (since 0.2.0 they showed two squares).

Fixed

  • The cave mode came on inside houses of several floors: any 4 solid blocks above the head counted, floors, roof, shelves and barrels too, and the map showed a cave layer instead of the surface. Now only natural ground counts (stone, dirt, sand, gravel, ores and the like), 4 blocks in a row.
  • On the minimap the path line stopped short of the edge by a different distance each time. It now ends exactly where the tracked pin waits when it is off the map, nearer the frame than before, on the square and the round minimap; the letters N, E, S and W sit at the same distance from the edge. With a wide faded edge (Fade width) both stay where the map is still half seen.
  • The beam of light over the tracked pin vanished at once when you turned away and the marker went to the edge of the screen. Now it dims as the marker nears the edge and fades out over a second after that, and fades back in over a second when you turn back.
  • With the Fabulous graphics the path stars over water sank under it and took the colour of the water, and the beam of light stopped short above the ground behind water and land. Both now look as with the other graphics settings.
  • With VulkanMod the lists in the settings and on the world map had black bands at their top and bottom edges. The rows now dissolve there as with the other renderers, and the background blur under the menus works too.
  • With VulkanMod the zoomed-out world map and minimap showed thin lines along every region border (every 256 blocks), at 1/8 with a large GUI scale or at 1/4. They are gone.

0.3.0 - 2026-10-25

Added

  • The world map shows its zoom ("1/4", "1", "8") beside the thumb of its zoom slider.
  • Lists glide when they scroll, like the map's zoom, with no steps: the settings, the plant list, the pin list, the list of overlapping pins on the map and the pin editor's types. The wheel and the scrollbar move them freely (they stopped at the top of a row before), and their rows dissolve softly at the top and bottom edges while more of the list lies beyond them.

Changed

  • Zoom goes from 1/32 to 32, each step twice the one before, on the world map, the minimap (also with its keys) and in the settings; 1/3 and 3 are gone (a saved 3 becomes 4, 1/3 becomes 1/4).
  • Pins, biome names and the region grid show at every zoom down to 1/8; only at 1/16 and 1/32 the map shows the land alone (the tracked pin stays). Pins showed from 1 before, biome names from 1/4 to 4.
  • The beam of light and the above / below arrow of the tracked pin show at any distance (they stopped at 225 blocks). The beam fades in over a second when the pin comes onto the screen and out over a second when it goes to the edge (it faded by its way to the edge before).
  • The settings scrollbar runs along the list exactly, and the list fills its room down to the buttons: scrolled to the end, the last setting sits on the bottom edge (up to a row was left empty below it).

Fixed

  • Dark lines along chunk borders on water (and in grass and leaf colours) behind a player who was moving, flying or sailing: a chunk mapped while its neighbour was being unloaded took that neighbour's colour from the default biome.

0.2.0 - 2026-10-24

Added

  • Right-click menu on the world map: on empty ground New pin and, for operators (permission level 2, or cheats in singleplayer), Teleport, in any dimension the map shows and onto unexplored ground too (the server finds the top block there); on a pin Edit (Open for the spawn and death points) and Track or Stop tracking.
  • Settings > Minimap > Minimap shape (Square or Round) and Settings > Map > Interface style (Rectangular or Rounded), independent of each other. Both start square, as before.
  • Plants on the map, like on Xaero's Minimap: Settings > Map > Plants opens the list of every plant of the game and your mods, with a search field and a switch for each. All are on at first, also those of mods added later. A solid plant switched off (a cactus) shows the ground under it. Plants is also among the quick settings of the world map (the gear).
  • Settings > Map > View cone and glow: off, the player arrow is drawn alone on the world map and the minimap.
  • A live Preview beside the settings shows the setting you point at: its name and what it does, then pictures that change as you change it (the map around you, the minimap, a pin on both maps and in the world, the mapping speed, samples of each fog). On a small screen or a large interface a button in the header says to lower the GUI scale.
  • A Colours section in Settings > Map: Terrain detail (flat colours, shaded slopes, or slopes with contour lines), Deep water shading (how much deep water darkens) and Clear shallow water (how much of the ground shows through shallow water; off at first).
  • Minimap Look: Inner padding (a gap between the frame and the map), Edge fade width and Edge fade strength. Extra information: Line spacing, Text size (Auto, or a whole number of pixels so the pixel font stays sharp), Background opacity of the lines, Time format (24-hour, 12-hour, 12-hour with AM/PM) and a Day counter ("Day 12 · 14:35").
  • The clock can show Both game and real time; the real time is marked "IRL".
  • When the minimap turns with the camera, it shows E, S and W too, fainter than N.
  • Pins have a fifth step, In the world: the marker over a tracked pin with its distance, now with a way to switch it off (Settings > Pins: Off, Map, Both maps, In the world, Everywhere).
  • Path to the target in the quick settings of the world map: the path on the world map for every kind of pin at once.
  • A Compatibility tab: first Minecraft with Fog of War: The Nether and Fog of War: The End, then a part for each supported mod in the game: The Aether (its Fog of War), The Sift (its Fog of War, Rainbow ichor, Ichor snow) and Xaero's Minimap (the import options).
  • A Fog of War of its own in The Nether (smoke and glowing embers), The End (a void with a violet nebula and stars, the islands casting a shadow on it), The Aether (a sea of clouds under the islands) and The Sift (a pearly haze in the colours of its ichor), on the world map and the minimap.
  • The Sift's rainbow ichor and its snow shimmer on the map as they do in the world.
  • The world map and the settings have a mouse pointer of their own in the theme's colours: a hand over buttons and pins, a text cursor in text fields, a move cross while dragging the map, arrows on sliders. It is a system cursor, so it never lags.
  • For theme makers: dimensions/<namespace>/<path>.json paints one dimension's blocks in colours of its own, and a fog's .json may set its "repeat".

Changed

  • Map colours: every block is drawn in the colour of its texture, like Xaero's Minimap (the average of its top face, with the biome tint of grass, leaves and water), in every dimension and for the blocks of any mod. Blocks that their own colour handler tints (lily pads, stems, leaf litter, mod leaves and grass) take the colour it gives at their place. Read again when resource packs change.
  • The map of earlier versions is reset once: drawn in the old colours, it left chunk-shaped patches beside the newly mapped land, so the world is mapped again as you explore. Pins are kept.
  • The settings are in five tabs, each about one thing: Map, Minimap, Pins, System and Compatibility, with a scrollbar you can drag. The settings have no hover tooltips any more: the preview shows what a setting does.
  • The Clock, each kind of pins and the path to each kind are one slider in steps instead of a switch with sub-settings. Older settings files keep working.
  • Interactive pins are for every player, like the custom ones: anyone creates, edits and deletes them.
  • Up to 300 pins per world (was 100).
  • A left click on empty ground of the world map no longer creates a pin (use the right-click menu); a left click on a pin still opens it. The quick pin key (B) opens the world map with the new pin editor where you stand.
  • A pin opened from the pin list goes back to the list when you close it, with your search and scroll as they were.
  • The interactive pins are Sign, Party and Structure (they were Waypoint, Statue and Domain), the custom pins are named by what they show (Demon, Quest, Star, Meat, Flower, Pickaxe, Hook). Pins saved or exported by earlier versions keep working.
  • Every icon but the player arrow now comes from Nieobie's Game Icon Pack, and all pins look the same size (scaled by their visual weight). The dimensions panel has a globe icon.
  • For theme makers: the built-in theme is called Default (it was Minecraft); theme.json has just a name. Some icon files are renamed after the pins: boss, food, clover, statue, domain, waypoint and grave are demon, meat, flower, party, structure, sign and death; new are earth, keyboard, reset, view, new_pin, and the mouse pointers in cursors/.
  • The Rectangular style is flat: no vanilla-style frame and bevel on panels, buttons, fields and sliders.
  • The Fog of War is redrawn after the map fog of Genshin Impact: soft slow wisps and glowing motes, repeating every 512 GUI units (was 440).
  • In a bottom corner the lines over the minimap are mirrored: the coordinates nearest to the map.
  • The minimap Size slider goes only as far as the minimap fits the screen at your GUI scale.
  • The zoom slider of the world map eases to the new scale like the mouse wheel does.
  • The beam of light fades out as the marker nears the edge of its limiter ellipse instead of vanishing at once.
  • The Aether has no cave layers (the space under its floating islands read as caves).
  • Without Xaero's Minimap and its waypoints, Import in the pin list opens the file dialog at once.
  • The names of other mods' dimensions read as titles: "The Aether", not "The aether".
  • New defaults for new players and after Reset: the minimap 4 units from the screen corner (was 8), opacity 0.85 (was 0.95), edge fade width 15% (was 20%), line spacing 0 (was 4), no background behind the lines (was 70%), the day counter on, every plant on; New pin where you stand on B and Stop tracking on Z (they had no key). Settings and keys you already changed stay as they are.
  • The JAR is 15% smaller (the fog images compressed better, the same pixels).

Removed

  • The server side: the mod is client side only again. The interactive pins that operators shared through a server since 0.1.1 are no longer shared. In singleplayer they become your own pins the first time you open the world; on a dedicated server they stay in its save (data/teyvatcartographia_pins.dat).
  • The built-in Genshin Impact resource pack: its theme differed from the default one only by its round shapes, which are now settings. Players who had it get the Default theme with square shapes; pick Round and Rounded to get the old look back.
  • The Teleport button on pins and the confirmation before deleting an interactive pin.

Fixed

  • The path to a pin on an island within about 128 blocks went round the lake to the nearest shore, then jumped back across the water and went round once more. It now stops on that shore.
  • Thin dark lines along chunk borders after the land changed there (a forest cut down, ground levelled).
  • Dark lines in steps along chunk borders, mostly on water, where the edge of the loaded area had passed.
  • Water, grass and leaf colours changed in a sharp straight line where two biomes met on a chunk border.
  • Plants on the map: double plants (rose bush, peony, lilac, sunflower, tall grass, pitcher plant, small dripleaf) showed their stem instead of their top; crops showed their first stage whatever their age (ripe wheat was green); every kind of leaves was 14% too dark; mangrove leaves did not take the biome's colour; many plants of other mods (flowers, shrubs, branches and leaf litter of Regions Unexplored, The Sift's sculkflower) were not drawn at all.
  • Cherry grove crowns were left off the map at first (the game counts cherry and flowering azalea leaves among its flowers) and were beige when shown (the game leaves them pink).
  • Right after joining a world the minimap's biome line could stay on Plains while you stood still.

[0.1.3] - 2026-10-24 [YANKED]

Withdrawn the day it came out: its changes, with the fixes found right after, are in 0.2.0.

0.1.2 - 2026-10-21

Added

  • Map search: the pin list has a search field (click it, or press Ctrl+F on the world map). It finds pins of every dimension and the explored biomes by name. A click on a pin flies the map to it and opens it; a click on a biome flies to its nearest explored place, and each further click to the next one ("Place 2 of 5"). Enter opens the first result, Esc leaves the field.
  • The first search in a world reads the explored map in the background once (about 1 second per 1000 map regions) and keeps a small index next to the map, so later searches are instant.
  • An interactive pin only you have (on a server without the mod) says "local" in the pin list.
  • Deleting an interactive pin asks first, in a popup beside the pin panel.

Changed

  • Rows of the pin list: the name uses the whole first line, the coordinates and the distance share the second.
  • The pin panel leaves the dimension out of the coordinates line when it does not fit.
  • Side panels are never narrower than 176 units, so the buttons and Russian labels fit at small GUI scales.
  • The JAR file name has a "v" before the version: teyvatcartographia-v0.1.2+mc1.21.1-neoforge.jar.

Fixed

  • Flying or in a boat over deep water, the path to the target was missing; it now leads out across the water to the shore.
  • The pin editor's type grid scrolls with the mouse wheel when it does not fit, and opens at the selected type.
  • A small minimap in a right corner pushed its coordinates off the screen.
  • A minimap too large for the screen with its lines is drawn smaller to fit; the size setting keeps its value.
  • After a teleport the minimap's biome line could show Plains until you moved.

0.1.1 - 2026-10-20

Added

  • Shared interactive pins (optional server side): with the mod on a NeoForge server (or in singleplayer or LAN), the interactive pins operators place are shared with every player who has the mod. Up to 200 shared pins per world, apart from each player's own 100. Both sides stay optional.
  • Export and import at the bottom of the pin list: save every pin of the world to a .json file, add the pins of such a file (or of another world's markers.json); repeats are skipped.
  • Import from Xaero's Minimap: the waypoints of the current world are found on their own, otherwise you pick a waypoint file of the Xaero world. Death points are left out; waypoints become star pins.

0.1.0 - 2026-10-19

The first public release, for Minecraft 1.21.1 on NeoForge 21.1. Client only.

Added

  • World map of the world you have explored, drawn from loaded chunks: relief shading, contour lines, water depth, a Fog of War over unexplored land, darker at night with lit places keeping their colour. Zoom from 1/16 to 16 towards the cursor, chunk grid, biome labels, coordinates, explored chunk counter, separate maps per world or server and per dimension, The Nether mapped below its roof.
  • Cave layers: caves around you are mapped in layers 16 blocks high while you are underground; the minimap and the world map switch to your layer, and a layer field on the world map shows the others.
  • Minimap, square or round, north up or turning with the view, with coordinates, biome and a clock under it.
  • Pins: custom pins for everyone, interactive pins for operators, the world spawn and the last death; up to 100 per world, a list sorted by distance.
  • Tracking like a Genshin Impact waypoint: the pin in the 3D world with its distance and a beam of light, a pulse key (V), and a walking path round water, lava, trees and mountains, drawn on the maps and as stars in the world.
  • Quick switches on the map and a full settings screen; the Minecraft theme by default, a Genshin Impact theme as a built-in resource pack, more themes through resource packs.
  • English and Russian translations.
  • Cached HUD layers, chunk work on worker threads and path searches in short slices: the mod is meant to cost at most 2 to 3% FPS.

This mod has no additional files