Discovery Codex Category

Defines a discovery codex category

ManifestBereitgestellt von Codex

Manifest entry defining a discovery category and its menu layout.

Felder

Feld	Typ	Standard	Beschreibung
category	String	—	Unique identifier for this discovery category
title	String	—	Title displayed at the top of the inventoryPlatzhalter
rows	Int	6	Number of rows for the inventory (1-6)
order	Int	0	Display order when listing categories
icon	Item	—	Icon used when referencing this category
iconName	String?	—	Optional custom name for the icon when displayed in menus. Placeholders: {unlocked}, {locked}, {total}, {percent}Platzhalter
iconLore	List<String>	empty	Optional lore lines for the icon when displayed in menus. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig
lockedIconLore	List<String>	empty	Lore to display for the icon when the category is locked. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig
background	Item?	—	Optional background filler item
itemSlotRange	String	—	Range of slots where discovery items will be displayed (e.g. '1-25')
startSlot	Int	0	Slot index where items start (0-based)
fillByRow	Boolean	true	If true, items fill row by row; otherwise column by column
previousButton	Item?	—	Item used for the previous page button
previousButtonSlot	Int	0	Slot for the previous page button
previousButtonName	String?	—	Custom name for the previous page button. Placeholders: {page}, {max_page}, {unlocked}, {locked}, {total}, {percent}Platzhalter
previousButtonLore	List<String>	empty	Lore for the previous page button. Placeholders: {page}, {max_page}, {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig
nextButton	Item?	—	Item used for the next page button
nextButtonSlot	Int	8	Slot for the next page button
nextButtonName	String?	—	Custom name for the next page button. Placeholders: {page}, {max_page}, {unlocked}, {locked}, {total}, {percent}Platzhalter
nextButtonLore	List<String>	empty	Lore for the next page button. Placeholders: {page}, {max_page}, {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig
backButton	Item?	—	Item used for the back button
backButtonSlot	Int	44	Slot for the back button (default: 44, bottom-right area)
backButtonName	String?	—	Custom name for the back buttonPlatzhalter
backButtonLore	List<String>	empty	Lore for the back buttonPlatzhalterMehrzeilig
infoButton	Item?	—	Item used for the info button
infoButtonSlot	Int	4	Slot for the info button
infoButtonName	String?	—	Custom name for the info button. Placeholders: {unlocked}, {locked}, {total}, {percent}Platzhalter
infoButtonLore	List<String>	empty	Lore for the info button. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig
parentCategory	String?	—	Optional parent category identifier; if set, this category becomes a sub category
items	List<DiscoveryItemConfig>	empty	Items contained within this category DiscoveryItemConfig (10) Feld Typ Standard Beschreibung entryId String — Unique identifier for this discovery item item Item — Base item to display in the codex overrideName String? — Optional display name override. Placeholders: {unlocked}, {locked}, {total}, {percent}Platzhalter overrideLore List<String> empty Lore to override the item's default lore when unlocked. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig overrideOrder Int? — Display order override lockedLore List<String> empty Lore to display when the item is locked. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig unlockedLore List<String> empty Lore to append when the item is unlocked. Placeholders: {unlocked}, {locked}, {total}, {percent}PlatzhalterMehrzeilig criteria List<Criteria> empty Criteria that need to be met for the item to be unlocked (Typewriter facts) lockedItem Item? — Optional item to display when the entry is locked onUnlockTriggers List<Ref<TriggerableEntry>> empty Triggers to fire when this specific item is unlocked by a player
guiLayout	CodexGuiLayout	PAGINATED	GUI layout type for the codex menuWerte:PAGINATEDSCROLLABLEFRAMESIMPLE
onUnlockTriggers	List<Ref<TriggerableEntry>>	empty	Triggers to fire when this category is unlocked by a player
baseMenuId	String	—	Entrée open_gui servant de châssis partagé (ex. menu_shell). Vide = la catégorie s'ouvre en inventaire autonome (comportement historique). Renseigné = la catégorie devient un écran du menu global : son propre plan de slots (itemSlotRange/boutons) doit alors tenir dans la zone de contenu du châssis (rows ≤ 3), pas l'inventaire entier.

Gemeinsame TypeWriter-Felder (criteria)

Feld	Typ	Standard	Beschreibung
criteria	List<Criteria>	empty	Criteria that must be met for this category to be unlocked

How to use it

category is the identifier used by the command, the placeholders and parentCategory, so keep it short and unique. A category that other categories point to with parentCategory shows those sub-categories (and recipe categories) instead of its own items.

• criteria — when not met, the category is locked: its icon uses lockedIconLore and cannot be opened from the parent menu or the global menu.
• items — each item has an entryId, an item shown once unlocked and an optional lockedItem. Its own criteria decide whether it is unlocked; with none, it is always unlocked. overrideName and lockedLore / unlockedLore / overrideLore change the name and lore.
• itemSlotRange — a range such as 10-16, counted from 1. Leave it empty to use startSlot and fillByRow.
• onUnlockTriggers (category and item) — fire once per player when the category or item is first seen unlocked. They need a Codex Unlock artifact.
• baseMenuId — opens the category inside a shared GUI chassis; keep rows at 3 or fewer.

overrideOrder on items sets the rank of an item. An item without a value takes the rank of its position in the list, so overrideOrder = n places the item as if it were at position n. When two items have the same rank, the one higher in the list comes first. With no overrideOrder at all, items appear in the order of the list.