Void Item API

So I figured why not make this API because a lot of people ask how to create a void item, and this keeps the process really simple for people.

You will need to add the DLL as a reference for your project, which you can acquire by downloading here off the thunderstore or from the "Current DLL" folder in the github repo.

I will be making a wiki for how to create void items manually on r2wiki, in case you may not to depend on this API.

Guide

Requirements:

You must set this project as a dependency in your main cs file. It will break if it loads after your mod, obviously. Don't forget.
If you are using an ItemDef from the vanilla game to reference in a transformation, you must call the method AFTER ItemCatalog initializes. Otherwise, you can use the string method at any point in time as long as the void item is valid.
VoidItemAPI must be set as a dependency in your manifest.json when uploading.

Now that those are out of the way time for a mini-guide on how to use the API. It is pretty simple actually.

There are 4 different CreateTransformation methods you can choose from:

CreateTransformation(ItemDef VoidItem, ItemDef TransformedItem)
CreateTransformation(ItemDef VoidItem, ItemDef[] TransformedItems)
You can supply ItemDefs for these two to create your transformations, however remember that the ItemCatalog must be initialized before calling these.

CreateTransformation(ItemDef VoidItem, string TransformedItem)
CreateTransformation(ItemDef VoidItem, string[] TransformedItems)
You can use a string for these two if you want to call this before the catalog initializes. The string would simply be the name of the item you would use for the ItemDef.
For example: Red Whip = RoR2Content.Items.SprintOutOfCombat, which would mean the string would be "SprintOutOfCombat"

That's about it for the guide. You can declare the dependency at the top of your main class by typing:
[BepInDependency(VoidItemAPI.VoidItemAPI.MODGUID)]

If you need any help with anything just ping me or shoot me a dm on the modding discord: @joseph#6783

Thanks to bubbet for showing me his method of using strings to get the ItemDef.

Changelog

1.0.0

Release

Void Item API

So I figured why not make this API because a lot of people ask how to create a void item, and this keeps the process really simple for people.

You will need to add the DLL as a reference for your project, which you can acquire by downloading here off the thunderstore or from the "Current DLL" folder in the github repo.

I will be making a wiki for how to create void items manually on r2wiki, in case you may not to depend on this API.

Guide

Requirements:

You must set this project as a dependency in your main cs file. It will break if it loads after your mod, obviously. Don't forget.

If you are using an ItemDef from the vanilla game to reference in a transformation, you must call the method AFTER ItemCatalog initializes. Otherwise, you can use the string method at any point in time as long as the void item is valid.

VoidItemAPI must be set as a dependency in your manifest.json when uploading.

Now that those are out of the way time for a mini-guide on how to use the API. It is pretty simple actually.

There are 4 different CreateTransformation methods you can choose from:

That's about it for the guide. You can declare the dependency at the top of your main class by typing:
[BepInDependency(VoidItemAPI.VoidItemAPI.MODGUID)]

If you need any help with anything just ping me or shoot me a dm on the modding discord: @joseph#6783

Thanks to bubbet for showing me his method of using strings to get the ItemDef.

Risk of Rain 2

Details

Void Item API

Guide

Changelog

Void Item API

Guide

Changelog