Subscribe to download
Build 42+ UNSUPPORTED - Item Tweaker API

Workshop ID: 566115016
ModID: ItemTweakerAPI

--EDIT 3 - End of Support --
I thank you all who have subscribed, and with these numbers am humbled.
I am aware this mod no longer works for build 42. I am okay with this, and in fact am glad, as this mod was honestly never really needed. It has been 9 years, and was once drastically needed to help spread modding awareness, this is by far no longer true.
It is time to return the attention this mod has been given back to the Zomboid devs, who laid the framework this mod piggybacked.

For Context:
This mod was built during a time where new Zomboid modders would release mods containing entire files worth of item definitions, in order to only change a single entry, thus removing any changes a mod loaded previously would make.

This mod mod makes use of code that Zomboid always had simply to make new modders know how to make mods more compatible. I honestly never intended for people to continue to use this mod for their mods for the last 9 years instead of discovering the real method behind how to do it themselves.

That being said, while I appreciate the support, and the sheer number of people subscribing, I am going to keep this mod in a mothballed state, ending support for build 42 onward, but keeping it available to any mod still relying on it in build 41. Feel free to unsubscribe when the time for it comes, but it's still been quite a trip.

--EDIT 2--
For those of you who are -still- getting missing file errors, Unsubscribe from the other item tweaker here.
https://gtm.you1.cn/workshop/filedetails/?id=2510747487

Having both versions subscribed list alone can cause issues, as they are using the same ModID, and is 100% confusing your game's mod enabling/loading attempts.

This alone is making it try to load both my still working code, and the outdated version's now broken code.

Furthermore, if this issue is still happening, and you know you haven't subscribed to this mod, then there may be another mod you've subscribed to that is still using the outdated mod's script files.

I recommend looking into which those are, and suggest those mods switch back to this still working version.

---EDIT---
It's come to my attention that there is another version of item tweaker that had been updated at one point. While it may have been an improvement at one point, and I thank him for trying to keep this mod alive, his version is apparently causing many issues in the new build. This version seems to still work very well.

I have not been modding for PZ in quite a long time, however knowing this mod still works now as it did before makes me feel glad to have been part of the modding community. Should this start acting up for real, I may pass it on to someone more active, but as of now, I hope you continue to enjoy it. Thank you again Brybry and Blindcoder for helping to make improved mod compatability possible all these years



---ORIGINAL POST---

This modding API allows any modders to more simply make multiple changes to any items loaded into the game's current database, while leaving the rest of the remaining values alone. This uses code that Zomboid already has implemented, but intended for new modders that haven't discovered those commands yet.

Change any item's weight, display name, display category, hunger reduction, or anything else, while keeping the item as mod friendly as possible.
(WARNING: changing TYPE will delete all instances of already spawned items)

You can change only an item icon, while another mod changes the same item's weight, all without conflict (Unless mods do not use this mod to do so, or two mods try to change the same value, in which case, the last loaded mod will win)

For the Simplest Implementation through LUA:
-----------------------------------------------------------------------Begin File
if getActivatedMods():contains("ItemTweakerAPI") then
require("ItemTweaker_Core");
else return end

TweakItem("Base.Needle","Icon", "Worm");
TweakItem("Base.Needle","Tooltip", "Wearable: Waist");
TweakItem("Base.Needle","DisplayCategory", "Repair");
-----------------------------------------------------------------------End File
For each item and property you wish to change, create a new line, and place the related values in place.

You can even add custom ModData to items.
TweakItem("Base.Needle","BaseValue", "500");

Organized Item Names is an example mod to hopefully show beginner modders how to make use of this API

Mods I know of using this API:
Custom Categories
JPCategoriesPlus - By: Proxyer
Littering - By: Svarog
Jaw Stab Proliferation - By: LoonyLadel

Wedge's Item Name Fixes - By: Wedge McCloud (Includes changes for some other mods)
Custom Categories(Outdated: Use Wedge's Item Name Fixes instead)
Organized Item Names (Outdated: Use Wedge's Item Name Fixes instead)

Wedge's Hydrocraft Tweaks - By: Wedge McCloud (Requires Hydrocraft)
Better Carts - By: yuriy206 (Requires Hydrocraft)