Pommel - Held Item Models

Modrinth Page

What is Pommel?

Pommel is a Fabric mod that lets resourcepacks replace the models for the held version of items—just like the spyglass and the trident—letting you customize what your item looks in your hand. Want to make a 3d model of the mace in your hand, a fiery greatsword, or an ancient magical staff while still retaining the original item? With Pommel, all that can be achieved!

Works for modded items as well!

For Resource Pack Creators

Pommel replaces the held version of an item by a model you specify with the new model item predicate, pommel:is_held. For example, by modifying the model, iron_pickaxe.json, you can tell the mod what model should be displayed when held.

The held model provided as well as the textures for it can be wherever as long as it's specified by the item model json file.

JSON Example:

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "minecraft:item/2d_model_texture"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1.0 }, "model": "minecraft:item/my_held_item" }
  ]
}

You may also specify file directories for held models for organizing, as well as changing the parent model to something else.

Questions

Q: Does this work with CIT [Custom Item Textures]?

A: CIT Resewn nor Optifine hasn't updated to 1.21 yet, but I am guessing yes, as long as you have CIT replace the item with a model. CIT lets you replace an item's model, so Pommel should still allow you to have custom held models.

Q: Does this work with Vanilla Minecraft's item predicates such as Custom Model Data or bow Pulling?

A: Yes, but be sure you specify pommel:is_held for the custom_model_data models as well.

Here is an example of using vanilla item predicates and held item models:

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "item/base_item"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1.0 }, "model": "minecraft:item/base_item_held" },
	{ "predicate": { "custom_model_data": 1 }, "model": "minecraft:item/custom_item" },
	{ "predicate": { "custom_model_data": 1, "pommel:is_held": 1.0 }, "model": "minecraft:item/custom_item_held" }
  ]
}

Q: How would I replace a modded item's held model?

A: Same json hierarchy as in the JSON example, but instead of the id minecraft in front, it would be <mod_id>.

Q: I'm having issues getting my held model to work. Where can I go for troubleshooting?

A: First check if your JSON code doesn't have errors, as it's pretty easy to accidently screw up JSON code. I use JSONLint for validating my JSON, but most IDEs will also check for errors. If you're still having issues, honestly the best way to get support is to reach out to me on Discord. My username is timmychips so shoot me a message there if you need help!