Discovery Codex Recipe Category

Defines a discovery codex recipe category

清单由 Codex 提供

Manifest entry describing a recipe category displayed in the discovery codex.

字段

字段	类型	默认值	描述
category	String	—	Unique identifier for this recipe category
title	String	—	Title displayed at the top of the recipe category inventory占位符
rows	Int	6	Number of rows for the recipe category inventory (1-6)
order	Int	0	Display order when listing recipe categories
icon	Item	—	Icon used when referencing this recipe category
iconName	String?	—	Optional custom name for the category icon in menus. Placeholders: {unlocked}, {total}占位符
iconLore	List<String>	empty	Optional lore lines for the category icon. Placeholders: {unlocked}, {total}占位符多行
lockedIconLore	List<String>	empty	Lore to display for the icon when the recipe category is locked占位符多行
background	Item?	—	Optional background filler item for the recipe category inventory
itemSlotRange	String	—	Range of slots where recipe entries will be displayed (e.g. '1-25')
startSlot	Int	0	Slot index where recipe entries start (0-based)
fillByRow	Boolean	true	If true, recipe entries fill row by row; otherwise column by column
previousButton	Item?	—	Item used for the previous page button in the recipe category inventory
previousButtonSlot	Int	0	Slot for the previous page button
previousButtonName	String?	—	Custom name for the previous page button占位符
previousButtonLore	List<String>	empty	Lore for the previous page button占位符多行
nextButton	Item?	—	Item used for the next page button in the recipe category inventory
nextButtonSlot	Int	8	Slot for the next page button
nextButtonName	String?	—	Custom name for the next page button占位符
nextButtonLore	List<String>	empty	Lore for the next page button占位符多行
backButton	Item?	—	Item used for the back button in the recipe category inventory
backButtonSlot	Int	44	Slot for the back button (default: 44)
backButtonName	String?	—	Custom name for the back button占位符
backButtonLore	List<String>	empty	Lore for the back button占位符多行
parentCategory	String?	—	Optional parent category identifier
guiLayout	CodexGuiLayout	PAGINATED	GUI layout type for the recipe category menu可选值：PAGINATEDSCROLLABLEFRAMESIMPLE
onUnlockTriggers	List<Ref<TriggerableEntry>>	empty	Triggers to fire when this recipe category is unlocked by a player
items	List<RecipeItemConfig>	empty	Recipes contained within this category RecipeItemConfig（16） 字段 类型 默认值 描述 entryId String — Unique identifier for this recipe entry recipeKey String — Minecraft recipe key (NamespacedKey, e.g. 'minecraft:iron_pickaxe') item Item — Icon displayed when the recipe is unlocked lockedItem Item? — Icon displayed when the recipe is locked lockedLore List<String> empty Lore displayed while the recipe is locked占位符多行 unlockedLore List<String> empty Lore displayed when the recipe is unlocked占位符多行 criteria List<Criteria> empty Criteria that unlock the recipe menuStationSlot Int? — Optional override for the crafting station slot in the detailed recipe menu menuStationItem Item? — Optional override of the crafting station item for this recipe menuStationName String? — Custom name applied to the crafting station item for this recipe占位符 menuStationLore List<String> empty Lore applied to the crafting station item for this recipe占位符多行 menuIndicatorButton Item? — Optional indicator button displayed in the detailed recipe menu for this recipe menuIndicatorButtonSlots List<Int> empty Slots (0-based) where the indicator button will be placed for this recipe menuIndicatorButtonName String? — Custom name applied to the indicator button for this recipe占位符 menuIndicatorButtonLore List<String> empty Lore applied to the indicator button for this recipe占位符多行 onUnlockTriggers List<Ref<TriggerableEntry>> empty Triggers to fire when this specific recipe is unlocked by a player
menuTitle	String	—	Title of the detailed recipe menu displayed when viewing a recipe占位符
menuRows	Int	4	Number of inventory rows for the detailed recipe menu (1-6)
menuBackground	Item?	—	Background filler item for the detailed recipe menu
resultSlot	Int	24	Slot index (0-based) used to display the crafted result
craftingGridSlots	List<Int>	—	Slots used for the 3x3 crafting grid (must contain 9 entries)
menuBackButton	Item?	—	Optional back button item for the detailed recipe menu
menuBackButtonSlot	Int	31	Slot index (0-based) for the detailed recipe back button
menuBackButtonName	String?	—	Custom name for the detailed recipe back button占位符
menuBackButtonLore	List<String>	empty	Lore applied to the detailed recipe back button占位符多行
menuStationSlot	Int	-1	Slot index (0-based) used to display the crafting station for the recipe; set to -1 to disable
menuStationItem	Item?	—	Item shown as the crafting station. Empty = the workstation of the recipe type (crafting table, furnace, smoker, campfire, stonecutter, smithing table)
menuStationName	String?	—	Custom name applied to the crafting station item占位符
menuStationLore	List<String>	empty	Lore applied to the crafting station item占位符多行
menuIndicatorButton	Item?	—	Optional indicator button displayed in the detailed recipe menu
menuIndicatorButtonSlots	List<Int>	empty	Slots (0-based) where the indicator button will be placed
menuIndicatorButtonName	String?	—	Custom name applied to the indicator button占位符
menuIndicatorButtonLore	List<String>	empty	Lore applied to the indicator button占位符多行

TypeWriter 通用字段（criteria）

字段	类型	默认值	描述
criteria	List<Criteria>	empty	Default criteria that unlock recipes in this category

How to use it

Each recipe in items has an entryId and a recipeKey, the namespaced key of a recipe registered on the server (for example minecraft:iron_pickaxe). Clicking an unlocked recipe opens the detail view: the ingredients in craftingGridSlots (nine slots by default) and the result in resultSlot. Shaped, shapeless, furnace-type, stonecutting and smithing recipes are supported.

Recipe criteria fall back to the category criteria when empty. Link the category to a parent with parentCategory, or put the recipe's entryId in a normal category item to open the recipe from there.

The menuStation* and menuIndicator* fields decorate the detail view of a recipe:

• Crafting station — menuStationSlot (-1, the default, disables it), menuStationName and menuStationLore. The item is menuStationItem; when it is empty, the workstation of the recipe type is shown (crafting table, furnace, blast furnace, smoker, campfire, stonecutter or smithing table).
• Indicator — menuIndicatorButton placed in menuIndicatorButtonSlots, with menuIndicatorButtonName and menuIndicatorButtonLore.

Each recipe in items has the same fields, and a value set on the recipe wins over the one of the category. A station slot of -1 on a recipe disables the station decor for that recipe.