51 lines
1.7 KiB
Java
51 lines
1.7 KiB
Java
package cofh.api.energy;
|
|
|
|
import net.minecraft.item.ItemStack;
|
|
|
|
/**
|
|
* Implement this interface on Item classes that support external manipulation of their internal energy storages.
|
|
*
|
|
* A reference implementation is provided {@link ItemEnergyContainer}.
|
|
*
|
|
* @author King Lemming
|
|
*
|
|
*/
|
|
public interface IEnergyContainerItem {
|
|
|
|
/**
|
|
* Adds energy to an item. Returns the quantity of energy that was accepted. This should always return 0 if the item cannot be externally charged.
|
|
*
|
|
* @param container
|
|
* ItemStack to be charged.
|
|
* @param maxReceive
|
|
* Maximum amount of energy to be sent into the item.
|
|
* @param simulate
|
|
* If TRUE, the charge will only be simulated.
|
|
* @return Amount of energy that was (or would have been, if simulated) received by the item.
|
|
*/
|
|
int receiveEnergy(ItemStack container, int maxReceive, boolean simulate);
|
|
|
|
/**
|
|
* Removes energy from an item. Returns the quantity of energy that was removed. This should always return 0 if the item cannot be externally discharged.
|
|
*
|
|
* @param container
|
|
* ItemStack to be discharged.
|
|
* @param maxExtract
|
|
* Maximum amount of energy to be extracted from the item.
|
|
* @param simulate
|
|
* If TRUE, the discharge will only be simulated.
|
|
* @return Amount of energy that was (or would have been, if simulated) extracted from the item.
|
|
*/
|
|
int extractEnergy(ItemStack container, int maxExtract, boolean simulate);
|
|
|
|
/**
|
|
* Get the amount of energy currently stored in the item.
|
|
*/
|
|
int getEnergyStored(ItemStack container);
|
|
|
|
/**
|
|
* Get the max amount of energy that can be stored in the item.
|
|
*/
|
|
int getMaxEnergyStored(ItemStack container);
|
|
|
|
}
|