---
name: set-anima-item-models
description: How to view, link and download the 3D model of any Set item. Use when a game needs a mesh for a generated weapon, shield, tool or piece of armor, a link from an item roll to its model in its rolled material, a GLB download of one item and the schema of what the file contains, or the grip, hand and layering rules the models follow.
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: Item models
---

# Item models

Every base type in Set's item tables has one authored 3D model: 155 held tools (the mainhand table; the offhand table reuses 152 of them) and 128 worn pieces across 11 slots. A model shows the item's gear and material. Quality, prefix and suffix have no appearance; what they do is in [Item attributes](https://set.world/skills/anima-item-attributes), and the Lighter and Heavier effects an item's words may grant change the mass its held model is measured at. The models belong to AnimaSystem, Set's own game layer; the API returns names and numbers, never geometry. This skill owns how items are held, worn and exported.

## From an item roll to its model

```ts
type ItemModelRef = { slot: string; gear: string; material: string | null };
const modelOf = (item) => ({ slot: item.slot, gear: item.props[3].name, material: item.props[2].name });
```

```json
{ "slot": "tool", "gear": "sword", "material": "steel" }
```

Never parse the composed name. The inspector takes the same three values as query parameters, and an item's quality, prefix and suffix words beside them:

```text
https://set.world/anima-object-models?<slot>=<gear>&<slot>Material=<material>&<slot>Quality=<quality>&<slot>Prefix=<prefix>&<slot>Suffix=<suffix>&focus=<slot>
https://set.world/anima-object-models?tool=sword&toolMaterial=steel&toolQuality=fine&toolPrefix=burning&toolSuffix=dawn&focus=tool
https://set.world/anima-object-models?chest=padded%20armor&chestMaterial=silk&head=helm&focus=chest
```

One item per slot; `focus` chooses which one the Mesh pane shows alone. Leave out `<slot>Material` for the base white-and-silver look, and any word for none. The words change no geometry; the inspector reads what they do ([Item attributes](https://set.world/skills/anima-item-attributes)). An item's page at `/roll/item/<rolls>` links to its model the same way, words included.

## Download a model

The GLB is built in the browser; there is no static model URL and no model API.

1. Open the item's `/anima-object-models` link.
2. Wait for the **Mesh** pane to show the item, then choose **Download model**.
3. The browser saves `<material>-<gear>.glb` in lower case with each run of spaces and punctuation as one hyphen, for example `steel-sword.glb` or `silk-padded-armor.glb`; with no material chosen it is `<gear>.glb`.

An agent with a browser tool follows the Playwright recipe in [Character models](https://set.world/skills/anima-character-models), with this page's URL; the page has one **Download model** button.

## What the file contains (`set-world-0-15-35-item-export-3`)

| Part | Content |
| --- | --- |
| Geometry | The full authored mesh, with strings, ropes, book covers and pages at rest, and the scroll rolled and tied. In a crowd, items follow the detail rule below |
| Held items | The right-hand model with its origin at the grip. A left-hand copy is a mirror of the geometry |
| Worn items | The piece fitted to Anima's rest pose, unskinned. Hand, wrist and head pieces export one side; a finger item sits on the right ring finger |
| Materials | One standard material per part role, named after its look, with the material's base colour, roughness and metalness. The procedural surface patterns and the wings' feather cut-outs are runtime shaders and textures, and are not in the file |
| Maker mark | The author's wwwjim mark as its own mesh, `wwwjim mark` (`set-world-0-15-35-maker-mark-1`): a small decal on a quiet face of the item, in the item's own material with its normals tilted slightly, so it shows only when light grazes it. Keep it when you use the model; it is part of the credit |
| Not included | A rig, skin weights, animation, cloth simulation, projectiles and effects |

The root node's `extras` identify the item:

```ts
type ItemExportExtras = {
  exportVersion: string; finishVersion: string; makerMarkVersion: string; slot: string; gear: string; material: string | null;
  author: string; contact: string; attribution: string; license: 'CC-BY-4.0'; licenseUrl: string; notice: string;   // the credit to give: attribution
};
```

```json
{ "exportVersion": "set-world-0-15-35-item-export-3", "author": "Jimmy Lee", "contact": "j@internet.dev", "attribution": "Jimmy Lee (j@internet.dev)", "license": "CC-BY-4.0", "licenseUrl": "https://creativecommons.org/licenses/by/4.0/", "notice": "Made by Jimmy Lee (j@internet.dev). Free to use for any purpose, commercially too, under CC BY 4.0, as long as you credit Jimmy Lee (j@internet.dev) wherever you use or share it.", "finishVersion": "set-world-0-15-35-item-finish-47", "makerMarkVersion": "set-world-0-15-35-maker-mark-1", "slot": "tool", "gear": "sword", "material": "steel" }
```

Check the alignment of a worn piece against your imported [Anima](https://set.world/skills/anima-character-models) before relying on it; Set has not tested the files in other engines.

## The catalog

Every base type has a model, so the gear tables are the model list. Load them from `/api/tables` ([Item properties](https://set.world/skills/item-properties)); the materials each slot can take are in [Materials](https://set.world/skills/item-materials).

| Slot | Models | Form |
| --- | ---: | --- |
| tool, offhand | 155 | Rigid held items; some with strings, ropes, chains or pages. The anchor is fouled with a rope that takes the cord look, and is thrown on a heavy chain fastened to its ring. The scroll is turned sideways and its second roller drops, unrolling a blank parchment below the roller held in the fist |
| chest | 27 | Fitted cloth with attached plates |
| head | 29 | Rigid pieces on the head |
| wrist | 13 | Rigid bands and plates |
| legs | 11 | Cloth tubes, skirts and plates |
| shoulders | 9 | Capes, cords, pauldrons, ailettes (a solid heraldic plate hugging each shoulder, or the armour under it) |
| neck | 9 | Ribbons, plates, jewels, chains and a monk's thick prayer beads (no jewel); a necklace chain is placed once, symmetric, at the neck crease behind and in a V in front, resting on the outermost worn layer, and its jewel rests straight down from the bail, so neither bounces |
| finger | 7 | Jewellery and plate on the ring finger |
| hand | 6 | Shells, bands and plates |
| back | 5 | Cloak (a hooded capelet closed at the throat, open in a V at the front, over a long back panel; the arms stay free), cape (the back alone), flag (heraldic), sack, wings (angel wings of many layered feathers rooted beside the spine, arching past the head, the long flight feathers falling nearly to the floor) |
| feet | 7 | Shells with soles; mukluks wrap their shaft in bands of fur |
| waist | 5 | Belt, sash, coil, girdle, pouch (a large pouch at one hip on a thin strap) |

## How items are held and worn

- **Hands.** `tool` goes in the right hand and `offhand` in the left. The first `hand` and `finger` item goes on the right, the second on the left.
- **Layer order, innermost first:** feet, legs, hand, finger, wrist, chest, waist, shoulders, neck, back, head. Each layer is fitted over the ones beneath it.
- **One model everywhere.** The scene, the army, the dungeon, the weapon field, portraits, the inspector and the Anima Preview use the same geometry at full detail.
- **Sub-pixel detail** (`set-world-0-15-35-mesh-detail-3`). A worn item, a held item and the Anima's body may be drawn with fewer triangles, but only by merging vertices inside cells no larger than 2 CSS pixels on screen (cells of 0.006, 0.008, 0.012, 0.016, 0.024, 0.032, 0.048, 0.064, 0.096, 0.128, 0.192 model units), and only between vertices that move together (one cloth patch, one plate, one bone). A shadow caster may merge cells up to 2 shadow-map texels; a mesh drawn both in view and in a shadow takes the finer of its two levels. Chain-mail rings and other small ornaments switch to simpler shapes. Any scene may use this rule. Set's crowds (many Animas in one view) use it in every pass; the temple of `/anima-adventure` uses it only for its floor and pool reflections, drawn at half the CSS resolution, and its shadow maps, so what the viewer sees directly keeps every triangle. The eyes and tattoo keep full detail, and so does every single-Anima close-up; zooming in restores the full mesh.

### Grip families

Each held item attaches to the hand bone in one of 7 frames. The origin sits inside the fist, except for `wrist`.

| Grip | Mainhands that use it |
| --- | ---: |
| `handle` | 122 |
| `fist` | 6 |
| `bow` | 5 |
| `pistol` | 7 |
| `shield` | 9 |
| `palm` | 4 |
| `wrist` | 2 |

| Grip | Tool frame |
| --- | --- |
| `handle` | +Y along the handle past the thumb, +X along the palm (the cutting edge), +Z out of the palm |
| `pistol` | +Y forward along the barrel, +Z up out of the fist |
| `bow` | +Y across the fist, +Z toward the target |
| `shield` | +Y up, +Z away from the palm; the board sits beyond the fingers |
| `fist` | +Y forward past the knuckles, +Z out of the palm |
| `palm` | +Y out of the closed grip, +Z toward the wrist |
| `wrist` | As `fist`, at the wrist |

The left hand holds a mirrored copy of the geometry, never a negatively scaled one. Which grip each item uses is one column of the held-item table in [Derived combat](https://set.world/skills/anima-derived-combat).

## Heraldry (`set-world-0-15-35-heraldry-2`)

Heraldic items are the flag and the ailettes. They carry an Anima's heraldry, and nothing else in an outfit does. Heraldry is AnimaSystem's, not Set's: the API never returns it and a birth never stores it. Your game decides whether an Anima shows heraldry and which, and keeps that choice.

- **Off** (no heraldry): every heraldic item shows its own default, `usa`.
- **On, with a registered preset**: one of the presets below.
- **On, with an image URL**: an image hosted by your game. Set hosts no uploads; upload, moderation and storage are your game's.

| Preset | Name | How it is drawn |
| --- | --- | --- |
| `usa` | United States | Drawn as a pattern |
| `openai` | OpenAI | The logo, centred on its own colour |
| `anthropic` | Anthropic | The logo, centred on its own colour |
| `vmax` | Vmax | The logo, centred on its own colour |
| `grok` | Grok | The logo, centred on its own colour |

```ts
type HeraldryPresetName = 'usa' | 'openai' | 'anthropic' | 'vmax' | 'grok';
type Heraldry = { kind: 'preset'; preset: HeraldryPresetName } | { kind: 'image'; url: string };
type HeraldicOutfit = { items: ItemModelRef[]; heraldry: Heraldry | null }; // null: heraldry off
```

```json
{ "items": [{ "slot": "shoulders", "gear": "ailettes", "material": "leather" }, { "slot": "back", "gear": "flag", "material": null }], "heraldry": { "kind": "preset", "preset": "vmax" } }
```

Every item sidebar ([Scenes](https://set.world/skills/anima-scenes) names the pages) lists the presets in a Heraldry group at its top, with an Image URL field below them. The choice travels in the query as `heraldry=<preset>` or `heraldry=<image URL>`:

```text
https://set.world/anima-object-models?shoulders=ailettes&back=flag&focus=shoulders&heraldry=vmax
```

- **Image URLs.** Only `https` or `http` addresses of at most 2048 characters are accepted. The image is loaded with cross-origin access, so its host must send `Access-Control-Allow-Origin`; an image that cannot load leaves the heraldic items showing a plain white field. It is fitted whole inside the board or flag, keeping its proportions, and drawn in its own colours.
- **Presets** are drawn in their own colours; a logo is tinted its preset's colour and fitted, centred and keeping its proportions, inside 62% of the board's or flag's width and height.
- **One heraldry per Anima.** Every heraldic item an Anima wears shows the same heraldry.
- **Material.** The heraldic face (the flag's cloth, each ailette's board) shows the heraldry, never the rolled material; the rest of the flag (its pole and straps) takes the rolled material. An ailette's face and edges show the heraldry and its back shows the rolled material; the image never shows from behind.
- **Teams.** In the army, and on `/anima-stratagem`, `/anima-battle` and `/anima-battle-effects` when the sidebar names none, each team carries a preset: Team A `openai`, Team B `anthropic`, neutral Animas `usa`. In `/anima-scene`, a team designed by a model carries its maker's preset, a team imported from a battle file each Anima's own heraldry from the file (the default when it has none), and a totally-random team and every neutral Anima the default, `usa` ([Scenes](https://set.world/skills/anima-scenes)). A placement may name its own heraldry instead, as each side of `/anima-stratagem` and each Anima of `/anima-battle` does when its sidebar has one.
- **Orientation.** A flag hangs with its pattern turned upright down its length. Each ailette is a solid plate resting on its shoulder, the top of its image toward the neck and reading the right way round from outside.

## Material looks

Each material names a look for four part roles: fabric, solid, trim and inlay. Bow and harp strings and the anchor's rope are always cord, and book pages parchment. Common materials are matte and coarse; rare ones are smoother, with sheen, iridescence or a faint glow. What a material weighs and how it protects or hits is in [Derived stats](https://set.world/skills/anima-derived-stats).

## A schema for item assets in your game

```ts
type ItemAsset = {
  key: string;                     // "tool:sword:steel"
  ref: ItemModelRef;
  file: string;                    // where you stored the GLB
  hand: 'right' | 'left' | null;   // held items; mirror the geometry for the left
  layer: number | null;            // worn items: position in the layer order
  exportVersion: string;           // re-download when it changes
};
```

## Source

A model downloaded from set.world is CC BY 4.0 and carries its credit ([Character models](https://set.world/skills/anima-character-models#credit-it) says what to credit and where the file states it). The builders are part of Set's source code: `three-isometric-engine/weapons/` (catalog, meshes, grips), `three-isometric-engine/armor/` (worn pieces, cloth) and `three-isometric-engine/items/` (assembly, materials, export). Dimensions and fitting rules are §13.35 to §13.63, §13.66 and §13.68 of the reference ([Algorithms](https://set.world/skills/algorithms)). The heraldry logos (OpenAI, Anthropic, Vmax and Grok) are trademarks of their owners.
