Restoring VoxelMap

Waypoints

Long story short, you may not need to.

VoxelMap just shows all waypoints created in "unknown" worlds, as if MapModCompanion was never installed.

If you want to get rid of waypoints that appear in every world, you'll have to remove and create them again, or edit voxelmap/[server ip].points file manually.

Cache

Restoring VoxelMap map cache may be difficult depending on your luck and your skills.

Step 1

This is the trickiest part. Ask your server administrator what they see in their console (or server logs) when you log in.

Send them this article, so they make sure you're not trying to scam them :)

Here's what we're looking for:

[MapModCompanion] Sending world id to %your_name% (channel: %any%): WorldId.Numeric{id=1337}.

⚠️ Hint for the server administrator: If you're running your server behind BungeeCord, make sure you look for the world id in BungeeCord logs. This is because what you see in Spigot is likely just a intermediary value. Lines you're looking for should start like this: Intercepting world id sent to ...

See that id=1337? (1337 is just an example) This is the new ID that VoxelMap uses to identify worlds on the server. You should write it down probably, we'll need it later.

Step 2

Open Minecraft folder. If you're not sure, just Google it.

Step 3

Close Minecraft or quit to the main menu. VoxelMap doesn't allow changing their data while you're in-game.

Step 4

Open voxelmap folder that you'll see in your Minecraft folder.

If it's not there, then this is probably not the folder you're looking for. Head back to Step 2.

If it's there, open it and head to the cache folder, and then look for the folder that looks like an IP address of the server you're trying to restore data from (e.g. example.com).

You should see a small set of folders named something like overworld, the_nether, etc.

The overall folder structure may look like this:

voxelmap
├── cache
│   └── example.com
│       ├── 1337
│       │   └── overworld
│       │       ├── 0,0.zip
│       │       ├── 0,-1.zip
│       │       └── <...>
│       ├── overworld
│       │   ├── 0,0.zip
│       │   ├── 0,-1.zip
│       │   ├── <...>
│       ├── the_end
│       │   ├── 0,0.zip
│       │   ├── 0,-1.zip
│       │   └── <...>
│       └── the_nether
│           ├── 0,0.zip
│           ├── 0,-1.zip
│           └── <...>
└── <...>

voxelmap/cache/example.com is our server cache folder.

Step 5

Look for the folder whose ID is the same we've found in Step 1. In our example it was 1337, so what we're looking for is voxelmap/cache/example.com/1337 (actual folder name varies depending on what ID you got in the Step 1). If the folder isn't there, then you're probably never visited the updated server with VoxelMap on or got the wrong ID on the Step 1.

Ok, if the folder is there, then it's our target folder.

Copy all folders with names overworld, the_end, the_nether in the server cache folder to the target folder. You can safely say "No" when the system asks wherther to overwrite duplicate files, it's not going to break anything. Probably.

Now it should look like this (notice how overworld, the_end, the_nether appear twice):

voxelmap
├── cache
│   └── example.com
│       ├── 1337
│       │   ├── overworld
│       │   │   ├── 0,0.zip
│       │   │   ├── 0,-1.zip
│       │   │   └── <...>
│       │   ├── the_end
│       │   │   ├── 0,0.zip
│       │   │   ├── 0,-1.zip
│       │   │   └── <...>
│       │   └── the_nether
│       │       ├── 0,0.zip
│       │       ├── 0,-1.zip
│       │       └── <...>
│       ├── overworld
│       │   ├── 0,0.zip
│       │   ├── 0,-1.zip
│       │   └── <...>
│       ├── the_end
│       │   ├── 0,0.zip
│       │   ├── 0,-1.zip
│       │   └── <...>
│       └── the_nether
│           ├── 0,0.zip
│           ├── 0,-1.zip
│           └── <...>
└── <...>

Step 7

Open Minecraft, connect to the server and verify that the map cache is back. Good job! 🎉

If the server network consists of more than one server, you should repeat the steps all over again to get the whole map cache back... or, if you're smart enough, just make educated guesses and skip a couple steps 😊

Anyway, good job! 🎉🎉🎉