Recent changes to FAQ

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:05 -0000

--- v34
+++ v35
@@ -1,81 +1,7 @@
-
-
-**Table of Contents**
+The FAQ has been split into multiple pages:

-- [What is all the information in the window title?](#what-is-all-the-information-in-the-window-title)
-  - [What is the difference between the Minecraft version and launcher profile?](#what-is-the-difference-between-the-minecraft-version-and-launcher-profile)
-  - [What is the difference between the selected and the recognised Minecraft version?](#what-is-the-difference-between-the-selected-and-the-recognised-minecraft-version)
-  - [Why do you extract the recognised Minecraft version from the jar file?](#why-do-you-extract-the-recognised-minecraft-version-from-the-jar-file)
-- [How does Amidst work?](#how-does-amidst-work)
-  - [Which stages of the Minecraft world generator are used?](#which-stages-of-the-minecraft-world-generator-are-used)
-  - [Why are the structures displayed by Amidst incorrect?](#why-are-the-structures-displayed-by-amidst-incorrect)
-  - [Why does Amidst not display Dungeons?](#why-does-amidst-not-display-dungeons)
-- [What is the history of Amidst?](#what-is-the-history-of-amidst)
-
-
-
-
-
-## What is all the information in the window title?
-
-The window title contains the following information:
-
-* the Amidst version
-* the selected Minecraft launcher profile
-* the selected Minecraft version
-* the recognised Minecraft version
-
-### What is the difference between the Minecraft version and launcher profile?
-
-A Minecraft version is a specific version of the Minecraft game code.
-
-The Minecraft launcher allows you to create multiple profiles. You can choose a custom name for each profile and assign a Minecraft version that should be used for it. You can also specify a custom directory for the profile, that is used to store the save games.
-
-### What is the difference between the selected and the recognised Minecraft version?
-
-The selected Minecraft version is the Minecraft version associated with the selected launcher profile.
-
-The recognised Minecraft version depends on information that is taken from the actual Minecraft game code (the jar file).
-
-### Why do you extract the recognised Minecraft version from the jar file?
-
-We use the recognised version to determine which Amidst features should be activated, e.g. the used mineshaft algorithm. We do this, because it allows Amidst to be executed only from the jar file, without knowing the Minecraft version.
-
-However, the algorithm to extract the recognised Minecraft version from the Minecraft game code is not as good as it should be. This means, some actually different Minecraft versions are mapped to the same recognised Minecraft version. For example, the versions 1.8.9, 1.8.8, 1.8.7, 1.8.6, 1.8.5 and 1.8.4 are all mapped to the recognised Minecraft version 1.8.9. This means, we cannot enable or disable Amidst features for one of the given versions, but only for all of them.
-
-## How does Amidst work?
-
-Amidst uses the following steps to generate the map:
-
-1. First, a specific set of class files is identified in the given Minecraft jar file. It uses a heuristic to do this: While the name of the class files might change between Minecraft versions, there are some characteristics to uniquely identify the required classes.
-
-2. Once the correct classes are identified, Amidst uses Java's reflection mechanism to directly use the biome generator that is implemented in the Minecraft source code.
-
-3. Finally, the **probable** position of a given set of structures is calculated.
-
-### Which stages of the Minecraft world generator are used?
-
-The Minecraft world generator has several stages. Amidst uses only the stage which generates the rough shape of the biomes as a 2D map. However, there are more stages like the terrain generator, which is also used by the structure generator. Amidst does not use those additional stages to keep the rendering as quick as it is.
-
-### Why are the structures displayed by Amidst incorrect?
-
-This is a consequence of Amidst not using all stages of the Minecraft world generator, as described above. Thus, there are some structures displayed by Amidst which are not generated by Minecraft, called false positives with a probability of about 10% to 20%. There are also structures generated by Minecraft that are not displayed by Amidst, called false negatives with a probability of less than 1%. Making this more accurate would significantly slow down the rendering of the map.
-
-### Why does Amidst not display Dungeons?
-
-This is a consequence of Amidst being unable to generate the exact same structures as the Minecraft world generator, as described above. Especially, the Dungeon generator strongly depends on later stages of the Minecraft world generator. Thus, Amidst is unable to display correct Dungeon locations with a high probability. To prevent confusion, we made the decision to omit the Dungeons generator from Amidst.
-
-## What is the history of Amidst?
-
-Amidst was originally developed by Skidoodle aka skiphs. It started as a [Stronghold Finder](http://www.minecraftforum.net/forums/archive/forum-1-8-update-discussion/938993-easily-finding-strongholds). Later on, skiphs decided to add more features and to publish the source code using an open source license. First, it was published on [Bitbucket](https://bitbucket.org/skiphs/amidst), but later it was moved to [Github](https://github.com/skiphs/AMIDST). Also, a readily compiled version was provided and [a wiki](https://github.com/skiphs/AMIDST/wiki) as well as a [second minecraftforum thread](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-tools/1262200-v3-7-amidst-strongholds-village-biome-etc-finder) was created.
-
-There is also a statement by skiphs about [the history of Amidst](https://github.com/skiphs/AMIDST/issues/45#issuecomment-54536224). Basically, there have been four iterations:
-
-1. the Stronghold Finder
-2. small area of the map with coordinates
-3. infinite scrolling
-4. complete rewrite called Amidst
-
-After the development in the main repository slowed down, DrFrankenstone aka Treer started to maintain a fork, called [AmidstExporter](https://github.com/Treer/AmidstExporter). He added support for many new features.
-
-After a while, Amidst underwent a huge refactoring. The merging of the iteration three code with the iteration four code was finished, new features were added and many features of AmidstExporter were ported back to Amidst. During this process, Amidst was moved to this repository to enable easier collaboration of multiple developers.
+* [Using Amidst]
+* [Window Title]
+* [Behind the Scenes]
+* [History of Amidst]
+* [Supporting the Development]

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:04 -0000

--- v33
+++ v34
@@ -11,7 +11,6 @@
   - [Why are the structures displayed by Amidst incorrect?](#why-are-the-structures-displayed-by-amidst-incorrect)
   - [Why does Amidst not display Dungeons?](#why-does-amidst-not-display-dungeons)
 - [What is the history of Amidst?](#what-is-the-history-of-amidst)
-- [How can I get in contact?](#how-can-i-get-in-contact)

 

@@ -80,9 +79,3 @@
 After the development in the main repository slowed down, DrFrankenstone aka Treer started to maintain a fork, called [AmidstExporter](https://github.com/Treer/AmidstExporter). He added support for many new features.

 After a while, Amidst underwent a huge refactoring. The merging of the iteration three code with the iteration four code was finished, new features were added and many features of AmidstExporter were ported back to Amidst. During this process, Amidst was moved to this repository to enable easier collaboration of multiple developers.
-
-## How can I get in contact?
-
-Most of the time, one of the sections in [Supporting the Development](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development) will match your intent. If it does, please follow the instructions provided there. However, there are a few reasons to directly and privately contact the developers, for example to submit crash reports containing information that should not be published. If this matches your intent, here is the mail address of the project:
-
-toolbox4minecraft+amidst@gmail.com

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:04 -0000

--- v32
+++ v33
@@ -2,13 +2,6 @@
 
 **Table of Contents**

-- [Which Minecraft versions are supported?](#which-minecraft-versions-are-supported)
-  - [Can I use Amidst with the Windows 10, Xbox, Playstation or Pocket Edition of Minecraft?](#can-i-use-amidst-with-the-windows-10-xbox-playstation-or-pocket-edition-of-minecraft)
-  - [Can I use Amidst with a modded Minecraft version?](#can-i-use-amidst-with-a-modded-minecraft-version)
-- [How can I run Amidst?](#how-can-i-run-amidst)
-  - [Do I need to install Minecraft?](#do-i-need-to-install-minecraft)
-  - [What are the System Requirements?](#what-are-the-system-requirements)
-  - [So, how exactly can I run Amidst?](#so-how-exactly-can-i-run-amidst)
 - [What is all the information in the window title?](#what-is-all-the-information-in-the-window-title)
   - [What is the difference between the Minecraft version and launcher profile?](#what-is-the-difference-between-the-minecraft-version-and-launcher-profile)
   - [What is the difference between the selected and the recognised Minecraft version?](#what-is-the-difference-between-the-selected-and-the-recognised-minecraft-version)
@@ -23,46 +16,6 @@
 


-
-## Which Minecraft versions are supported?
-
-We support Minecraft versions from beta 1.8 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development#reporting-a-bug).
-
-### Can I use Amidst with the Windows 10, Xbox, Playstation or Pocket Edition of Minecraft?
-
-No. Amidst only supports the PC/Mac edition of Minecraft.
-
-### Can I use Amidst with a modded Minecraft version?
-
-In general, Amidst is not designed to support modded Minecraft versions. Especially, it cannot display biomes that are introduced by mods. However, if it is a mod that does not modify the biome generator, Amidst might just work fine with it. As always: Do this at your own risk. We consider all bug reports about modded Minecraft versions as invalid.
-
-Please note, that Optifine is considered a mod. Even though it does not alter the biome generator, it prevents Amidst to use the modded Minecraft profile. Please select an unmodded Minecraft profile.
- 
-## How can I run Amidst?
-
-To run Amidst, you directly execute the Amidst jar file. You do **not** need to insert it into the Minecraft jar file, like it is the case for many other mods. Please note that there is also an exe file for Windows users as well as a zip file for OS X users. However, these should behave exactly the same way as the jar file. If you need more control, you can use the [Command Line Interface](https://github.com/toolbox4minecraft/amidst/wiki/Command-Line-Interface).
-
-### Do I need to install Minecraft?
-
-Yes. Even though Amidst is **not** integrated into the Minecraft jar file like other mods, it uses the local Minecraft installation. Thus, you need to create an **unmodded** profile in the Minecraft launcher which executes the Minecraft version you want to use with Amidst. Also, you need to run this Minecraft profile at least once to make sure all required files are downloaded by the Minecraft launcher.
-
-### What are the System Requirements?
-
-* Operating System: Any
-* Java Version: at least Java 8
-
-### So, how exactly can I run Amidst?
-
-Follow these steps:
-
-1. Install Java - at least Java 8
-2. Install Minecraft
-3. Create an unmodded profile in the Minecraft launcher with the Minecraft version you want to use with Amidst.
-4. Start the profile, so you see at least the Minecraft title screen.
-5. Download Amidst
-6. Execute Amidst
-7. Select the profile you just created
-8. You can now render maps

 ## What is all the information in the window title?

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:03 -0000

--- v31
+++ v32
@@ -40,11 +40,11 @@

 ## How can I run Amidst?

-To run Amidst, you directly executed the Amidst jar file. You do **not** need to insert it into the Minecraft jar file, like it is the case for many other mods. If you need more control, you can use the [Command Line Interface](https://github.com/toolbox4minecraft/amidst/wiki/Command-Line-Interface).
+To run Amidst, you directly execute the Amidst jar file. You do **not** need to insert it into the Minecraft jar file, like it is the case for many other mods. Please note that there is also an exe file for Windows users as well as a zip file for OS X users. However, these should behave exactly the same way as the jar file. If you need more control, you can use the [Command Line Interface](https://github.com/toolbox4minecraft/amidst/wiki/Command-Line-Interface).

 ### Do I need to install Minecraft?

-Yes. Even though Amidst is **not** integrated into the Minecraft jar file like other mods, it uses the local Minecraft installation. Thus, you need to create a profile in the Minecraft launcher which executes the Minecraft version you want to use with Amidst. Also, you need to run this Minecraft profile at least once to make sure all required files are downloaded by the Minecraft launcher.
+Yes. Even though Amidst is **not** integrated into the Minecraft jar file like other mods, it uses the local Minecraft installation. Thus, you need to create an **unmodded** profile in the Minecraft launcher which executes the Minecraft version you want to use with Amidst. Also, you need to run this Minecraft profile at least once to make sure all required files are downloaded by the Minecraft launcher.

 ### What are the System Requirements?

@@ -57,7 +57,7 @@

 1. Install Java - at least Java 8
 2. Install Minecraft
-3. Create a profile in the Minecraft launcher with the Minecraft version you want Amidst to use. Make sure to create a new profile for this instead of using the default profile.
+3. Create an unmodded profile in the Minecraft launcher with the Minecraft version you want to use with Amidst.
 4. Start the profile, so you see at least the Minecraft title screen.
 5. Download Amidst
 6. Execute Amidst
@@ -115,7 +115,7 @@

 ## What is the history of Amidst?

-Amidst was originally developed by Skidoodle aka skiphs. It started as a [Stronghold Finder](http://www.minecraftforum.net/forums/archive/forum-1-8-update-discussion/938993-easily-finding-strongholds). Later on, skiphs decided to add more features and to [publish the source code](https://github.com/skiphs/AMIDST) using an open source license. Also, a readily compiled version was provided and [a wiki](https://github.com/skiphs/AMIDST/wiki) as well as a [second minecraftforum thread](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-tools/1262200-v3-7-amidst-strongholds-village-biome-etc-finder) was created.
+Amidst was originally developed by Skidoodle aka skiphs. It started as a [Stronghold Finder](http://www.minecraftforum.net/forums/archive/forum-1-8-update-discussion/938993-easily-finding-strongholds). Later on, skiphs decided to add more features and to publish the source code using an open source license. First, it was published on [Bitbucket](https://bitbucket.org/skiphs/amidst), but later it was moved to [Github](https://github.com/skiphs/AMIDST). Also, a readily compiled version was provided and [a wiki](https://github.com/skiphs/AMIDST/wiki) as well as a [second minecraftforum thread](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-tools/1262200-v3-7-amidst-strongholds-village-biome-etc-finder) was created.

 There is also a statement by skiphs about [the history of Amidst](https://github.com/skiphs/AMIDST/issues/45#issuecomment-54536224). Basically, there have been four iterations:

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:03 -0000

--- v30
+++ v31
@@ -35,6 +35,8 @@
 ### Can I use Amidst with a modded Minecraft version?

 In general, Amidst is not designed to support modded Minecraft versions. Especially, it cannot display biomes that are introduced by mods. However, if it is a mod that does not modify the biome generator, Amidst might just work fine with it. As always: Do this at your own risk. We consider all bug reports about modded Minecraft versions as invalid.
+
+Please note, that Optifine is considered a mod. Even though it does not alter the biome generator, it prevents Amidst to use the modded Minecraft profile. Please select an unmodded Minecraft profile.

 ## How can I run Amidst?

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:02 -0000

--- v29
+++ v30
@@ -1,3 +1,29 @@
+
+
+**Table of Contents**
+
+- [Which Minecraft versions are supported?](#which-minecraft-versions-are-supported)
+  - [Can I use Amidst with the Windows 10, Xbox, Playstation or Pocket Edition of Minecraft?](#can-i-use-amidst-with-the-windows-10-xbox-playstation-or-pocket-edition-of-minecraft)
+  - [Can I use Amidst with a modded Minecraft version?](#can-i-use-amidst-with-a-modded-minecraft-version)
+- [How can I run Amidst?](#how-can-i-run-amidst)
+  - [Do I need to install Minecraft?](#do-i-need-to-install-minecraft)
+  - [What are the System Requirements?](#what-are-the-system-requirements)
+  - [So, how exactly can I run Amidst?](#so-how-exactly-can-i-run-amidst)
+- [What is all the information in the window title?](#what-is-all-the-information-in-the-window-title)
+  - [What is the difference between the Minecraft version and launcher profile?](#what-is-the-difference-between-the-minecraft-version-and-launcher-profile)
+  - [What is the difference between the selected and the recognised Minecraft version?](#what-is-the-difference-between-the-selected-and-the-recognised-minecraft-version)
+  - [Why do you extract the recognised Minecraft version from the jar file?](#why-do-you-extract-the-recognised-minecraft-version-from-the-jar-file)
+- [How does Amidst work?](#how-does-amidst-work)
+  - [Which stages of the Minecraft world generator are used?](#which-stages-of-the-minecraft-world-generator-are-used)
+  - [Why are the structures displayed by Amidst incorrect?](#why-are-the-structures-displayed-by-amidst-incorrect)
+  - [Why does Amidst not display Dungeons?](#why-does-amidst-not-display-dungeons)
+- [What is the history of Amidst?](#what-is-the-history-of-amidst)
+- [How can I get in contact?](#how-can-i-get-in-contact)
+
+
+
+
+
 ## Which Minecraft versions are supported?

 We support Minecraft versions from beta 1.8 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development#reporting-a-bug).

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:00 -0000

--- v28
+++ v29
@@ -1,6 +1,6 @@
 ## Which Minecraft versions are supported?

-We support Minecraft versions from 1.0 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development#reporting-a-bug).
+We support Minecraft versions from beta 1.8 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development#reporting-a-bug).

 ### Can I use Amidst with the Windows 10, Xbox, Playstation or Pocket Edition of Minecraft?

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:00 -0000

--- v27
+++ v28
@@ -102,6 +102,6 @@

 ## How can I get in contact?

-Most of the time, one of the sections in [Supporting the Development](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development) will match your intent. If it does, please follow the instructions provided there. However, there are a few reasons to directly and privately contact the developers, for example to submit crash reports containing information that should not be published. If this matches your intent, here is the projects mail address:
+Most of the time, one of the sections in [Supporting the Development](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development) will match your intent. If it does, please follow the instructions provided there. However, there are a few reasons to directly and privately contact the developers, for example to submit crash reports containing information that should not be published. If this matches your intent, here is the mail address of the project:

 toolbox4minecraft+amidst@gmail.com

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:00 -0000

--- v26
+++ v27
@@ -1,6 +1,6 @@
 ## Which Minecraft versions are supported?

-We support Minecraft versions from 1.0 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/issues/new).
+We support Minecraft versions from 1.0 up to the latest snapshot. If you find an issue with a specific Minecraft version, [please report it](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development#reporting-a-bug).

 ### Can I use Amidst with the Windows 10, Xbox, Playstation or Pocket Edition of Minecraft?

FAQ modified by ryker aiden hill

ryker aiden hill — Tue, 01 Feb 2022 20:50:00 -0000

--- v25
+++ v26
@@ -102,4 +102,6 @@

 ## How can I get in contact?

-Please have a look at [the README](https://github.com/toolbox4minecraft/amidst/blob/master/README.md). If that does not fit your intend please create a post in the minecraftforum thread. If you still want to get in contact, for example to submit confidential information, please mail to toolbox4minecraft+amidst@gmail.com
+Most of the time, one of the sections in [Supporting the Development](https://github.com/toolbox4minecraft/amidst/wiki/Supporting-the-Development) will match your intent. If it does, please follow the instructions provided there. However, there are a few reasons to directly and privately contact the developers, for example to submit crash reports containing information that should not be published. If this matches your intent, here is the projects mail address:
+
+toolbox4minecraft+amidst@gmail.com