Discovery Category
The Discovery Codex Definition defines a category of unlockable items (e.g., "Fishing Log", "Monster Bestiary"). It controls the menu layout and the criteria for unlocking the category itself.
Configuration
category — String
Unique identifier for this discovery category.
title — String
Title displayed at the top of the GUI.
rows — Int
Number of rows for the inventory GUI (1-6).
parentCategory — String
Optional ID of a parent category, creating a hierarchy.
Display & Icon
icon — Item
Icon used when referencing this category in a main menu.
iconName — String
Custom display name for the icon.
iconLore
"> Lore lines for the icon.
lockedIconLore
"> Lore displayed if the category itself is locked for the player.
criteria
"> Conditions required for the player to access this category.
Layout Settings
background — Item
Optional filler item for empty slots.
itemSlotRange
"> Specific slots where items can appear.
fillByRow — Boolean
If true, items fill row-by-row. If false, column-by-column.
navigationButtons — NavigationConfig
Configuration for Previous, Next, Back, and Info buttons.
Items Configuration
The items list defines what can be unlocked in this category.
entryId — String
Unique ID for this discovery entry.
item — Item
The item to display when unlocked.
criteria
">
The conditions that trigger the unlock (e.g. has_item, killed_mob).
lockedItem — Item
Item to display when not yet discovered (e.g. bedrock or question mark).
unlockedLore
"> Lore appended when unlocked.
lockedLore
"> Lore displayed when locked.