Skip to main content

Item Archetype

An item archetype describes the static rules of a cultivation artifact: how much spirit power it stores, how it flies and which abilities it grants.

File Location

Item archetype JSON files go in data/<namespace>/mxt/item_archetype/ within your data pack.

The filename corresponds to its ID. For example, data/example/mxt/item_archetype/bound_sword.json has the ID example:bound_sword.

Fields

FieldTypeDefaultDescription
item_typeStringrequiredThe artifact classification identifier.
spirit_capacityNumberProvider0The spirit power capacity.
storage_slotsNumberProvider0The number of storage slots.
flight_speedNumberProvider0The flight speed. A value of 0 means the artifact provides no flight.
flight_costsList<ResourceCost>[]The flight cost.
granted_abilitiesHolder<ability>[][]The abilities the artifact grants.
refine_actionItemActionno operationThe action run on the holder and on the item when the artifact is refined.

Refine Action

refine_action uses the existing ItemAction dispatch, so a single action or an array of actions may be inlined directly.

Example

{
"item_type": "artifact",
"spirit_capacity": 100,
"storage_slots": 0,
"flight_speed": 0,
"flight_costs": [],
"granted_abilities": ["mxt_test:artifact_guard"]
}

granted_abilities refers to entries of the ability registry described in Ability.