How to install models in BackpackCosmetics plugin

So you’ve decided to download cosmetic models for the BackpackCosmetics plugin, great! Here is how you install/config them into the plugin. Need to download the plugin? You find it under our partners page.

If you do not know how CustomModelData works, check out our resource pack tutorials here.

Step 1: Make sure the item model / resource pack work

Once you’ve turned on your resource pack containing the new model/models try spawning one in using:

/minecraft:give @p minecraft:totem_of_undying{CustomModelData:1}

Replace the totem_of_undying with the material your model is set up as in the resource pack and the custom model data number with the correct one.

If your models work like they should, we can jump to step 2.

Step 2: Add the model/models to your cosmetics.yml file

In this example I’m adding the jetpack model from Izzy’s Backpacks – 1.

  jetpack:
    material: PAPER
    customModelData: 9
    permission: "cosmetics.backpack.jetpack"
    unlockedItem:
      material: PAPER
      name: '&bJetpack &a(Unlocked)'
      customModelData: 9
      lore:
        - ''
        - '&7https://store.example.com'
        - ' &3➜ Click to toggle'
    lockedItem:
      material: PAPER
      name: '&bJetpack &c(Locked)'
      customModelData: 9
      lore:
        - '&cYou do not currently own this'
        - '&ccosmetic, but you can buy it'
        - '&cfrom out store.'
        - ''
        - '&7https://store.example.com'
        - ' &3➜ Click to toggle preview'

In this case I’ve done these things:

  • I’ve set the material to paper in the resource pack.
  • The CustomModelData in the resource pack is 9.
  • The permission node to be able to use the model in the plugin is set to cosmetics.backpack.jetpack

LockedItem section determines the lore in the GUI for when the player does not have the permission node cosmetics.backpack.jetpack

You can now restart the server and test your model using:

/cosmetics equip jetpack

Step 3: Add the cosmetic to page yml (page-one.yml)

This is the easiest step, simply add the cosmetic to the GUI slot you wish to use.

  jetpack:
    type: COSMETICS
    cosmetics: jetpack
    slots: [28]

Now enjoy the model through the GUI using the /cosmetics command.

Enjoy!