Skip to main content

Btcsky Research Node

Research Node

Defines a specific Research Node (recipe/technology).

Fields

FieldTypeDefaultDescription
nodeIdString—Node Identifier
descriptionList<String>emptyDescriptionPlaceholdersColorsMulti-line
iconItem—Node Icon
branchRef<ResearchBranchEntry>—Reference to the parent Branch
powerCostInt10Power required to start the cooking process
pointCostInt0Point Cost (if applicable for unlocking)
fragmentsList<ResearchFragmentConfig>emptyFragments that can be used to generate power
ResearchFragmentConfig (2)
FieldTypeDefaultDescription
itemItem—Fragment Item
powerAmountInt1Power provided by this fragment
inputsList<ResearchInputConfig>emptyInputs required (consumed per operation). Acts like fuel/ingredients.
ResearchInputConfig (2)
FieldTypeDefaultDescription
itemItem—Input Item
amountInt1Amount required
cookingCatalystsList<ResearchCatalystConfig>emptyCooking items (catalysts) that determine duration and efficiency
ResearchCatalystConfig (3)
FieldTypeDefaultDescription
itemItem—Catalyst/Fuel Item. Determines cooking time.
durationSecondsInt10Cooking duration in seconds when using this catalyst
successChanceBonusDouble0.0Success chance bonus (e.g., 5.0 for +5%)
outputItem—Output Item (Result)
extraOutputsList<ResearchOutputConfig>emptyAdditional outputs
ResearchOutputConfig (2)
FieldTypeDefaultDescription
itemItem—Output Item
chanceDouble100.0Chance to obtain (0-100)
durationSecondsInt10Base time in seconds (if no catalyst override)
successChanceDouble100.0Base chance of success (0.0 - 100.0)
xpRewardInt10Experience given to the branch upon successful retrieval
isRepeatableBooleanfalseWhether this research can be repeated multiple times
maxRepeatsInt1Maximum number of times this node can be repeated (if repeatable)
onUnlockList<Ref<TriggerableEntry>>emptyActions to execute when node is successfully researched/claimed
Common TypeWriter fields (displayName, criteria)
FieldTypeDefaultDescription
displayNameString—Display NameColors
criteriaList<Criteria>emptyCriteria requirements to view/access this node

Current behaviour​

The research runtime reads the nodes defined in research.nodes of the main configuration. This entry type is not read by the current code, so a node created here does not appear in the research screens.