Pommel - Held Item Models
by TimmyChips
Pommel lets resource pack creators replace the held-in-hand model of an item, so a mace, greatsword or staff can be shown as a 3D model while the original item stays intact.
What it does
Pommel is a Fabric mod for Minecraft Java Edition. A resource pack can overwrite the models used for held items, in the same way the spyglass and the trident already work. The change is made through item model JSON files, and the held model and its textures can be stored in any folder the JSON points to. Modded items are supported as well.
Item predicates decide which model is shown. The predicate for held items covers first person and third person views, while separate predicates cover the offhand slot, a worn helmet, an item in an item frame, an item dropped on the ground and throwable items such as eggs, snowballs and ender pearls. An example in the source material changes an apple between two eat states and gives it a separate held model.
Pommel is published for 1.20.1, 1.21 and 1.21.1, and the latest Fabric file is 1.4.2+1.21.x for 1.21.1, released on 2025-10-20. The mod is client required and server optional, and the code is under the MIT License, so it is open source. Cobblemore Lib requires Pommel.
Key features
Held model overrides
Resource packs replace the model shown in the hand for any item that the JSON file lists.
First and third person predicates
Separate values change the model in first person and in third person views.
Offhand and head predicates
Items in the offhand slot or worn in the helmet slot can each show their own model.
Item frame and ground predicates
A model can differ when the item sits in an item frame or lies on the ground.
Thrown item predicate
Throwable items such as eggs and snowballs can show a separate model while in flight.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Required by 1 mod
Use cases
Decorative weapons
A resource pack can show a fiery greatsword or a staff in the hand while the item keeps its normal function.
Custom equipment on the head
The helmet predicate lets a pack place a model on the head in place of a carved pumpkin.
Who it’s for: Resource pack creators who want held items to look different from their inventory icons, and server owners who run custom item content from packs.
Questions
Does a server need Pommel to show held models?
Can held models be used with item model overrides from other packs?
Which versions does Pommel support?
In the catalog
Pommel - Held Item Models is one of 12,078 Decoration mods on ModsFinder, and one of 6,982 Decoration mods for Fabric. 32,366 mods support Minecraft 1.21.1.
More from TimmyChips
Similar mods
What the author says
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…
Official listing
- Modrinth page
- modrinth.com/mod/pommel-held-item-models
- Owner
- TimmyChips
- Published
- 2024-07-16
- Updated on Modrinth
- 2025-10-20
- Facts verified
- 2026-10-15