---
name: set-item-materials
description: Reference for Set's item materials and the grades F to S they decide. Use when listing or downloading the 32 wearable and 24 tool materials with their weights and grades, reading the schema of a material row or of the material object on an item, explaining how a grade is assigned, or finding the rarest materials such as godhair.
license: "Free to use when obtained from set.world, commercially too (the API, what it returns and the skills). Its models, animations and textures, Anima included, are CC BY 4.0: free to use with attribution to Jimmy Lee (j@internet.dev). The source code of Set is © Jimmy Lee under CC BY-NC 4.0 and its commercial use needs a paid waiver."
metadata:
  version: "0.15.35"
  title: Materials
---

# Materials

The material is the word just before the base type in an item's name and the only thing that decides its grade: cotton is always Grade F, godhair always Grade S. Quality, prefix and suffix make an item rarer, never a higher grade. This skill owns the grades.

```sh
curl 'https://set.world/api/tables/material-wearables?format=csv'   # 32 materials for the 11 worn slots
curl 'https://set.world/api/tables/material-tools?format=csv'       # 24 materials for tool and offhand
curl https://set.world/api/rarity/tiers                             # the 7 grade definitions and the grading rule
```

## Schema

Each table is a `TableResponse` ([Item properties](https://set.world/skills/item-properties)) whose rows add `tier`, `grade` and `materialRank`. One of the 24 tool rows:

```json
{ "index": 10, "name": "steel", "weight": 35600, "probability": 0.06244321351018561, "rollFrom": 430998, "rollTo": 466597, "tier": 4, "grade": "C", "materialRank": 9 }
```

On an item, the same facts arrive as:

```ts
type Grade = 'F' | 'E' | 'D' | 'C' | 'B' | 'A' | 'S';
type Material = { name: string; materialRank: number; tier: number; tierGrade: Grade; tierName: string };
```

```json
{ "name": "steel", "materialRank": 9, "tier": 4, "tierGrade": "C", "tierName": "Grade C" }
```

`item.material` is that object, `item.props[2].name` the word, and `item.tier`, `item.tierGrade`, `item.tierName` and `item.materialRank` repeat it at the top level.

The grade definitions themselves:

```ts
type GradeTiersResponse = {                                                  // GET /api/rarity/tiers
  tiers: Array<{ tier: number; grade: Grade; name: string; share: string }>;  // 7 rows; share: the rule and its share of rolls, in prose
  note: string;                                                              // the grading rule, in prose
  rules: { version: 'set-world-0-15-35-material-grades-3'; coverage: number[]; ofAverage: number[] };   // the rule below, as fractions
  gradeRanges: { tools: 24; wearables: 32 };   // materials ranked in each table
};
```

```json
{
  "tiers": [
    { "tier": 1, "grade": "F", "name": "Grade F", "share": "most common materials (top ~22% cumulative weight); ~19.1% of rolls" },
    { "tier": 2, "grade": "E", "name": "Grade E", "share": "next materials to ~39% cumulative weight; ~17.4% of rolls" },
    { "tier": 3, "grade": "D", "name": "Grade D", "share": "next materials to ~63% cumulative weight; ~21.2% of rolls" },
    { "tier": 4, "grade": "C", "name": "Grade C", "share": "next materials to ~90% cumulative weight; ~30.1% of rolls" },
    { "tier": 5, "grade": "B", "name": "Grade B", "share": "rare tail: weight at least 2/5 of its table's average material; ~7.1% of rolls" },
    { "tier": 6, "grade": "A", "name": "Grade A", "share": "rare tail: weight 1/5 to 2/5 of its table's average material; ~3.6% of rolls" },
    { "tier": 7, "grade": "S", "name": "Grade S", "share": "rare tail: weight under 1/5 of its table's average material; ~1.4% of rolls" }
  ],
  "note": "tier is determined solely by material grade: F–C by cumulative weight share of equal-weight groups (22/39/63/90%), then B, A and S by each rare material's weight against its table's average material weight (at least 2/5, 1/5 to 2/5, under 1/5)",
  "rules": { "version": "set-world-0-15-35-material-grades-3", "coverage": [0.22, 0.39, 0.63, 0.9], "ofAverage": [0.4, 0.2] },
  "gradeRanges": { "tools": 24, "wearables": 32 }
}
```

That is the complete response.

## Which table an item uses

`tool` and `offhand` items take their material from `material-tools` (table 3); every other slot from `material-wearables` (table 2).

## The grades

| Grade | Tier | Share of rolls | Wearable materials | Tool materials |
| :---: | :---: | ---: | --- | --- |
| F | 1 | 19.15% | cotton, wool, wooden | wooden, bone |
| E | 2 | 17.36% | bone, stone, copper | stone, copper |
| D | 3 | 21.24% | brass, bronze, linen, iron | brass, bronze, iron |
| C | 4 | 30.15% | leather, chitin, obsidian, cupro, steel, silk, silver, cashmere, orichalcum | obsidian, steel, silver, orichalcum, titanium |
| B | 5 | 7.11% | titanium, gold, platinum, crystal | gold, platinum, crystal |
| A | 6 | 3.55% | mythril, nephrite, iridium, velvet | mythril, nephrite, iridium |
| S | 7 | 1.45% | diamond, adamantite, meteoric, wyrmweave, godhair | diamond, topaz, emerald, sapphire, ruby, adamantite |

Grade S is about 1 roll in 69. A grade attaches per table, so one material can grade differently: bone is E as a wearable and F as a tool; titanium is B as a wearable and C as a tool.

## How a grade is assigned (`set-world-0-15-35-material-grades-3`)

Sort a table's materials by weight, most common first; equal weights share a grade.

- **F, E, D, C** cover the common bulk by cumulative share of the table's weight: up to 22%, 39%, 63% and 90%.
- **B, A, S** grade the rare tail (the last 10%) by each material's weight against the table's average material weight: at least 2/5 is B, from 1/5 to 2/5 is A, under 1/5 is S.

Grades come from the weights, not a hand-written list, so a table edit re-grades it.

## Rank within a table

`materialRank` orders a table's materials by scarcity, 1 the most common, up to 32 (wearables) or 24 (tools). It is not a grade: every Grade S material is equally Grade S. The rarest of each table:

- **Godhair** (wearable, weight 300, rank 32): 1 in 2,802 wearable material rolls, 1 in 4,368 item rolls.
- **Adamantite** (tool, weight 20, rank 24): 1 in 28,506 tool material rolls, 1 in 79,507 item rolls.

## What a grade is worth, and what a material does

In the API a material gives a grade, a rank and one theme channel. The grade sets what an item is worth; the material itself sets how it weighs and looks in Set's own game. Each is owned by one skill:

| A grade sets | Owner |
| --- | --- |
| The orb value, the guarantee price and the salvage value | [Crafting an item](https://set.world/skills/crafting-an-item) |
| The advisory power budget | [Calculations](https://set.world/skills/calculations) |
| The optional stat bonus | [Slots](https://set.world/skills/equipment-slots) |
| Protection and hit power in Set's own game (through its grade score) | [Derived stats](https://set.world/skills/anima-derived-stats) |

| The material itself sets | Owner |
| --- | --- |
| Its weight in Set's own game (its density) | [Derived stats](https://set.world/skills/anima-derived-stats) |
| Its look on a 3D model | [Item models](https://set.world/skills/anima-item-models) |

A hypothetical way to give materials meaning in your own game:

```ts
type MaterialRule = { material: string; kind: 'wearable' | 'tool'; grade: Grade; armor?: number; damage?: number; weight: number };
// { material: 'steel', kind: 'tool', grade: 'C', damage: 1.2, weight: 1 }
```

The derivation and the exact shares: [Algorithms](https://set.world/skills/algorithms), §2.
