Item Customizer
This mod is inspired by the New Weapon Customizer mod ( https://steamcommunity.com/sharedfiles/filedetails/?id=3598178221 ) and has implemented more features based on it. The release of this mod has been authorized by the original author; I would like to thank the original author for their guidance and inspiration. This mod was developed with the assistance of AI tools. The difference between this mod and framework mods is that this mod focuses on modifying items rather than adding items. The main features of this mod are as follows:
1. Allows modifying item properties using JSON. The JSON files used for modification should be placed in the Config/Modification/Item folder within the mod directory; there are no naming restrictions. Supported items and properties for modification include the basic attributes of all items (name, description, price, weight, rarity, stack size), slots, tags, as well as special attributes for firearms, melee weapons, equipment, ammo, throwables, attachments, medicines, and food. If you feel that the performance of a certain weapon or item does not meet your expectations, you can modify it. If you don’t know how to write a JSON file, you can refer to the configuration files exported via the Debug Mode introduced later. In addition to the attributes directly supported by the vanilla game, this mod can also implement some special functions:
Add slots, effective for any item. This feature can be used to create firearms that can mount more or fewer attachments, helmets that can mount totems, or expanded containers that can hold items, etc.
Items with special functions. When installed, they can modify fire modes, damage types, caliber, max durability, or even provide more slots. This allows for the creation of special attachments such as damage converters, rails, large-caliber barrels, etc.
Modify firearm burst intervals. In the vanilla game, the interval between two shots in a burst and the interval between two bursts is fixed at a 1:3 ratio. This mod allows modifying this ratio for each gun, enabling semi-auto weapons that behave consistently with full-auto fire intervals, or burst weapons that fire multiple rounds in a very short time followed by a long cooldown. The mod currently comes with some example files; you can check them to understand how to implement these special functions.
2. Allows replacing item icons. The PNG images used for replacement should be placed in the Config/Image/Item folder within the mod directory, named after the ID of the item whose icon you want to replace.
3. Allows cloning items from vanilla items using JSON. The cloned items are identical to the original items but can be modified using the two modification functions mentioned above. The JSON files used for cloning items should be placed in the Config/Addition/Item folder, with attributes including the original item ID and the new item ID. The mod comes with a "Control Stock II" item, which has the same bonuses as the Spiral Muzzle. If you don’t like it, you can delete the relevant configuration file to disable it.
4. Can add new tags. New tags are written in the Config/Addition/Tag folder; file naming is unrestricted. It includes an example; if you accidentally delete the example, you can delete the file and restart the game, and the mod will automatically regenerate the example.
5. Allows modifying and cloning effects (Buffs). The implementation of effects is roughly similar to item Modifiers, so a similar format is adopted; modification methods can refer to item modification. Cloning is also similar to item cloning, and it also features icon replacement similar to items. The paths for modification configs, cloning configs, and image replacements are also similar to item modification, placed in Config/Modification/Buff, Config/Addition/Buff, and Config/Image/Buff respectively.
6. Allows adding new recipes, blueprints, and merchandise. You can define new recipes, blueprints, and merchandise in Config/Addition/Formula, Config/Addition/Blueprint, and Config/Addition/Stock. You can set whether recipes/merchandise are unlocked by default, and set prerequisite tasks for unlocking merchandise. For details, please refer to the configuration files included with the mod. The default merchants in the game include: Merchant_Normal, Merchant_Mud, Merchant_Weapon, Merchant_Equipment, Merchant_Ming, Merchant_Fo, Merchant_Myst, Merchant_Myst0, Merchant_Test.
Debug Mode: You can enable Debug Mode in the mod configuration file Config/Settings.json. Once enabled, pressing J in the game can export the configuration file of the selected item. The exported files are located in the Export folder within the mod directory; you can use the exported files to quickly understand what content can be modified. Pressing K can export the configuration files of all Buffs in the game. Additionally, in Debug Mode, all items added via the "Addition" feature will be sold in the bunker vending machine at their selling price (i.e., half the item’s value), facilitating quick acquisition of items for debugging. Debug Mode also provides a Hot Reload function; pressing F5 can re-read all configuration files in the Modification folder, so you no longer need to repeatedly restart the game to fine-tune numerical values! (Note: This function essentially overwrites the original configuration with new configuration files. If you directly delete a file and reload, it cannot restore the vanilla values. To restore vanilla values, you must restart the game or overwrite with a configuration file containing the vanilla values.)
Update Plan (No Guarantees): Support for modifying weapon damage falloff mechanics; Others (suggestions are welcome).
Due to the author’s limited energy, excessive debugging has not been conducted. If you encounter bugs, please provide feedback, and I will try my best to fix them. The author is just a university student, so updates may be sporadic.
