Skip to content

How do I make a Shield?

Catman edited this page Aug 14, 2025 · 4 revisions

This guide could be considered out of date and needs a bit of a rewrite!

  1. First things first, go into Homebrewery's HomebreweryFiles > Template folder and Copy the Template_ShieldItem folder
    HomebreweryFiles Template folder

  2. Paste the item folder into HomebreweryFiles > Shield
    HomebreweryFiles Shield folder, highlighting pasted template item folder

    Rename the folder to something you can recognise and don't change it again!
    Renaming the item folder

  3. Inside the folder you will see shield.png, icon.png and param.txt
    Inside the item folder, highlighting the files
    icon.png is a 32x32px sprite you can use to represent the item however you like, perhaps try to take a screenshot of the item and crop it out to look sort of like the vanilla item icons?

    shield.png is a 64x64px texture which is displayed on the shield's mesh.

    param.txt contains the details the game needs in order to define the item and what it contextually does, so in this case the Shield's physical appearance, and whether the texture's hue, saturation, brightness and contrast are adjusted when displayed in-game.

{
  "_shieldMesh": "_shield_01",
  "_textureColorAdjust": {
    "_hue": 0.0,
    "_saturation": 1.0,
    "_brightness": 0.0,
    "_contrast": 1.0
  },
  "_itemName": "This text is the Shield's display name",
  "_itemDescription": "This text goes in the space beneath the Shield's name"
}

Edit the text within the speech marks ("") to change the text the item displays in-game.

"_itemName": "Very Cool Shield",
"_itemDescription": "This Shield is Very Cool!"

_shieldMesh designates what Mesh the Cape will display in-game. Click here to jump to the list of meshes.

"_shieldMesh": "_shield_01",

_textureColorAdjust is just like the _colorAdjustParams properties that other gear items have, except Shields cannot be dyed.
It's a set of four values that you might notice looks exactly the same as the ones that Dyes have, just by a different parent name. This is kinda like a "Pre-Dye" the game will do to the textures before it applies the Dye's settings, if it actually got dyed.
I'm not sure why you would ever need to use this considering Shields do not get dyed.

"_textureColorAdjust": {
  "_hue": 0.0,
  "_saturation": 1.0,
  "_brightness": 0.0,
  "_contrast": 1.0
},

I guess Shields are the simplest kind of item to make since they just have the mesh, the texture and don't have any consideration for dyeing.
The item's tooltip in-game
It will show "Block threshold: 0 damage" because Shields technically don't have special consideration for being Cosmetic quality, they still work as actual shields but won't have any stats at all, so they'll be useless in combat.
The drop item visuals Wearing the item

Clone this wiki locally