Custom Item Drops

Learn how to create custom item drops!

Method One: Custom Override Per Item

If you'd like to change the look of dropped items, use the 'Override Item Drop' option in Items. This field will override the default prefab spawned when the item is dropped, and instead spawn the prefab of your choice. The downside to this is that you'd have to manually create a prefab for each of your items. But once you create one, the rest can be copied with the item model changed. Make sure to follow the Custom Prefab Rules.

An example of this exists in the demo. The item is called "Mini Kyle."

Method Two: Custom Default

This method was updated in v1.8.3.

Inventool automatically spawns the 'Item Drop Default Prefab' which is set in Settings.

Default Item Drop Prefabs

You can find both the 2D and 3D prefabs in the Assets/StylishEsper/Inventool/Prefabs/DefaultItemDrops folder. It's not recommended to change these objects directly. Instead, create a copy of one, customize that, and then set it as the 'Item Drop Default Prefab' in Settings. Ensure you don't make a change that conflicts with the Custom Prefab Rules.

This method requires less (overall) work, but the downside is that you have to add your own logic for loading the correct item model if you don't plan on keeping the SpriteRenderer component.

Custom Prefab Rules

There are a few rules to follow when creating custom item drop prefabs:

1. The object's root must have an Item Drop component attached. It simply needs to exist—you can leave the properties empty.

2. The object's root must have a collider set as a trigger on its root GameObject that acts as the pick up range.

3. The object's root should have a Rigidbody (3D or 2D) attached to it for collision purposes (mostly for detecting when the player is in range).

4. If your item drop model could be moved through the physics engine in any way, ensure that the trigger collider is moving along with it.

You can use the Default Item Drop Prefabs as as example. Please note that they are just examples—if you're following the rules above, your custom prefabs should work fine.