Package net.neoforged.neoforge.transfer.item

Class ItemStacksResourceHandler

java.lang.Object

net.neoforged.neoforge.transfer.StacksResourceHandler<ItemStack,ItemResource>

net.neoforged.neoforge.transfer.item.ItemStacksResourceHandler

All Implemented Interfaces:

ValueIOSerializable, ResourceHandler<ItemResource>

public class ItemStacksResourceHandler
extends StacksResourceHandler<ItemStack,ItemResource>

Base implementation of a ResourceHandler<ItemResource> backed by a list of ItemStacks.

The following methods will typically be overridden:

• (optional) StacksResourceHandler.isValid(int, T) to limit which resources are allowed in this handler; by default any resource is allowed.
• (optional) getCapacity(int, net.neoforged.neoforge.transfer.item.ItemResource) to specify the capacity of this handler; by default the maximum stack size is used.
• (recommended) StacksResourceHandler.onContentsChanged(int, S) to react to changes in this handler, for example to trigger setChanged().

See Also:

• StacksResourceHandler

Field Summary

Fields inherited from class net.neoforged.neoforge.transfer.StacksResourceHandler

codec, emptyStack, stacks, VALUE_IO_KEY

Constructor Summary

Constructors

Constructor	Description
ItemStacksResourceHandler(int size)
ItemStacksResourceHandler(NonNullList<ItemStack> stacks)

Method Summary

Modifier and Type	Method	Description
protected ItemStack	copyOf(ItemStack stack)	Creates a copy of a stack, for use as a snapshot.
int	getAmountFrom(ItemStack stack)	Retrieves the amount from a stack.
protected int	getCapacity(int index, ItemResource resource)	Return the maximum capacity of this handler for the passed resource.
ItemResource	getResourceFrom(ItemStack stack)	Retrieves the resource from a stack.
protected ItemStack	getStackFrom(ItemResource resource, int amount)	Creates a stack from a resource and an amount.
boolean	matches(ItemStack stack, ItemResource resource)	Checks if the passed resource corresponds to the stack.

Methods inherited from class net.neoforged.neoforge.transfer.StacksResourceHandler

copyToList, deserialize, extract, getAmountAsLong, getCapacityAsLong, getResource, insert, isValid, onContentsChanged, serialize, set, size

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.neoforged.neoforge.transfer.ResourceHandler

extract, getAmountAsInt, getCapacityAsInt, insert

Constructor Details

ItemStacksResourceHandler

public ItemStacksResourceHandler(int size)

ItemStacksResourceHandler

public ItemStacksResourceHandler(NonNullList<ItemStack> stacks)

Method Details

getResourceFrom

public ItemResource getResourceFrom(ItemStack stack)

Description copied from class: StacksResourceHandler

Retrieves the resource from a stack. In the case of an ItemStack an ItemResource would be returned for example.

Specified by:

getResourceFrom in class StacksResourceHandler<ItemStack,ItemResource>

getAmountFrom

public int getAmountFrom(ItemStack stack)

Description copied from class: StacksResourceHandler

Retrieves the amount from a stack. In the case of an ItemStack the count would be returned for example.

Specified by:

getAmountFrom in class StacksResourceHandler<ItemStack,ItemResource>

getStackFrom

protected ItemStack getStackFrom(ItemResource resource,
 int amount)

Description copied from class: StacksResourceHandler

Creates a stack from a resource and an amount.

If the stack would be empty, consider returning StacksResourceHandler.emptyStack instead of creating a new empty stack instance.

Specified by:

getStackFrom in class StacksResourceHandler<ItemStack,ItemResource>

getCapacity

protected int getCapacity(int index,
 ItemResource resource)

Description copied from class: StacksResourceHandler

Return the maximum capacity of this handler for the passed resource. If the passed resource is empty, an estimate should be returned.

Specified by:

getCapacity in class StacksResourceHandler<ItemStack,ItemResource>

Returns:

The maximum capacity of this handler for the passed resource.

copyOf

protected ItemStack copyOf(ItemStack stack)

Description copied from class: StacksResourceHandler

Creates a copy of a stack, for use as a snapshot.

If using an immutable stack type such as ResourceStack, it can be returned as is. In the case of a mutable stack type such as an item or fluid stack, a copy should be returned.

Specified by:

copyOf in class StacksResourceHandler<ItemStack,ItemResource>

matches

public boolean matches(ItemStack stack,
 ItemResource resource)

Description copied from class: StacksResourceHandler

Checks if the passed resource corresponds to the stack.

Overrides:

matches in class StacksResourceHandler<ItemStack,ItemResource>

Parameters:

stack - the stack, usually the current stored value

resource - the resource, usually the received value in insert or extract

Returns:

true if the stack and resource match; false otherwise.