Files
EnderIO/src/main/java/crazypants/enderio/machine/IMachineRecipe.java
T
Alexdoru 0920bf28d6 Change default connection mode of fluid conduits (#134)
* update bs

* change default connection mode of fluid conduits

* fix imports
2023-09-28 20:45:53 +02:00

115 lines
3.4 KiB
Java

package crazypants.enderio.machine;
import java.util.List;
import net.minecraft.item.ItemStack;
import net.minecraftforge.fluids.FluidStack;
import crazypants.enderio.machine.recipe.RecipeBonusType;
/**
* A MachineRecipe implementation must be stateless, always returning the same values given the same parameters. The 'in
* progress' recipe for a machine is stored to and retrieved from a machines TileEntity soley based on its UID.
*
* @author cp
*/
public interface IMachineRecipe {
/**
* Returns the globally unique ID for the recipe.
*
* @return
*/
String getUid();
/**
* The amount total number of MJ required to craft the recipe based on the inputs. The amount returned should be for
* a single 'cycle' of the recipe. For examples, if the inputs would allow the recipe to completed 10 times, this
* method should only return the amount of energy used for a single cycle.
*
* @param inputs
* @return
*/
int getEnergyRequired(MachineRecipeInput... inputs);
/**
* Returns the how bonus should be handled for this input
**/
RecipeBonusType getBonusType(MachineRecipeInput... inputs);
/**
* Only returns true if output can be generated using these inputs. If partially complete inputs are provided (for
* example only one of two required inputs are present) the method should return false.
*
* @param inputs
* @return
*/
public boolean isRecipe(MachineRecipeInput... inputs);
/**
* Returns the output from a single 'cycle' of the recipe (even if the inputs would allow the recipe to be crafted
* several times).
* <p>
* This method must not return null. If no output is generated an empty array should be returned.
*
* @param randomChance a random number to be used as a seed for determining whether '% chance' outputs are returned.
* This value is in the range 0-1.
* @param inputs
* @return
*/
ResultStack[] getCompletedResult(float randomChance, MachineRecipeInput... inputs);
/**
* Returns the experience a user gains when this recipe has generated the specified output. If the output is the
* result of several recipe cycles, the accumulated total of experience gained for all cycles should be returned.
*
* @param output
* @return
*/
float getExperienceForOutput(ItemStack output);
/**
* Should return true if the specified parameter is can be used in this recipe.
*
* @param input
* @return
*/
boolean isValidInput(MachineRecipeInput input);
/**
* The name of the machine this recipe can be crafted by.
*
* @return
*/
String getMachineName();
/**
* Returns the quantity of inputs consumed by a single cycle of the recipe.
*
* @param inputs
* @return
*/
List<MachineRecipeInput> getQuantitiesConsumed(MachineRecipeInput[] inputs);
public static class ResultStack {
public final ItemStack item;
public final FluidStack fluid;
public ResultStack(ItemStack item, FluidStack fluid) {
this.item = item;
this.fluid = fluid;
}
public ResultStack(ItemStack item) {
this.item = item;
this.fluid = null;
}
public ResultStack(FluidStack fluid) {
this.item = null;
this.fluid = fluid;
}
}
}