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
- Back up your server and all ItemsAdder configuration files
- Locate your config files — typically in
plugins/ItemsAdder/contents/your_namespace/configs/ - Identify your resource pack assets — textures and models in
plugins/ItemsAdder/contents/your_namespace/resourcepack/ - 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 these2. Use the LK Creator Converter
- Go to the LK Creator Converter
- Upload your
items.ymlfile - Set Source Plugin: ItemsAdder
- Set Target Plugin: your desired plugin (Nexo, CraftEngine, or Oraxen)
- 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 Feature | Nexo Equivalent | CraftEngine Equivalent |
|---|---|---|
permission | Not directly mapped | Not directly mapped |
specific_properties.furniture | Mechanics.furniture | Plugin-specific |
specific_properties.armor.custom_armor | Components.equippable | components.equippable |
loots | Mechanics.custom_loot | Plugin-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