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 DataComponentExactPredicate	components
private final HolderSet<Item>	items
private final ItemStack[]	stacks
private final boolean	strict

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
DataComponentExactPredicate	components()
SlotDisplay	display()	Returns the display for this ingredient.
IngredientType<?>	getType()	Returns the type of this ingredient.
boolean	isSimple()	Returns whether this ingredient always requires direct stack testing.
boolean	isStrict()
Stream<Holder<Item>>	items()	Returns the list of items that this ingredient accepts.
HolderSet<Item>	itemSet()
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, DataComponentExactPredicate predicate, Holder<Item>... items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentExactPredicate predicate, HolderSet<Item> items)	Creates a new ingredient matching any item from the list, containing the given components
static Ingredient	of(boolean strict, DataComponentExactPredicate predicate, 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 <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 DataComponentExactPredicate components

strict

private final boolean strict

stacks

private final ItemStack[] stacks

Constructor Details

DataComponentIngredient

public DataComponentIngredient(HolderSet<Item> items,
 DataComponentExactPredicate 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

items

public Stream<Holder<Item>> items()

Description copied from interface: ICustomIngredient

Returns the list of items that this ingredient accepts.

The following guidelines should be followed for good compatibility:

• At least one item must be returned for the ingredient not to be considered empty. Empty ingredients invalidate the entire recipe.
• The ingredient should return all Items it might possible accept. This allows mods that inspect the ingredient to figure out which stacks it might accept.
• Returned items might not always be accepted by the ingredient, as an ingredient might still perform additional NBT-dependent tests.
• An exception is ingredients that are simple, for which testing a stack is equivalent to testing if the item is in the returned list.

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

Specified by:

items in interface ICustomIngredient

Returns:

the list of items 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

display

public SlotDisplay display()

Description copied from interface: ICustomIngredient

Returns the display for this ingredient.

The display is synced to the client, and is also used to retrieve the ItemStacks that are shown to the client.

Specified by:

display in interface ICustomIngredient

itemSet

public HolderSet<Item> itemSet()

components

public DataComponentExactPredicate 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,
 DataComponentExactPredicate 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,
 DataComponentExactPredicate predicate,
 ItemLike... items)

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

of

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

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