Welcome to the AMIDST wiki! This is a collection of various documents to aid in the usage of the "Advanced Minecraft Interface and Data/Structure Tracking" program - aka AMIDST.
AMIDST is meant to be a FAST Minecraft mapper of existing MineCraft worlds and, if given a seed and certain other parameters, will produce a 2D map equal to what the MineCraft world generator would produce with the same information, albeit MineCraft is much, much slower.
Although AMIDST does not modify or add to any Minecraft folders or files, it is NOT a stand-alone program. You must have the Minecraft software stored on the machine you are running AMIDST on. You must have made a profile for the version of Minecraft you wish to use AMIDST with AND you must have run Minecraft with that profile at least once to insure that the Minecraft launcher has downloaded the run time files for that version to your machine so that they are available to AMIDST.
AMIDST uses many of the procedures that exist in the java code of the MineCraft main program that creates a new world. It ONLY uses the initial code that establishes the biomes, their shapes, and the PROBABLE positions of surface structures and the X,Z coordinates of the three strongholds. ie a 2D representation of the world that the seed entered would produce. At the point that AMIDST gets what it needs to produce a fast 2D map of the MineCraft world that a seed will produce no permanent decisions have been made with regard to the actual existence of the surface structures. This is why sometimes AMIDST indicates a structure location and when the world is actually generated by the MineCraft world generator the structures will not exist. This seems to occur about 10 to 20 percent of the time. Since all MineCraft worlds have three strongholds positioned in a triangle around coordinates 0,0 and they are underground and not dependent upon surface terrain, the AMIDST coordinates for these complexes are fairly accurate. The positions shown are for the stronghold complex NOT the portal room in that complex.
Table of contents
A lot of questions pop up over and over, this section is here to answer some of the common ones.
Many people have asked why AMIDST doesn't show the locations of dungeons.
The positions of dungeons are decided upon much later in the world generation process than the point at which AMIDST gets all the information it needs to produce a 2D map. Going any farther would slow down AMIDST immensely and also even though the dungeon locations are predictable from the world seed, even the MineCraft world generator software doesn't map them until the actual chunks for the world that contain them are created and stored on disk. To ask AMIDST to locate dungeons would be to ask AMIDST to create the entire world which is something that even Minecraft doesn't do. MineCraft delays chunk creation until a player gets within a certain distance of the chunk in question.
Village/temple/witch hut/stronghold/spawn point is not where AMIDST says it is!
What color is the biome I'm looking for?
Some of the good AMIDST users have made a biome color legend. Note that in AMIDST 3.5 and onwards you will be able to define your own biome colors, e.g., to make one particular biome stand out more.
To avoid problems, be sure to specifically check the Minecraft profile you wish to use for AMIDST's biome map rendering. Don't use the "(Default)" profile.
Note that AMIDST does not read biome maps from saved worlds, what it does is produce a map of the world that would be created if a particular seed were entered to the version of Minecraft you have told Amidst to use. If you tell Amidst to load a seed from a world file or folder all it does is read the seed value stored in the level.dat file and then display the map of the world that seed will produce using the profile you chose when you started the program. If the world that you pointed Amidst at was created with a different world generator than the one in Amidst's current profile Amidst will not display the correct map. There is no way, currently, to establish what world generator was used to produce a given world. That information is not stored in level.dat. That being said, make sure that you strive to use the same profile for Amidst that was used to create the world with Minecraft.
AMIDST comes with absolutely no warranty. It is licensed under the GNU General Public License version 2, which basically means that you're free to make changes to the program and redistribute it, as long as your changes and redistribution is also licensed the same way.