Source
This page was generated with Wiki Builder. Do not change the format!
Info
Talent Grids on items have Nodes. These nodes have positions in the talent grid's UI, and contain "Steps" (DestinyTalentNodeStepDefinition), one of whom will be the "Current" step. The Current Step determines the visual properties of the node, as well as what the node grants when it is activated. See DestinyTalentGridDefinition for a more complete overview of how Talent Grids work, and how they are used in Destiny 2 (and how they were used in Destiny 1).
Schema
- Schema Type: Definition
- Type: object
Properties
| Name | Type | Description |
|---|---|---|
| nodeIndex | integer:int32 | The index into the DestinyTalentGridDefinition's "nodes" property where this node is located. Used to uniquely identify the node within the Talent Grid. Note that this is content version dependent: make sure you have the latest version of content before trying to use these properties. |
| nodeHash | integer:uint32 | The hash identifier for the node, which unfortunately is also content version dependent but can be (and ideally, should be) used instead of the nodeIndex to uniquely identify the node. The two exist side-by-side for backcompat reasons due to the Great Talent Node Restructuring of Destiny 1, and I ran out of time to remove one of them and standardize on the other. Sorry! |
| row | integer:int32 | The visual "row" where the node should be shown in the UI. If negative, then the node is hidden. |
| column | integer:int32 | The visual "column" where the node should be shown in the UI. If negative, the node is hidden. |
| prerequisiteNodeIndexes | integer:int32[] | Indexes into the DestinyTalentGridDefinition.nodes property for any nodes that must be activated before this one is allowed to be activated. I would have liked to change this to hashes for Destiny 2, but we have run out of time. |
| binaryPairNodeIndex | integer:int32 | At one point, Talent Nodes supported the idea of "Binary Pairs": nodes that overlapped each other visually, and where activating one deactivated the other. They ended up not being used, mostly because Exclusive Sets are almost a superset of this concept, but the potential for it to be used still exists in theory. If this is ever used, this will be the index into the DestinyTalentGridDefinition.nodes property for the node that is the binary pair match to this node. Activating one deactivates the other. |
| autoUnlocks | boolean | If true, this node will automatically unlock when the Talent Grid's level reaches the required level of the current step of this node. |
| lastStepRepeats | boolean | At one point, Nodes were going to be able to be activated multiple times, changing the current step and potentially piling on multiple effects from the previously activated steps. This property would indicate if the last step could be activated multiple times. This is not currently used, but it isn't out of the question that this could end up being used again in a theoretical future. |
| isRandom | boolean | If this is true, the node's step is determined randomly rather than the first step being chosen. |
| randomActivationRequirement | DestinyNodeActivationRequirement:Definition | At one point, you were going to be able to repurchase talent nodes that had random steps, to "re-roll" the current step of the node (and thus change the properties of your item). This was to be the activation requirement for performing that re-roll. The system still exists to do this, as far as I know, so it may yet come back around! |
| isRandomRepurchasable | boolean | If this is true, the node can be "re-rolled" to acquire a different random current step. This is not used, but still exists for a theoretical future of talent grids. |
| steps | DestinyNodeStepDefinition:Definition[] | At this point, "steps" have been obfuscated into conceptual entities, aggregating the underlying notions of "properties" and "true steps". If you need to know a step as it truly exists - such as when recreating Node logic when processing Vendor data - you'll have to use the "realSteps" property below. |
| exclusiveWithNodeHashes | integer:uint32[] | The nodeHash values for nodes that are in an Exclusive Set with this node. See DestinyTalentGridDefinition.exclusiveSets for more info about exclusive sets. Again, note that these are nodeHashes and not nodeIndexes. |
| randomStartProgressionBarAtProgression | integer:int32 | If the node's step is randomly selected, this is the amount of the Talent Grid's progression experience at which the progression bar for the node should be shown. |
| layoutIdentifier | string | A string identifier for a custom visual layout to apply to this talent node. Unfortunately, we do not have any data for rendering these custom layouts. It will be up to you to interpret these strings and change your UI if you want to have custom UI matching these layouts. |
| groupHash | integer:uint32:nullable | As of Destiny 2, nodes can exist as part of "Exclusive Groups". These differ from exclusive sets in that, within the group, many nodes can be activated. But the act of activating any node in the group will cause "opposing" nodes (nodes in groups that are not allowed to be activated at the same time as this group) to deactivate. See DestinyTalentExclusiveGroup for more information on the details. This is an identifier for this node's group, if it is part of one. |
| loreHash | Destiny.Definitions.Lore.DestinyLoreDefinition:integer:uint32:nullable | Talent nodes can be associated with a piece of Lore, generally rendered in a tooltip. This is the hash identifier of the lore element to show, if there is one to be show. |
| nodeStyleIdentifier | string | Comes from the talent grid node style: this identifier should be used to determine how to render the node in the UI. |
| ignoreForCompletion | boolean | Comes from the talent grid node style: if true, then this node should be ignored for determining whether the grid is complete. |
Example
{
// Type: integer:int32
"nodeIndex": 0,
// Type: integer:uint32
"nodeHash": 0,
// Type: integer:int32
"row": 0,
// Type: integer:int32
"column": 0,
// Type: integer:int32[]
"prerequisiteNodeIndexes": [
// Type: integer:int32
0
],
// Type: integer:int32
"binaryPairNodeIndex": 0,
// Type: boolean
"autoUnlocks": false,
// Type: boolean
"lastStepRepeats": false,
// Type: boolean
"isRandom": false,
// Type: DestinyNodeActivationRequirement:Definition
"randomActivationRequirement": {},
// Type: boolean
"isRandomRepurchasable": false,
// Type: DestinyNodeStepDefinition:Definition[]
"steps": [
// Type: DestinyNodeStepDefinition:Definition
{
// Type: DestinyDisplayPropertiesDefinition:Definition
"displayProperties": {},
// Type: integer:int32
"stepIndex": 0,
// Type: integer:uint32
"nodeStepHash": 0,
// Type: string
"interactionDescription": "",
// Type: DamageType:Enum
"damageType": {},
// Type: Destiny.Definitions.DestinyDamageTypeDefinition:integer:uint32:nullable
"damageTypeHash": 0,
// Type: DestinyNodeActivationRequirement:Definition
"activationRequirement": {},
// Type: boolean
"canActivateNextStep": false,
// Type: integer:int32
"nextStepIndex": 0,
// Type: boolean
"isNextStepRandom": false,
// Type: Destiny.Definitions.DestinySandboxPerkDefinition:integer:uint32[]
"perkHashes": [
// Type: integer:uint32
0
],
// Type: integer:int32
"startProgressionBarAtProgress": 0,
// Type: Destiny.Definitions.DestinyStatDefinition:integer:uint32[]
"statHashes": [
// Type: integer:uint32
0
],
// Type: boolean
"affectsQuality": false,
// Type: DestinyTalentNodeStepGroups:Definition
"stepGroups": {},
// Type: boolean
"affectsLevel": false,
// Type: DestinyNodeSocketReplaceResponse:Definition[]
"socketReplacements": [
// Type: DestinyNodeSocketReplaceResponse:Definition
{
// Type: Destiny.Definitions.Sockets.DestinySocketTypeDefinition:integer:uint32
"socketTypeHash": 0,
// Type: Destiny.Definitions.DestinyInventoryItemDefinition:integer:uint32
"plugItemHash": 0
}
]
}
],
// Type: integer:uint32[]
"exclusiveWithNodeHashes": [
// Type: integer:uint32
0
],
// Type: integer:int32
"randomStartProgressionBarAtProgression": 0,
// Type: string
"layoutIdentifier": "",
// Type: integer:uint32:nullable
"groupHash": 0,
// Type: Destiny.Definitions.Lore.DestinyLoreDefinition:integer:uint32:nullable
"loreHash": 0,
// Type: string
"nodeStyleIdentifier": "",
// Type: boolean
"ignoreForCompletion": false
}