Convert old files to v2

If you didn't create any custom item and you are using only my custom items please skip that tutorial, you don't need to convert files. But be sure to follow the tutorial "Convert old items ingame"

What changed?

ItemsAdder v2 is a complete recode of previous ItemsAdder version. It changed EVERY configuration and every resourcepack file path/properties/format. It's like a brand new plugin, with more features, more optimized and easier to maintain.

How can I convert old configuration files and resourcepacks to the new format?

You have to follow this tutorial :D

Step 1

  • Disable old ItemsAdder plugin from your test server (delete the ItemsAdder.jar and stop server)

  • Download the ItemsAdder Converter and put it into your test server plugins folder.

Step 2 - copy items configs

  • Open server plugins folder and create a new folder named ItemsAdder_old

  • Open your OLD ItemsAdder folder and copy files from items folder (see screenshot)

  • Paste the items folder into ItemsAdder_old

Step 3 - copy resourcepack

  • Create a new folder named pack inside ItemsAdder_old

  • Extract the exact CONTENT of your old resourcepack .zip file inside the new folder pack

Step 4 - Prepare new ItemsAdder 2.0

If you don't care and don't want to get my custom items and you just want to create your own items:

open config.yml in the ItemsAdder folder (just generated by ItemsAdder 2.0 version) and set these properties to false.

extract-default-items: false
extract-default-resources: false

Then delete all folders inside ItemsAdder\data\items_packs\... but keep minecraft folder. And delete all folders inside ItemsAdder\data\resource_pack\assets\... but keep minecraft folder.

You also have to remove my categories from ia_gui.yml

Step 5 - preparing the converter

Configure it before start conversion

  • Open file plugins/ItemsAdderConverter/config.yml

  • Edit namespace to a custom name. You can chose your server name or whatever you want. For example some of my items have namespace "itemsadder" so you'll be able to use command like /iaget itemsadder:ruby (but as you can notice I created more namespaces in the new plugin, in order to separate functionalities)

Step 6 - conversion

To start the conversion:

  • start the server

  • wait it to finish loading all

  • use command /itemsadderconverter:iaconvert

  • WAIT IT TO FINISH

  • Check if it throws any error

  • Stop server only when it finished converting.

Installing ItemsAdder v2

Last tasks

  • delete ItemsAdderConverter, ItemsAdder_converted, ItemsAdder_old folders.

  • delete ItemsAdderConverter.jar

Resourcepack configuration

Please follow this fast tutorial to activate resourcepack:

Self hosting

Last updated

Was this helpful?