Class FluidHandlerItemStackSimple
- java.lang.Object
-
- net.minecraftforge.fluids.capability.templates.FluidHandlerItemStackSimple
-
- All Implemented Interfaces:
ICapabilityProvider,IFluidHandler,IFluidHandlerItem
- Direct Known Subclasses:
FluidHandlerItemStackSimple.Consumable,FluidHandlerItemStackSimple.SwapEmpty
public class FluidHandlerItemStackSimple extends java.lang.Object implements IFluidHandlerItem, ICapabilityProvider
FluidHandlerItemStackSimple is a template capability provider for ItemStacks. Data is stored directly in the vanilla NBT, in the same way as the old ItemFluidContainer. This implementation only allows item containers to be fully filled or emptied, similar to vanilla buckets.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classFluidHandlerItemStackSimple.ConsumableDestroys the container item when it's emptied.static classFluidHandlerItemStackSimple.SwapEmptySwaps the container item for a different one when it's emptied.-
Nested classes/interfaces inherited from interface net.minecraftforge.fluids.capability.IFluidHandler
IFluidHandler.FluidAction
-
-
Field Summary
Fields Modifier and Type Field Description protected intcapacityprotected ItemStackcontainerstatic java.lang.StringFLUID_NBT_KEYprivate LazyOptional<IFluidHandlerItem>holder
-
Constructor Summary
Constructors Constructor Description FluidHandlerItemStackSimple(ItemStack container, int capacity)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancanDrainFluidType(FluidStack fluid)booleancanFillFluidType(FluidStack fluid)FluidStackdrain(int maxDrain, IFluidHandler.FluidAction action)Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.FluidStackdrain(FluidStack resource, IFluidHandler.FluidAction action)Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.intfill(FluidStack resource, IFluidHandler.FluidAction action)Fills fluid into internal tanks, distribution is left entirely to the IFluidHandler.<T> LazyOptional<T>getCapability(Capability<T> capability, Direction facing)Retrieves the Optional handler for the capability requested on the specific side.ItemStackgetContainer()Get the container currently acted on by this fluid handler.FluidStackgetFluid()FluidStackgetFluidInTank(int tank)Returns the FluidStack in a given tank.intgetTankCapacity(int tank)Retrieves the maximum fluid amount for a given tank.intgetTanks()Returns the number of fluid storage units ("tanks") availablebooleanisFluidValid(int tank, FluidStack stack)This function is a way to determine which fluids can exist inside a given handler.protected voidsetContainerToEmpty()Override this method for special handling.protected voidsetFluid(FluidStack fluid)-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface net.minecraftforge.common.capabilities.ICapabilityProvider
getCapability
-
-
-
-
Field Detail
-
FLUID_NBT_KEY
public static final java.lang.String FLUID_NBT_KEY
- See Also:
- Constant Field Values
-
holder
private final LazyOptional<IFluidHandlerItem> holder
-
container
@Nonnull protected ItemStack container
-
capacity
protected int capacity
-
-
Constructor Detail
-
FluidHandlerItemStackSimple
public FluidHandlerItemStackSimple(@Nonnull ItemStack container, int capacity)- Parameters:
container- The container itemStack, data is stored on it directly as NBT.capacity- The maximum capacity of this fluid tank.
-
-
Method Detail
-
getContainer
@Nonnull public ItemStack getContainer()
Description copied from interface:IFluidHandlerItemGet the container currently acted on by this fluid handler. The ItemStack may be different from its initial state, in the case of fluid containers that have different items for their filled and empty states. May be an empty item if the container was drained and is consumable.- Specified by:
getContainerin interfaceIFluidHandlerItem
-
getFluid
@Nonnull public FluidStack getFluid()
-
setFluid
protected void setFluid(FluidStack fluid)
-
getTanks
public int getTanks()
Description copied from interface:IFluidHandlerReturns the number of fluid storage units ("tanks") available- Specified by:
getTanksin interfaceIFluidHandler- Returns:
- The number of tanks available
-
getFluidInTank
@Nonnull public FluidStack getFluidInTank(int tank)
Description copied from interface:IFluidHandlerReturns the FluidStack in a given tank.IMPORTANT: This FluidStack MUST NOT be modified. This method is not for altering internal contents. Any implementers who are able to detect modification via this method should throw an exception. It is ENTIRELY reasonable and likely that the stack returned here will be a copy.
SERIOUSLY: DO NOT MODIFY THE RETURNED FLUIDSTACK
- Specified by:
getFluidInTankin interfaceIFluidHandler- Parameters:
tank- Tank to query.- Returns:
- FluidStack in a given tank. FluidStack.EMPTY if the tank is empty.
-
getTankCapacity
public int getTankCapacity(int tank)
Description copied from interface:IFluidHandlerRetrieves the maximum fluid amount for a given tank.- Specified by:
getTankCapacityin interfaceIFluidHandler- Parameters:
tank- Tank to query.- Returns:
- The maximum fluid amount held by the tank.
-
isFluidValid
public boolean isFluidValid(int tank, @Nonnull FluidStack stack)Description copied from interface:IFluidHandlerThis function is a way to determine which fluids can exist inside a given handler. General purpose tanks will basically always return TRUE for this.- Specified by:
isFluidValidin interfaceIFluidHandler- Parameters:
tank- Tank to query for validitystack- Stack to test with for validity- Returns:
- TRUE if the tank can hold the FluidStack, not considering current state. (Basically, is a given fluid EVER allowed in this tank?) Return FALSE if the answer to that question is 'no.'
-
fill
public int fill(@Nonnull FluidStack resource, IFluidHandler.FluidAction action)Description copied from interface:IFluidHandlerFills fluid into internal tanks, distribution is left entirely to the IFluidHandler.- Specified by:
fillin interfaceIFluidHandler- Parameters:
resource- FluidStack representing the Fluid and maximum amount of fluid to be filled.action- If SIMULATE, fill will only be simulated.- Returns:
- Amount of resource that was (or would have been, if simulated) filled.
-
drain
@Nonnull public FluidStack drain(FluidStack resource, IFluidHandler.FluidAction action)
Description copied from interface:IFluidHandlerDrains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.- Specified by:
drainin interfaceIFluidHandler- Parameters:
resource- FluidStack representing the Fluid and maximum amount of fluid to be drained.action- If SIMULATE, drain will only be simulated.- Returns:
- FluidStack representing the Fluid and amount that was (or would have been, if simulated) drained.
-
drain
@Nonnull public FluidStack drain(int maxDrain, IFluidHandler.FluidAction action)
Description copied from interface:IFluidHandlerDrains fluid out of internal tanks, distribution is left entirely to the IFluidHandler. This method is not Fluid-sensitive.- Specified by:
drainin interfaceIFluidHandler- Parameters:
maxDrain- Maximum amount of fluid to drain.action- If SIMULATE, drain will only be simulated.- Returns:
- FluidStack representing the Fluid and amount that was (or would have been, if simulated) drained.
-
canFillFluidType
public boolean canFillFluidType(FluidStack fluid)
-
canDrainFluidType
public boolean canDrainFluidType(FluidStack fluid)
-
setContainerToEmpty
protected void setContainerToEmpty()
Override this method for special handling. Can be used to swap out the container's item for a different one with "container.setItem". Can be used to destroy the container with "container.stackSize--"
-
getCapability
@Nonnull public <T> LazyOptional<T> getCapability(@Nonnull Capability<T> capability, @Nullable Direction facing)
Description copied from interface:ICapabilityProviderRetrieves the Optional handler for the capability requested on the specific side. The return value CAN be the same for multiple faces. Modders are encouraged to cache this value, using the listener capabilities of the Optional to be notified if the requested capability get lost.- Specified by:
getCapabilityin interfaceICapabilityProvider- Returns:
- The requested an optional holding the requested capability.
-
-