Skip to content
Nassim Jahnke edited this page Mar 6, 2023 · 9 revisions

Changing item and entity names

Since 4.6.0, mapping files are stored in a new, compact format, so editing them has become slightly more difficult:

  1. Open the ViaBackwards jar (with a program like 7zip or WinRAR) and navigate to assets/viabackwards/data.
  2. Look for the mapping file you need, e.g. mappings-1.19to1.18.nbt for 1.19 -> 1.18 mappings and copy it into ViaBackward's plugin folder.
  3. Open the NBT file with an NBT editor program or website, for example https://irath96.github.io/webNBT/ or the Minecraft Dev Plugin for IntelliJ.
  4. Look for itemnames and entitynames, edit the values you want to change, and save the file. Now ViaBackwards will load the file from its plugin directory if present.

Changing 1.16+->1.15 biome mappings

Similar to the mappings from above, you can move the biome-mappings.json file into the plugin folder and directly add mappings for custom biomes to map them to legacy biomes (the static biome names that existed until 1.15.2). Make sure to keep the file up to date with ViaBackwards updates.

Changing backwards translations

Same thing as biome mappings but with the translation json file.

Changing block/item/sound id mappings (advanced, not recommended)

You cannot easily edit these from the NBT mapping files. The human readable diff mappings are stored in a separate repository and require compiling.

We'd suggest simply creating a pull request to change the json file mappings if you think different mappings would be more suitable, so they can be changed in ViaBackwards proper.

Clone this wiki locally