Materials Reference

Materials are raw and processed resources — the building blocks for crafting equipment. Each material type lives in its own sub-folder under data/items/materials/.

Material Types

Type (meta value)	Folder	Description
ore	data/items/materials/ores/	Raw, unprocessed minerals
ingot	data/items/materials/ingots/	Smelted/refined metals
alloy	data/items/materials/alloys/	Combined composite materials
circuit	data/items/materials/circuits/	Electronic components
crystal	data/items/materials/crystals/	Energy crystals
item	data/items/materials/bio/	Organic/biological materials

JSON Shape

{
  "displayName": "items.materials.mypack.ores.iron",
  "description": "items.materials.mypack.ores.iron.desc",
  "texture": "mypack/assets/textures/materials/ore/iron.png",
  "meta": "ore",
  "storeCategory": "ores",
  "storePrice": 100,
  "storeSellValue": 50,
  "storeShowWeight": 10,
  "storeFeaturedDiscountPercentage": 0.0,
  "storeFeaturedShowWeight": 0
}

Field Reference

Field	Type	Required	Description
displayName	string (lang key)	✅	Registry key for the item display name.
description	string (lang key)	✅	Registry key for the item description.
texture	string (path)	✅	Path to the PNG texture, relative to the pack root. See Textures.
meta	string	✅	Material type slug. Must match the sub-folder: ore, ingot, alloy, circuit, crystal, or item (for bio).
storeCategory	string	✅	Store section this item appears under. See Appendix A of the layout spec.
storePrice	integer	✅	Buy price in the in-game store.
storeSellValue	integer	✅	Sell price returned to the player.
storeShowWeight	integer	✅	Relative probability of appearing in the store listing. 0 = never shown.
storeFeaturedDiscountPercentage	float (0–1)	No	Discount applied when featured. 0.0 = no discount.
storeFeaturedShowWeight	integer	No	Probability of appearing in the featured listing. 0 = never featured.

Example — Ore

{
  "displayName": "items.materials.mypack.ores.uranium",
  "description": "items.materials.mypack.ores.uranium.desc",
  "texture": "mypack/assets/textures/materials/ore/uranium.png",
  "meta": "ore",
  "storeCategory": "ores",
  "storePrice": 250,
  "storeSellValue": 100,
  "storeShowWeight": 8,
  "storeFeaturedDiscountPercentage": 0.0,
  "storeFeaturedShowWeight": 0
}

Example — Ingot

{
  "displayName": "items.materials.mypack.ingots.uranium",
  "description": "items.materials.mypack.ingots.uranium.desc",
  "texture": "mypack/assets/textures/materials/ingot/uranium.png",
  "meta": "ingot",
  "storeCategory": "ingots",
  "storePrice": 600,
  "storeSellValue": 250,
  "storeShowWeight": 5
}

Example — Circuit

{
  "displayName": "items.materials.mypack.circuits.logic_board",
  "description": "items.materials.mypack.circuits.logic_board.desc",
  "texture": "mypack/assets/textures/materials/circuits/logic_board.png",
  "meta": "circuit",
  "storeCategory": "circuits",
  "storePrice": 800,
  "storeSellValue": 300,
  "storeShowWeight": 4
}

Material Flow

Ore  →  Recipe  →  Ingot  →  Recipe  →  Alloy  →  Recipe  →  Equipment
Bio drop from enemy  →  Recipe  →  Component  →  Recipe  →  Equipment

Language Keys

"items.materials.mypack.ores.uranium":        "Uranium Ore",
"items.materials.mypack.ores.uranium.desc":   "A radioactive ore found in deep asteroid fields.",
"items.materials.mypack.ingots.uranium":      "Uranium Ingot",
"items.materials.mypack.ingots.uranium.desc": "Refined uranium, ready for high-energy applications."