Amulet Converter/Editor V0.4

Please read this carefully before downloading.

We do not expect the program to corrupt any worlds but please back up any saves that you care about in the two Minecraft directories located at
Java -------- %AppData%/.minecraft
Bedrock ---- %LocalAppData%/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/minecraftWorlds

We are working towards Amulet being a full 3D editor but we are not there yet. The program can now do basic fill and replace operations with changes saved to the input world. It can also be used as a world converter to convert one world into another.

The converter works by first specifying the input world. This is the data that will be converted to the output world.
Then you specify the output world, click convert and the input world will get merged into the output world replacing any chunks at those locations

As such do not select an output world that you care about as some of the chunks will get overwritten. If you really want to use a world you care about as the output, make a copy of it before converting.
The input world should remain unchanged but to be safe back this up as well.

When selecting worlds double check that the names at the bottom of the screen next to the convert button match up with the ones you selected.
There is currently a bug where the screen jumps a little causing a different world to be selected.

Conversion Process

Download and extract the zip file to somewhere on your computer. All of the files are required.
Run Amulet-Converter.exe
Make sure that all worlds are closed and Minecraft is either closed or on the main menu.
A black console should appear along with a user interface showing you worlds you can pick.
Click on the world you want to open (this is the input world) - See the description on worlds below.
The screen should change to the world view. (Note at the top of the screen there should be two tabs. One is the main menu and one is the name of the world)
Select the output world (the one that will get overwritten)
Click the convert button and wait for the loading bar to finish at which point a box will appear saying it has finished.

You can now either close the translator and open the world in game, select a new output world to convert the same input world again or go back to the menu to select a new input world.

Worlds

Amulet supports all vanilla worlds newer than (and including) Java 1.12 and Bedrock 1.7 and some older worlds may work as the input world.
The program supports conversion to and from any world format newer than those versions.
For example here are some conversions that are possible
Java 1.12 to Bedrock 1.7
Java 1.13 to Bedrock 1.12
Java 1.15 to Bedrock 1.14
Java 1.12 to Java 1.15
Java 1.15 to Java 1.12
Bedrock 1.7 to Java 1.15
Bedrock 1.12 to Java 1.13
Bedrock 1.14 to Java 1.12
Bedrock 1.14 to Bedrock 1.7
Bedrock 1.7 to Bedrock 1.14

Known limitations

Items are currently only supported within the same platform (Java to Java or Bedrock to Bedrock)
Entities are not currently supported
If a chunk cannot be loaded it will not be converted (see below for how you can help)
There are some issues with the block translations and some blocks that have not been implemented yet (see below for how you can help)

How can you help us?

First of all you can use the program and tell us what you think of the conversions.
We are mostly concentrating on what the program can do rather than how easy it is to use so bear that in mind when giving feedback.
The program will create a number of log files in the logs folder. These help us work out what has gone wrong during conversion and should help us fix the issues.
Please send over these files either through Twitter to gentlegiantJGC or amulet_editor or in our Discord channel in the #amulet-discussion chat.
It will also be helpful if you can let us know of blocks that have been converted badly.

Changelog

Amulet is now not just a converter!!! It can do some editing as well.
Added a user defined selection box to the renderer.
Added a few operations with user customisability.
Added the ability for users to create their own operations for use in the program. (still WIP and the API will change)
Reworked the renderer to allow unloading/reloading chunks
Added undo/redo controls to the 3D editor.
Fixed some more memory leak issues (let us know if there are still problems)
Fixed some more issues with the renderer