3D-Models

You do not need to do this, if you want to use the default models. This is a way to add more alternatives with resource packs.


Enabling Custom 3D-Models

To enable this feature, you need to disable the following config option. This setting may not be in your config, as it has been added in Vehicles 14.2!

nativeModelsEnabled: false

This setting will disable all default models, limiting them to one invisible armorstand.


Important Notices

  • Using this feature will remove all default models, limiting them to a single invisible armorstand.

  • You can add your own models made with resource packs. File uploads and other models are not supported.

  • Seat positions remain unchanged, regardless of your added model.

  • All features of the default vehicles remain the same. Only the look changes!


Adding the ItemStack

To swap the vehicle for your new model, add the following code to a vehicle config:

3dModelItem:
  ==: org.bukkit.inventory.ItemStack
  type: <ITEM>
  v: <VERSION>
  amount: 1
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
    custom-model-data: 1

Make sure to adjust the v (Version) value, to match your data version: https://minecraft.wiki/w/Data_version

Want to use more ItemMeta? Check out the entire format and settings here: https://www.spigotmc.org/wiki/itemstack-serialization/


The following is an example setting for the black car. For the default config options, see here.

cars:
  'BLACK':
  mainMaterial: 'BLACK_TERRACOTTA'
  wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
  frontLightsUrl: 'http://textures.minecraft.net/texture/59e9c9246f1ba5a41e53efa68b2bd56a70da308f393487dcf6fe756799b3c7'
  backLightsUrl: 'http://textures.minecraft.net/texture/4636afc9ecb492722eda37eaab7f5c4acca8974bdc628e4273cbcebd45073ac'
  steelUrl: 'http://textures.minecraft.net/texture/f0d3c96f8c183cf9415c437e4972827656abe7bee36d81d1e9c04466514b9e4'
  maxSpeed: 1
  maxBackSpeed: 0.5
  acelerationValue: 0.006
  displayName: '&7Black Car'
  permission: 'Cars.type.BLACK'
  maxHealth: 40
  fuelCapacity: 1000
  fuelWasteSpeed: 1.2
  3dModelItem:
    ==: org.bukkit.inventory.ItemStack
    type: CARVED_PUMPKIN
    v: 3465
    amount: 1
    meta:
      ==: ItemMeta
      meta-type: UNSPECIFIC
      custom-model-data: 1

Last updated