Properties that all items can have - Catman-232/Homebrewery GitHub Wiki

^{This page was up to date as of version 4.0.0}
An item's param.txt file is a JSON formatted set of properties that HB will try to parse into data. You do not need to have every single property in a file, as any you don't have will be given its default value, which is displayed in each code block below.

The file starts with a left brace: {, property names go in speech marks with a colon afterwards: "property": , values go after the colon and will have a comma after them: 10, or "stringvalue", unless it is the last one in the file: 10 or "stringvalue", and finally the file ends with a right brace }

"_itemName": "HB_ITEM",

String
Altering this value after first setting it is inadvisable as it is a very important part of how the game loads, stores and syncs items. It is inconvenient to update an item's name due to how the game caches all items by their display name. This also applies to the name of the folder the param.txt is within.

"_itemDescription": "",

String
You cannot use speechmarks in text strings unless you use a backslash to "escape" them e.g. \"
You can use the newline control char \n but be wary that the item tooltips only expand so far down.

"sortindex": 0,

Integer (no decimal place allowed)
This controls the sorting of your content pack's items in its shop item page. Negative values are allowed. Items with the same number will just sort by their name. The sorting order matches the numbers in ascending order, so for example: ItemA with sortindex 4 will be listed after ItemZ with sortindex -2.

"dropitemtime": -1,

Float (decimal places allowed)
Defines an override to the length of time an itemdrop of this item will persist for in the world, the default value of -1 tells Homebrewery to not alter the vanilla value. The game counts very strangely for this timer, for an itemdrop to last for about an hour, a value of 11700 should be about right.

"secretitem": false,

Boolean (true or false, no speechmarks)
Setting this to true will prevent Homebrewery from listing the item in your content pack's shop page, which would generally make it impossible to ever get the item unless you know of alternative means to acquire it.

"_destroyOnDrop": false,

Boolean (true or false, no speechmarks)
Setting this to true will cause the item to poof into a cloud of dust when you drop the item from your inventory, including a line of text in the UI mentioning the item disappearing.