Package net.fabricmc.fabric.api.transfer.v1.fluid.base

Class SingleFluidStorage

java.lang.Object

net.fabricmc.fabric.api.transfer.v1.transaction.base.SnapshotParticipant<ResourceAmount<FluidVariant>>

net.fabricmc.fabric.api.transfer.v1.storage.base.SingleVariantStorage<FluidVariant>

net.fabricmc.fabric.api.transfer.v1.fluid.base.SingleFluidStorage

All Implemented Interfaces:

Iterable<StorageView<FluidVariant>>, SingleSlotStorage<FluidVariant>, SlottedStorage<FluidVariant>, Storage<FluidVariant>, StorageView<FluidVariant>, TransactionContext.CloseCallback, TransactionContext.OuterCloseCallback

@Experimental
public abstract class SingleFluidStorage
extends SingleVariantStorage<FluidVariant>

A storage that can store a single fluid variant at any given time. Implementors should at least override getCapacity(FluidVariant), and probably SnapshotParticipant.onFinalCommit() as well for markDirty() and similar calls.

This is a convenient specialization of SingleVariantStorage for fluids that additionally offers methods to read the contents of the storage from NBT.

Experimental feature, we reserve the right to remove or change it without further notice. The transfer API is a complex addition, and we want to be able to correct possible design mistakes.

Field Summary

Fields inherited from class net.fabricmc.fabric.api.transfer.v1.storage.base.SingleVariantStorage

amount, variant

Constructor Summary

Constructors

Constructor	Description
SingleFluidStorage()

Method Summary

Modifier and Type	Method	Description
protected final FluidVariant	getBlankVariant()	Return the blank variant.
void	readNbt(NbtCompound nbt)	Simple implementation of reading from NBT, to match what is written by SingleVariantStorage.writeNbt(net.minecraft.nbt.NbtCompound).
static SingleFluidStorage	withFixedCapacity(long capacity, Runnable onChange)	Create a fluid storage with a fixed capacity and a change handler.

Methods inherited from class net.fabricmc.fabric.api.transfer.v1.storage.base.SingleVariantStorage

canExtract, canInsert, createSnapshot, extract, getAmount, getCapacity, getCapacity, getResource, insert, isResourceBlank, readSnapshot, toString, writeNbt

Methods inherited from class net.fabricmc.fabric.api.transfer.v1.transaction.base.SnapshotParticipant

afterOuterClose, onClose, onFinalCommit, releaseSnapshot, updateSnapshots

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface net.fabricmc.fabric.api.transfer.v1.storage.base.SingleSlotStorage

getSlot, getSlotCount, iterator

Methods inherited from interface net.fabricmc.fabric.api.transfer.v1.storage.SlottedStorage

getSlots

Methods inherited from interface net.fabricmc.fabric.api.transfer.v1.storage.Storage

exactView, getVersion, nonEmptyIterator, nonEmptyViews, simulateExtract, simulateInsert, supportsExtraction, supportsInsertion

Methods inherited from interface net.fabricmc.fabric.api.transfer.v1.storage.StorageView

getUnderlyingView

Constructor Details

SingleFluidStorage

public SingleFluidStorage()

Method Details

withFixedCapacity

public static SingleFluidStorage withFixedCapacity(long capacity,
 Runnable onChange)

Create a fluid storage with a fixed capacity and a change handler.

Parameters:

capacity - Fixed capacity of the fluid storage. Must be non-negative.

onChange - Change handler, generally for markDirty() or similar calls. May not be null.

getBlankVariant

protected final FluidVariant getBlankVariant()

Description copied from class: SingleVariantStorage

Return the blank variant.

Note: this is called very early in the constructor. If fields need to be accessed from this function, make sure to re-initialize SingleVariantStorage.variant yourself.

Specified by:

getBlankVariant in class SingleVariantStorage<FluidVariant>

readNbt

public void readNbt(NbtCompound nbt)

Simple implementation of reading from NBT, to match what is written by SingleVariantStorage.writeNbt(net.minecraft.nbt.NbtCompound). Other formats are allowed, this is just a suggestion.