Recycling

The Recycling system is an attempt at a versatile and balanced "uncrafting" API. If you wish to get the results of recycling an Item, you can do this like so:

RecyclingOutputs outputs = RecyclingManager.getRecyclingOutputs(level, stack);

This returns a RecyclingOutputs object, which is a list of Item Stacks and the expected counts of each. This can be interpreted as a guaranteed count plus a chance at another, and you can roll for these results like so:

outputs.rollStacks(level.random);

By default the RecyclingOutputs will include a 100% return, so you get back exactly the average number of Items used to craft the Item being recycled (even if that number is a fraction). But, it is recommended for balance you reduce this output. For example, this will only return 25% of the input Items on average:

outputs.multiplyAll(0.25f).rollStacks(level.random);

The Library tries to automatically produce sensible recycling outputs for vanilla and modded Items. It attempts to do this by:

1. Checking if there is a Direct Recycling Recipe for the Item Stack, and if so getting its RecyclingOutputs directly and go to step 4
2. Checking for any Recipes that produce the Item Stack and implement IRecyclableRecipe, and if so try and getting its RecyclingOutputs directly and go to step 4
3. Checking for any other Recipes whose Recipe Types are #petrolpark:recyclable, and trying to find inverses for every Ingredient that Recipe has
4. Applying Recipe Outputs Modifiers to any RecyclingResults from the previous three steps

Ingredient Inverses

This is the Library's solution to there being multiple ways to craft an Item.

Register Recipe Types to Generate RecyclingOutputs For

Implementing IRecyclableRecipe provides the greatest control, but is unnecessary if you will just find the inverses of each Ingredient. If your Recipe is simple like this, you can simply Tag the RecipeType with petrolpark:recyclable. By default minecraft:crafting is the only member of this Tag.

Direct Recycling Recipes

Recycling Outputs Modifiers