|
1 | | -AMIDST |
| 1 | +Amidst |
2 | 2 | ====== |
3 | 3 |
|
| 4 | +[](https://travis-ci.org/stefandollase/amidst) |
| 5 | + |
4 | 6 | Advanced Minecraft Interface and Data/Structure Tracking |
5 | 7 |
|
| 8 | +Where can I get Amidst? |
| 9 | +----------------------- |
| 10 | + |
| 11 | +You can download Amidst [here](https://github.com/skiphs/amidst/releases/latest). If you find any bugs, please [report](https://github.com/skiphs/amidst/issues/new) them so we can fix them. If you want to request a feature, you can to this [here](https://github.com/skiphs/amidst/issues/new). If you want to help develop Amidst, please get in contact [here](https://github.com/skiphs/amidst/issues/new). Lastly, [here](https://github.com/stefandollase/amidst/blob/refactoring/docs/BUILDING.md) is a description how you can build Amidst by yourself. |
| 12 | + |
| 13 | +What is Amidst? |
| 14 | +--------------- |
| 15 | + |
| 16 | +What it **can** do for you: |
| 17 | + |
| 18 | +* generate an overview of a Minecraft world from a given seed and a given Minecraft version |
| 19 | +* display biome information |
| 20 | +* display slime chunks |
| 21 | +* display structures |
| 22 | + * default world spawn |
| 23 | + * strongholds |
| 24 | + * desert temples |
| 25 | + * jungle temples |
| 26 | + * witch huts |
| 27 | + * villages |
| 28 | + * ocean monuments |
| 29 | + * nether fortresses |
| 30 | + |
| 31 | +When the world is loaded from a Minecraft world file, Amidst **can** also: |
| 32 | + |
| 33 | +* display singleplayer and multiplayer player locations |
| 34 | +* load player skins |
| 35 | +* move players to another location, including the y-coordinate |
| 36 | + |
| 37 | +What it **cannot** do for you: |
| 38 | + |
| 39 | +* display changes to the world, that are made after the world generator was finished, this includes |
| 40 | + * changes made by world editors like MCEdit |
| 41 | + * changes made while loading the world in Minecraft |
| 42 | +* find individual blocks or mobs in the world like e.g. |
| 43 | + * diamond ore |
| 44 | + * cows |
| 45 | + |
| 46 | +More features include: |
| 47 | + |
| 48 | +* saving an image of the map |
| 49 | + |
| 50 | +Which Minecraft versions are supported? |
| 51 | +--------------------------------------- |
| 52 | + |
| 53 | +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/skiphs/amidst/issues/new). |
| 54 | + |
| 55 | +How can I move a player? |
| 56 | +------------------------ |
| 57 | + |
| 58 | +You can move players in a world that was loaded from a Minecraft world file like so: |
| 59 | + |
| 60 | +* scroll to and right-click on the new player location, this opens a popup menu |
| 61 | +* select the player you want to move |
| 62 | +* enter the new y-coordinate |
| 63 | +* save player locations |
| 64 | + |
| 65 | +**WARNING: This will change the contents of the save folder, so there is a chance that the world gets corrupted. We try to minimize the risk by creating a backup of the changed file, before it is changed. If the backup fails, we will not write the changes. You can find the backup files in a sub folder of the world, named 'amidst_backup'. Especially, make sure to not have the world loaded in minecraft during this process.** |
| 66 | + |
| 67 | +When I load a world file I am asked what whether I want to load the Singleplayer of Multiplayer players. What does it mean? |
| 68 | +--------------------------------------------------------------------------------------------------------------------------- |
| 69 | + |
| 70 | +Minecraft worlds have three different locations to store player information: |
| 71 | + |
| 72 | +* the `level.dat` file contains the singleplayer player |
| 73 | +* the `players` directory contains all multiplayer players by name, this was used before Minecraft 1.7.6 |
| 74 | +* the `playerdata` directory contains all multiplayers players by uuid, this is used since Minecraft 1.7.6 |
| 75 | + |
| 76 | +If the `players` and the `playerdata` directory exist, we will simply ignore the `players` directory, since it contains outdated information. However, other situations cannot be decided automatically. If the world was only used by a server, there will be no player information in the `level.dat`, so we will just load the multiplayer players. However, if the map was ever loaded as a singleplayer world, the `level.dat` file will create singleplayer information. Also, the `playerdata` directory will contain information about all the players that used the world as singleplayer world. Of course we could just display the singleplayer player and the multiplayer players, however this might lead to an issue when you want to move the singleplayer player. When the world is loaded as singleplayer world, Minecraft will simply ignore and overwrite the information in the multiplayer directory, that belongs to the player that opened the world. Thus, if you move your player instead of the singleplayer player, this will have no effect. |
| 77 | + |
| 78 | +**tl;dr** If you use the world just as a singleplayer world, simply choose Singleplayer. |
| 79 | + |
| 80 | +What is the internet used for? |
| 81 | +------------------- |
| 82 | + |
| 83 | +* Amidst v3.7 was the last version that used google analytics, so we do no longer track you |
| 84 | +* Amidst will check for updates on every start |
| 85 | +* Amidst will use web services provided by mojang, e.g. to |
| 86 | + * display information about minecraft versions |
| 87 | + * display information about players like the name or the skin |
| 88 | + |
| 89 | +General information |
| 90 | +------------------- |
| 91 | + |
| 92 | +Amidst is not owned by or related to mojang in any way. |
| 93 | + |
6 | 94 | License and warranty |
7 | 95 | -------------------- |
8 | 96 |
|
9 | | -AMIDST comes with ABSOLUTELY NO WARRANTY. It is free software, and you are |
10 | | -welcome to redistribute it under certain conditions. See LICENSE.txt for more |
11 | | -details on both of these points. |
| 97 | +Amidst comes with ABSOLUTELY NO WARRANTY. It is free and open source software, license under the |
| 98 | +[GPL v3](https://github.com/skiphs/amidst/blob/master/LICENSE.txt), and you are welcome to redistribute it under certain conditions. |
0 commit comments