Class FluidTank
java.lang.Object
net.neoforged.neoforge.fluids.capability.templates.FluidTank
- All Implemented Interfaces:
IFluidHandler
,IFluidTank
Flexible implementation of a Fluid Storage object. NOT REQUIRED.
- Author:
- King Lemming
-
Nested Class Summary
Nested classes/interfaces inherited from interface net.neoforged.neoforge.fluids.capability.IFluidHandler
IFluidHandler.FluidAction
-
Field Summary
Modifier and TypeFieldDescriptionprotected int
protected FluidStack
protected Predicate
<FluidStack> -
Constructor Summary
ConstructorDescriptionFluidTank
(int capacity) FluidTank
(int capacity, Predicate<FluidStack> validator) -
Method Summary
Modifier and TypeMethodDescriptiondrain
(int maxDrain, IFluidHandler.FluidAction action) Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.drain
(FluidStack resource, IFluidHandler.FluidAction action) Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.int
fill
(FluidStack resource, IFluidHandler.FluidAction action) Fills fluid into internal tanks, distribution is left entirely to the IFluidHandler.int
getFluid()
int
getFluidInTank
(int tank) Returns the FluidStack in a given tank.int
getSpace()
int
getTankCapacity
(int tank) Retrieves the maximum fluid amount for a given tank.int
getTanks()
Returns the number of fluid storage units ("tanks") availableboolean
isEmpty()
boolean
isFluidValid
(int tank, FluidStack stack) This function is a way to determine which fluids can exist inside a given handler.boolean
isFluidValid
(FluidStack stack) protected void
readFromNBT
(HolderLookup.Provider lookupProvider, CompoundTag nbt) setCapacity
(int capacity) void
setFluid
(FluidStack stack) setValidator
(Predicate<FluidStack> validator) writeToNBT
(HolderLookup.Provider lookupProvider, CompoundTag nbt)
-
Field Details
-
validator
-
fluid
-
capacity
protected int capacity
-
-
Constructor Details
-
FluidTank
public FluidTank(int capacity) -
FluidTank
-
-
Method Details
-
setCapacity
-
setValidator
-
isFluidValid
- Specified by:
isFluidValid
in interfaceIFluidTank
- Parameters:
stack
- Fluidstack holding the Fluid to be queried.- Returns:
- If the tank can hold the fluid (EVER, not at the time of query).
-
getCapacity
public int getCapacity()- Specified by:
getCapacity
in interfaceIFluidTank
- Returns:
- Capacity of this fluid tank.
-
getFluid
- Specified by:
getFluid
in interfaceIFluidTank
- Returns:
- FluidStack representing the fluid in the tank, null if the tank is empty.
-
getFluidAmount
public int getFluidAmount()- Specified by:
getFluidAmount
in interfaceIFluidTank
- Returns:
- Current amount of fluid in the tank.
-
readFromNBT
-
writeToNBT
-
getTanks
public int getTanks()Description copied from interface:IFluidHandler
Returns the number of fluid storage units ("tanks") available- Specified by:
getTanks
in interfaceIFluidHandler
- Returns:
- The number of tanks available
-
getFluidInTank
Description copied from interface:IFluidHandler
Returns 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:
getFluidInTank
in 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:IFluidHandler
Retrieves the maximum fluid amount for a given tank.- Specified by:
getTankCapacity
in interfaceIFluidHandler
- Parameters:
tank
- Tank to query.- Returns:
- The maximum fluid amount held by the tank.
-
isFluidValid
Description copied from interface:IFluidHandler
This 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:
isFluidValid
in 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
Description copied from interface:IFluidHandler
Fills fluid into internal tanks, distribution is left entirely to the IFluidHandler.- Specified by:
fill
in interfaceIFluidHandler
- Specified by:
fill
in interfaceIFluidTank
- 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
Description copied from interface:IFluidHandler
Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.- Specified by:
drain
in interfaceIFluidHandler
- Specified by:
drain
in interfaceIFluidTank
- 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
Description copied from interface:IFluidHandler
Drains fluid out of internal tanks, distribution is left entirely to the IFluidHandler.This method is not Fluid-sensitive.
- Specified by:
drain
in interfaceIFluidHandler
- Specified by:
drain
in interfaceIFluidTank
- 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.
-
onContentsChanged
protected void onContentsChanged() -
setFluid
-
isEmpty
public boolean isEmpty() -
getSpace
public int getSpace()
-