Item Quality

An item quality defines one quality tier that items can carry, together with the modifiers that tier applies to currency value, forging and alchemy.

File Location

Item quality JSON files go in data/<namespace>/mxt/item_quality/ within your data pack.

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

Fields

Field	Type	Default	Description
display_name	Text Component	required	The quality name or translation key.
value_multiplier	Modifier	none	The currency value modifier. The object contains description and modifier. Once configured it is automatically added to the item quality summary.
forging_modifier	Modifier	none	The forging modifier. The object contains description and modifier. Once configured it is automatically added to the item quality summary.
alchemy_modifier	Modifier	none	The alchemy modifier. The object contains description and modifier. Once configured it is automatically added to the item quality summary.
condition	EntityCondition	mxt:always_true	The condition for using this quality.

Modifiers

All three modifier fields are optional objects. The object's description is appended to the item quality tooltip automatically, while modifier is the number provider actually used at runtime.

Example

{
  "display_name": "quality.example.refined",
  "value_multiplier": {
    "description": "quality.example.refined.value",
    "modifier": 1.25
  },
  "forging_modifier": {
    "description": "quality.example.refined.forging",
    "modifier": "1 + level * 0.01"
  }
}

Order and Groups

Quality order and grouping are decided by vanilla tags:

data/mxt/tags/mxt/item_quality/tooltip_order.json
data/<namespace>/tags/mxt/item_quality/group/<name>.json

The order of values in tooltip_order is preserved by ItemQualityService.ordered, and group tags may overlap. The quality_group in a binding table must be a # tag, and an explicit quality component or a forging quality must belong to that group.

Related Formats

Quality entries are referenced by the quality ladder of Forging Blueprint and by Spirit Herb as the default quality of an item.