Skip to main content

Using ItemsAdder

ItemsAdder is a popular plugin that manages custom models and builds & serves the resource pack for you. VehiclesPlus has no special ItemsAdder integration — and it doesn't need one. Because every VehiclesPlus part is just a vanilla item + custom model data, you simply let ItemsAdder assign that model, then point VehiclesPlus at the resulting material and number.

Blockbench model  →  registered in ItemsAdder  →  ItemsAdder assigns a base item + custom_model_data
→ you put that material + custommodeldata in the VehiclesPlus part

Steps

  1. Model your vehicle (or each part) in Blockbench, as in the Blockbench guide.

  2. Register it in ItemsAdder as a custom item with your model — follow the ItemsAdder item documentation. Let ItemsAdder generate and serve the pack (/iazip, /iareload).

  3. Find the base material + custom model data ItemsAdder assigned to your item. You can read it from the generated pack's item-override file, or set the custom_model_data explicitly in your ItemsAdder item config so you know the exact number.

  4. Reference it in your vehicle model:

    item: {
    material: LEATHER_BOOTS # the base material ItemsAdder used
    custommodeldata: 100001 # the custom model data ItemsAdder assigned
    color: { red: 255, green: 255, blue: 255 }
    }
  5. Run /vm reload <id> and spawn the vehicle.


Things to watch

  • Use a leather base item (e.g. LEATHER_BOOTS) for parts you want VehiclesPlus to recolor (availableColors / paint). Configure your ItemsAdder item to use leather and make sure the model has tint, otherwise the color feature won't apply.
  • Players need the ItemsAdder pack. ItemsAdder serves its own merged pack, so as long as players have it, the matching item + custom model data shows your vehicle.
  • Engine sounds: VehiclesPlus measures engine-sound lengths from the pack at resourcePackUrl. When ItemsAdder hosts your pack, either include the VehiclesPlus engine sounds inside the ItemsAdder pack, or set each sound's duration manually in the model.
  • Avoid number clashes. Pin the custom_model_data in ItemsAdder so a pack regeneration doesn't shift it and break your vehicle's look.