Convert old files to v2

It's recommended to start a fresh new world and don't use the old one as converters work but are experimental.

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"

You just have to rename ItemsAdder folder to ItemsAdder_backup, delete the old plugin and install the 2.0 version

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

Please be sure to follow the tutorial carefully, don't be in a hurry or you could make mistakes and take longer to do the conversion.

Do this operation only on a local test server on your PC so you won't make mistakes and risk losing data.

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

ItemsAdder converter will skip automatically my custom items, so it will create a pack that contains only items that you created on your own.

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

  • Stop the server

  • Please make sure you DELETED the old ItemsAdder.jar

  • If you have the OLD ItemsAdder folder in plugins please RENAME IT TO ItemsAdder_backup or delete it if you already have backups.

  • Download ItemsAdder 2.0 and put it in your plugins folder

  • Start server

  • Wait ItemsAdder 2.0 to finish creating its files

  • If you get any error please read it and check if you did anything wrong (missing dependency, wrong Spigot version....) and retry this step.

  • (IGNORE if you get error about the resourcepack URL, it's normal as you will configure it later)

  • Open folder ItemsAdder_converted which is just created

  • copy the two folders items_packs and resource_packinto new ItemsAdder folder (replace any file if asked)

  • Restart the server

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