Destiny.Milestones.DestinyMilestone
Represents a runtime instance of a user's milestone status. Live Milestone data should be combined with DestinyMilestoneDefinition data to show the user a picture of what is available for them to do in the game, and their status in regards to said "things to do." Consider it a big, wonky to-do list, or Advisors 3.0 for those who remember the Destiny 1 API.
Type: object
Object Properties
milestoneHash
Mapped to Definition
The unique identifier for the Milestone. Use it to look up the DestinyMilestoneDefinition, so you can combine the other data in this contract with static definition data.
Type: uint32
Mapped to Manifest Database Definition:
Destiny.Definitions.Milestones.DestinyMilestoneDefinition
availableQuests
Indicates what quests are available for this Milestone. Usually this will be only a single Quest, but some quests have multiple available that you can choose from at any given time. All possible quests for a milestone can be found in the DestinyMilestoneDefinition, but they must be combined with this Live data to determine which one(s) are actually active right now. It is possible for Milestones to not have any quests.
Type: array
Array Contents:
Destiny.Milestones.DestinyMilestoneQuest
activities
The currently active Activities in this milestone, when the Milestone is driven by Challenges.
Not all Milestones have Challenges, but when they do this will indicate the Activities and Challenges under those Activities related to this Milestone.
Not all Milestones have Challenges, but when they do this will indicate the Activities and Challenges under those Activities related to this Milestone.
Type: array
Array Contents:
Destiny.Milestones.DestinyMilestoneChallengeActivity
values
Milestones may have arbitrary key/value pairs associated with them, for data that users will want to know about but that doesn't fit neatly into any of the common components such as Quests. A good example of this would be - if this existed in Destiny 1 - the number of wins you currently have on your Trials of Osiris ticket. Looking in the DestinyMilestoneDefinition, you can use the string identifier of this dictionary to look up more info about the value, including localized string content for displaying the value. The value in the dictionary is the floating point number. The definition will tell you how to format this number.
Type: object
Dictionary Contents:
float
Dictionary Key Type:
string
vendorHashes
Mapped to Definition
A milestone may have one or more active vendors that are "related" to it (that provide rewards, or that are the initiators of the Milestone). I already regret this, even as I'm typing it. [I told you I'd regret this] You see, sometimes a milestone may be directly correlated with a set of vendors that provide varying tiers of rewards. The player may not be able to interact with one or more of those vendors. This will return the hashes of the Vendors that the player *can* interact with, allowing you to show their current inventory as rewards or related items to the Milestone or its activities.
Before we even use it, it's already deprecated! How much of a bummer is that? We need more data.
Before we even use it, it's already deprecated! How much of a bummer is that? We need more data.
Type: array
Array Contents:
uint32
Mapped to Manifest Database Definition:
Destiny.Definitions.DestinyVendorDefinition
vendors
Replaces vendorHashes, which I knew was going to be trouble the day it walked in the door. This will return not only what Vendors are active and relevant to the activity (in an implied order that you can choose to ignore), but also other data - for example, if the Vendor is featuring a specific item relevant to this event that you should show with them.
Type: array
Array Contents:
Destiny.Milestones.DestinyMilestoneVendor
rewards
If the entity to which this component is attached has known active Rewards for the player, this will detail information about those rewards, keyed by the RewardEntry Hash. (See DestinyMilestoneDefinition for more information about Reward Entries) Note that these rewards are not for the Quests related to the Milestone. Think of these as "overview/checklist" rewards that may be provided for Milestones that may provide rewards for performing a variety of tasks that aren't under a specific Quest.
Type: array
Array Contents:
Destiny.Milestones.DestinyMilestoneRewardCategory
startDate
Nullable
If known, this is the date when the event last began or refreshed. It will only be populated for events with fixed and repeating start and end dates.
Type: date-time
endDate
Nullable
If known, this is the date when the event will next end or repeat. It will only be populated for events with fixed and repeating start and end dates.
Type: date-time
order
Used for ordering milestones in a display to match how we order them in BNet. May pull from static data, or possibly in the future from dynamic information.
Type: int32