3D-Models

Do not reload the plugin or the server to put these changes into effect. Restart the server.

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: 3465
  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