Package net.neoforged.neoforge.common.crafting

Class DataComponentIngredient

java.lang.Object

net.neoforged.neoforge.common.crafting.DataComponentIngredient

All Implemented Interfaces:

ICustomIngredient

public class DataComponentIngredient
extends Object
implements ICustomIngredient

Ingredient that matches the given items, performing either a strict or a partial NBT test.

Strict NBT ingredients will only match items that have exactly the provided tag, while partial ones will match if the item's tags contain all of the elements of the provided one, while allowing for additional elements to exist.

Field Summary

Fields

Modifier and Type	Field	Description
static final com.mojang.serialization.MapCodec<DataComponentIngredient>	CODEC
private final DataComponentPredicate	components
private final HolderSet<Item>	items
private final ItemStack[]	stacks
private final boolean	strict

Constructor Summary

Constructors

Constructor	Description
DataComponentIngredient(HolderSet<Item> items, DataComponentPredicate components, boolean strict)

Method Summary

Modifier and Type	Method	Description
DataComponentPredicate	components()
Stream<ItemStack>	getItems()	Returns the list of stacks that this ingredient accepts.
IngredientType<?>	getType()	Returns the type of this ingredient.
boolean	isSimple()	Returns whether this ingredient always requires direct stack testing.
boolean	isStrict()
HolderSet<Item>	items()
static <T> Ingredient	of(boolean strict, Supplier<? extends DataComponentType<? super T>> type, T value, ItemLike... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentMap map, Holder<Item>... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentMap map, HolderSet<Item> items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentMap map, ItemLike... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentPredicate predicate, Holder<Item>... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentPredicate predicate, HolderSet<Item> items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentPredicate predicate, ItemLike... items)	Creates a new ingredient matching any item from the list, containing the given components
static <T> Ingredient	of(boolean strict, DataComponentType<? super T> type, T value, ItemLike... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, ItemStack stack)	Creates a new ingredient matching the given item, containing the given components
boolean	test(ItemStack stack)	Checks if a stack matches this ingredient.

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.common.crafting.ICustomIngredient

toVanilla

Field Details

CODEC

public static final com.mojang.serialization.MapCodec<DataComponentIngredient> CODEC

items

private final HolderSet<Item> items

components

private final DataComponentPredicate components

strict

private final boolean strict

stacks

private final ItemStack[] stacks

Constructor Details

DataComponentIngredient

public DataComponentIngredient(HolderSet<Item> items,
 DataComponentPredicate components,
 boolean strict)

Method Details

test

public boolean test(ItemStack stack)

Description copied from interface: ICustomIngredient

Checks if a stack matches this ingredient. The stack must not be modified in any way.

Specified by:

test in interface ICustomIngredient

Parameters:

stack - the stack to test

Returns:

true if the stack matches this ingredient, false otherwise

getItems

public Stream<ItemStack> getItems()

Description copied from interface: ICustomIngredient

Returns the list of stacks that this ingredient accepts.

The following guidelines should be followed for good compatibility:

• These stacks are generally used for display purposes, and need not be exhaustive or perfectly accurate.
• An exception is ingredients that are simple, for which it is important that the returned stacks correspond exactly to all the accepted Items.
• At least one stack must be returned for the ingredient not to be considered accidentally empty.
• The ingredient should try to return at least one stack with each accepted Item. This allows mods that inspect the ingredient to figure out which stacks it might accept.

Note: no caching needs to be done by the implementation, this is already handled by the ingredient itself.

Specified by:

getItems in interface ICustomIngredient

Returns:

the list of stacks that this ingredient accepts

isSimple

public boolean isSimple()

Description copied from interface: ICustomIngredient

Returns whether this ingredient always requires direct stack testing.

Specified by:

isSimple in interface ICustomIngredient

Returns:

true if this ingredient ignores NBT data when matching stacks, false otherwise

See Also:

• Ingredient.isSimple()

getType

public IngredientType<?> getType()

Description copied from interface: ICustomIngredient

Returns the type of this ingredient.

The type must be registered to NeoForgeRegistries.INGREDIENT_TYPES.

Specified by:

getType in interface ICustomIngredient

Returns:

the type of this ingredient

items

public HolderSet<Item> items()

components

public DataComponentPredicate components()

isStrict

public boolean isStrict()

of

public static Ingredient of(boolean strict,
 ItemStack stack)

Creates a new ingredient matching the given item, containing the given components

of

public static <T> Ingredient of(boolean strict,
 DataComponentType<? super T> type,
 T value,
 ItemLike... items)

Creates a new ingredient matching any item from the list, containing the given components

of

public static <T> Ingredient of(boolean strict,
 Supplier<? extends DataComponentType<? super T>> type,
 T value,
 ItemLike... items)

Creates a new ingredient matching any item from the list, containing the given components

of

public static Ingredient of(boolean strict,
 DataComponentMap map,
 ItemLike... items)

Creates a new ingredient matching any item from the list, containing the given components

of

@SafeVarargs
public static Ingredient of(boolean strict,
 DataComponentMap map,
 Holder<Item>... items)

Creates a new ingredient matching any item from the list, containing the given components

of

public static Ingredient of(boolean strict,
 DataComponentMap map,
 HolderSet<Item> items)

Creates a new ingredient matching any item from the list, containing the given components

of

@SafeVarargs
public static Ingredient of(boolean strict,
 DataComponentPredicate predicate,
 Holder<Item>... items)

Creates a new ingredient matching any item from the list, containing the given components

of

public static Ingredient of(boolean strict,
 DataComponentPredicate predicate,
 ItemLike... items)

Creates a new ingredient matching any item from the list, containing the given components

of

public static Ingredient of(boolean strict,
 DataComponentPredicate predicate,
 HolderSet<Item> items)

Creates a new ingredient matching any item from the list, containing the given components