Skip to content

Contributing

Gjum edited this page Feb 26, 2017 · 3 revisions

How to contribute claims

How to contribute VoxelMap data

Note that this will contain only the terrain data, and no waypoints.

  • Windows: go to %appdata%.minecraft\mods\VoxelMods\voxelMap\cache
  • Mac: go to ~/Library/Application Support/minecraft/mods/VoxelMods/voxelMap/cache

Then create a .7z, .zip, or .rar archive with the play.devoted.com directory (or whatever address you use to connect to the server, also just sending the play.devoted.com\world directory is enough), upload it to a file hosting service of your choice (people seem to like PixelDrain), and send the link to /u/Gjum on Reddit.

Latest combined cache

Download 7Zip 2017-02-25

When you use this, please make sure the timestamps on the x,z.zip files are set correctly, or I won't be able to take your data. If they are all a bit in the past, and not all the same (i.e. the time you unpacked them), you're good.

Why VoxelMap?

VoxelMap caches the visited, but not loaded parts of the worlds in a way that is very useful for drawing custom maps. VoxelMap stores per x/z coordinate up to four kinds of blocks, the height, and both light levels, and generates the map images on the fly, making it possible to change any settings after you visited a region.

Because VoxelMap stores the rendered blocks, and not just images, it is possible to combine multiple caches into one, even if there are conflicts between them. For example: a new contribution contains old data for a region, but the current main cache has more recent data, so we use the more recent data instead of overwriting it with the older data.

Why not JourneyMap? JourneyMap only saves the generated PNGs, and only for the preconfigured modes. While it is possible to combine the rendered images of VoxelMap and JourneyMap, it makes it very difficult to update the map later with more recent data.

Why not Mapwriter? Mapwriter actually has an even better cache format than VoxelMap (if it's enabled in the settings), and I'll gladly take that data. At the moment, I cannot make use of it though, because I simply haven't written the code to combine contributed caches, but I will probably do that some time.

Why not Xaero/...? If you have considerable amounts of new map data in any format, I'll gladly take a look at it and try including it. However, many formats are not documented anywhere and thus are more difficult to use properly if at all.

Clone this wiki locally