Custom Items Framework

This is a mod made by @gnonme#2200 and @Chromium#1111 for loading in any sort of custom items. This allows for new guns, melee weapons, NPCs, random props, and more!

To install items, place .melon files into the UserData\CustomItems folder. You can enable/disable output to the console in modprefs.

To export the textures of items when the game starts, enable ExportTextures in modprefs. Custom item textures will be put into UserData\CustomSkins\_Defaults\<MelonName>, player textures will be put into UserData\CustomSkins\_Defaults\_Player, and vanilla items will be exported to UserData\CustomSkins\_Defaults\_VanillaItems. If you want to load custom textures, put them in UserData\CustomSkins\<ExportedFolderName> and enable UseCustomTextures in modprefs. Make sure you don't rename the folders or textures. On average, custom textures take up about 5 times as much ram as disk space, so only include the textures that you modify.

Info For Creators: https://pastebin.com/Ce7DvJXG SDK: https://boneworks.thunderstore.io/package/gnonme/CustomItemsSDK/

Special thanks to: @Acies#3128 @Camobiwon#9295 @phord 3#7005 @RazikMazilya#0001 @TabloidA#7797 @tarf#9691

Changelogs

New in v1.4.1:

• Fixed not being able to remove muzzle flashes on silenced guns
• Fixed shells being ejected at the wrong scale after using a gun with no shell ejection

New in v1.4:

• Fixed occasional nullrefs with preferences
• Added weapon replacement feature Replacement is configured with json files Replace randomly, by ammo type, by name, or a mix Exclude specific levels from replacement, per item or globally
• Added more ways to customize your guns Silenced guns have a much smaller muzzle flash by default Creators can completely disable muzzle flashes on guns Spawn custom particles (or anything really) when a gun is fired Call functions or change variables on your item when you grab a specific point Change the scale of ejected bullets
• Added version checking
• Dave grew up

New in v1.3.1:

• Merged Fire Modes into this, so delete the dll if you already have it.
• Loading times should now be much faster.
• Items won't reload when changing levels unless you enable DebugMode in modprefs.
• Added support for custom player skins and texturing any item that can be added to the spawn menu. Works the same as skins for custom items so you have to enabled it in modprefs.

New in v1.3:

• Fixed GetCustomItem()
• Added a way to change the textures on custom items, support for vanilla items hopefully coming Soom™
• Dave

v1.2.4:

• The CustomItems folder is now searched recursively so you can group .melon files into subfolders. To exclude a folder from being loaded, add "-ignore" or "_ignore" to the end of the folder name.
• Added the GetCustomItem() method for getting an instance of any custom item by name.
• Added VerboseLogging modpref, disabled by default, which will log the name and category of every item in each assetbundle instead of just the bundle name.

v1.2.3:

• Dummy shader support

v1.2.2:

• Fixed guns that were made with the standard shader only showing in one eye.

v1.2.1:

• Pretty much just updated to work with v0.6 of the toolkit
• The debug mode option has been removed because bundles need to be reloaded now anyway. So it's always on, but just won't log stuff
• Custom shader support coming Soom™

v1.2:

• New way of getting the item settings. This will really only affect mod content creators, but anyone using items made with the new SDK will need this version or later. Existing items don't need to be updated.

v1.1.1:

• This is just a simple update to work with v0.5 of the toolkit. Move .melon files to UserData\CustomItems

v1.1:

• Added a way to reload your items without restarting the game to make testing easier. If you enable debug mode in modprefs all of your items will reload every time you get into a level.