Skip to Content
Migration GuideFrom ItemsAdder Setup

From ItemsAdder Setup

Migrating from ItemsAdder to another plugin (Nexo, CraftEngine, Oraxen) using LK Creator’s Converter.


Why Migrate?

Common reasons for migrating from ItemsAdder:

  • Switching to Nexo (successor to Oraxen, active development)
  • Moving to CraftEngine for its broader MC version support
  • Performance or compatibility needs

Before You Start

  1. Back up your server and all ItemsAdder configuration files
  2. Locate your config files — typically in plugins/ItemsAdder/contents/your_namespace/configs/
  3. Identify your resource pack assets — textures and models in plugins/ItemsAdder/contents/your_namespace/resourcepack/
  4. Note any custom recipes, loot tables, or furniture — these may need manual adjustments

Step-by-Step Migration

1. Export Your ItemsAdder Configs

Gather all .yml files from your ItemsAdder contents directory:

plugins/ItemsAdder/contents/ my_namespace/ configs/ items.yml # <-- This is what you need recipes.yml # If you have custom recipes loots.yml # If you have loot tables resourcepack/ assets/ my_namespace/ textures/ # Keep these models/ # Keep these

2. Use the LK Creator Converter

  1. Go to the LK Creator Converter 
  2. Upload your items.yml file
  3. Set Source Plugin: ItemsAdder
  4. Set Target Plugin: your desired plugin (Nexo, CraftEngine, or Oraxen)
  5. Click Preview Conversion

3. Review the Preview

The converter will show you:

  • Successfully converted items with their new configs
  • Warnings about properties that were approximated
  • Unsupported features that need manual attention

4. Handle What Doesn’t Convert

Some ItemsAdder-specific features may not convert automatically:

ItemsAdder FeatureNexo EquivalentCraftEngine Equivalent
permissionNot directly mappedNot directly mapped
specific_properties.furnitureMechanics.furniturePlugin-specific
specific_properties.armor.custom_armorComponents.equippablecomponents.equippable
lootsMechanics.custom_lootPlugin-specific

5. Transfer Resource Pack Assets

Your textures and models work across plugins. Copy them to the new plugin’s resource pack directory:

  • Nexo: plugins/Nexo/pack/assets/your_namespace/
  • CraftEngine: Configured in CraftEngine’s settings.yml
  • Oraxen: plugins/Oraxen/pack/assets/your_namespace/

Known Limitations

  • Recipe conversion may produce different formats — review converted recipes carefully
  • Furniture placement mechanics differ between plugins
  • Custom model data assignment strategies vary
  • See Converter Limitations for the complete list

Post-Migration Checklist

  • All items appear correctly in-game
  • Textures and models render properly
  • Recipes work as expected
  • Loot tables are dropping items
  • Furniture can be placed and broken
  • Permissions are configured in the new plugin
  • Resource pack is being served to clients