Spear

Custom spear graphics are supported for these materials:

• WOODEN_SPEAR
• STONE_SPEAR
• COPPER_SPEAR
• IRON_SPEAR
• GOLDEN_SPEAR
• DIAMOND_SPEAR
• NETHERITE_SPEAR

Spear models#

Spears have two model states:

• normal: default model used outside the player's hand.
• in_hand: model displayed while the spear is held.

The normal model is required. If in_hand is omitted, ItemsAdder uses normal for both states.

Using custom models#

info:
  namespace: my_spears

items:
  ruby_spear:
    name: Ruby Spear
    material: DIAMOND_SPEAR
    graphics:
      models:
        normal: item/ruby_spear
        in_hand: item/ruby_spear_in_hand

Place the model files here:

contents/my_spears/models/item/ruby_spear.json
contents/my_spears/models/item/ruby_spear_in_hand.json

Use custom models when you need a 3D model or custom display transformations.

Creating a 3D spear in Blockbench#

Open Blockbench and create/open a Java Block/Item model.

1. Build the spear upright#

• Build the spear vertically.
• Make the handle point down and the tip point up.
• Keep the shaft in the middle of your workspace.
• A long spear can extend outside the normal 0 to 16 box. Do not squeeze it to fit.

2. Move the spear to the center#

Imagine a pin at [8, 8, 8], in the middle of the workspace. Minecraft holds and turns the complete spear around this point; [0, 0, 0] is only a corner.

Select every cube in the Outliner, then use the Move tool to move the whole spear until its middle is around [8, 8, 8]. Keep all cubes selected so the shape does not change.

Check that the shaft is still vertical and the tip points up. ItemsAdder changes how the spear is shown in hand, but it does not reposition the cubes for you.

3. Set the in-hand view#

Rotate one cube only when that cube is actually meant to be angled, like a blade or decoration.

For the whole spear orientation, use the Blockbench Display tab and set these values:

Then adjust only translation and scale in the preview.

Using textures only#

ItemsAdder can generate both spear models automatically from textures.

info:
  namespace: my_spears

items:
  ruby_spear:
    name: Ruby Spear
    material: DIAMOND_SPEAR
    graphics:
      textures:
        normal: item/ruby_spear
        in_hand: item/ruby_spear_in_hand

Place the textures here:

contents/my_spears/textures/item/ruby_spear.png
contents/my_spears/textures/item/ruby_spear_in_hand.png

The generated in_hand model automatically uses the correct vanilla spear display transformations.

Using one texture#

You can use the same texture for both states:

graphics:
  texture: item/ruby_spear

ItemsAdder generates separate models for normal and in_hand, both using the specified texture.

Custom icon#

Use icon to provide a separate inventory texture:

graphics:
  icon: item/ruby_spear_icon
  textures:
    normal: item/ruby_spear
    in_hand: item/ruby_spear_in_hand

Place it here:

contents/my_spears/textures/item/ruby_spear_icon.png

The icon is used in the GUI, on the ground, in item displays and on shelves.

Testing#

Reload ItemsAdder and regenerate the resource pack:

/iareload

Get the item:

/iaget my_spears:ruby_spear