---
name: set-text-flavor
description: Reference for Set's flavor text, the in-world prose the Set World API returns, namely talent flavor, class descriptions and status-effect descriptions, together with the phrases used as names for advantages, disadvantages and item words. Use when showing tooltips, a codex or a character sheet, querying or searching the prose through the API, writing a game's own text in Set's voice, or deciding what the text may and may not be taken to mean.
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: Text flavor
---

# Text flavor

Flavor text is everything in Set that is written to be read by a player rather than computed: the sentence under a talent, the description of a class, the prose of a status effect, and the phrases that name advantages, disadvantages and items. It is data. The API serves all of it, a game may show any of it, and no endpoint gives it a mechanic.

This skill owns the map of where the text lives and the voice it is written in. Each table's own skill owns its rows.

## Where the text lives

| Text | Field | Rows | Endpoint | Part of `contentVersion` | Owner |
| --- | --- | ---: | --- | --- | --- |
| Talent flavor | `flavor` | 288 | `/api/talents` | Yes | [Talents](https://set.world/skills/character-talents) |
| Class description | `flavor` | 155 | `/api/classes` | Yes | [Classes](https://set.world/skills/character-classes) |
| Effect description | `description` | 49 | `/api/effects` | No | [Effects](https://set.world/skills/status-effects) |
| Advantage names | `name` | 144 | `/api/advantages` | Yes | [Advantages](https://set.world/skills/character-advantages) |
| Disadvantage names | `name` | 144 | `/api/disadvantages` | Yes | [Disadvantages](https://set.world/skills/character-disadvantages) |
| Item words: quality, prefix, material, base type, suffix | `name` | 19 tables | `/api/tables` | Yes | [Item properties](https://set.world/skills/item-properties) |

That is 492 written passages (talents, classes and effects) and the names around them. On a rolled character the same text arrives in place: `class.flavor`, `traits.talents[].flavor`, `traits.advantages[].name`, `traits.disadvantages[].name`, and each item's composed `name`.

## Query it

There is no flavor endpoint of its own: the text is the field named above in each table's row, whose schema is in that table's skill.


```sh
curl 'https://set.world/api/classes?mainhand=sword'      # the description of one class
curl 'https://set.world/api/talents?q=blade'             # search talent names and flavor
curl 'https://set.world/api/effects?q=fire'              # search effect names and descriptions
curl 'https://set.world/api/talents?format=csv'          # every talent's flavor: id,name,flavor
```

`q=` matches text anywhere in the name or the prose, ignoring case; the filters are owned by [API connection](https://set.world/skills/api-connection). To hold all of the prose locally, three calls are enough:

```js
const get = async (path) => (await fetch(`https://set.world${path}`)).json();
const codex = [
  ...(await get('/api/talents')).data.map((row) => ({ kind: 'talent', name: row.name, text: row.flavor })),
  ...(await get('/api/classes')).data.map((row) => ({ kind: 'class', name: row.name, text: row.flavor })),
  ...(await get('/api/effects')).data.map((row) => ({ kind: 'effect', name: row.name, text: row.description })),
];
```

## The voice

Set's world speaks like an old monastic rule: plain, grave and measured. Each passage does three things: it names **a concrete act or object**, **an inward discipline**, and **a measured consequence**. The register is borrowed; no scripture, prayer or rule is quoted.

| Text | Shape | Length in the current table |
| --- | --- | --- |
| Talent flavor | One sentence describing a practice, most often opening "The…", then "To…" or "A…". No final full stop | 16 to 42 words |
| Class description | The archetype and its vow, most often naming the class and its mainhand weapon. No final full stop | 16 to 41 words |
| Effect description | One or two sentences of condition language. Every one opens "Let…" and ends in a full stop | 16 to 36 words |

Advantages and disadvantages are short phrases in lower case (`nimble and fleet-footed`, `a mind that teeters on the brink of madness`). Item words are lower case and mostly single words, though some base types take two or three (`hand cannon`, `magic infused plate`); `-` means no word.

### Writing your own text beside it

A game that adds its own talents, classes, effects or lore can match the voice:

- Name a tangible thing or a practised act: a blade, a threshold, ash, counsel, keeping, weighing, bearing witness.
- Hold one small tension: a vow against circumstance, patience against danger, an outward act against an inward duty.
- Keep it to one image. One strong noun beats three adjectives.
- Do not write mock-archaic English ("thee", "doth"), praise ("powerful") or patch notes ("now", "improved").
- Do not put numbers, durations or multipliers in the prose. Rules belong in your rules.

## What the text is not

- **Not a mechanic.** A sentence may read like a rule ("let it not claim the final breath"). No endpoint applies a talent, a class ability or an effect. Set's own game plays the status effects by its own rules ([Effects](https://set.world/skills/status-effects)); the prose is not those rules. What a passage means in your game is your design.
- **Not a label you may rename.** Names are data. An advantage's or disadvantage's stat impact is a hash of its exact name, a class is found by its exact `mainhand`, and item names are composed from exact table words. Show them in any case you like in your interface, but store and send them as returned.
- **Not stable across snapshots.** Talent flavor, class descriptions, trait names and item words are part of `contentVersion`: an edit to any of them moves it. Effect descriptions are reference text outside it. Keep the text with the object you rolled if you need it to stay as it was.
- **Not Set's interface copy.** Buttons, errors and these skills are written plainly. Only the world's own text uses the voice.

## A schema for your game's text

Set's text is English only. A codex that mixes Set's passages with a game's own, and leaves room for translation:

```ts
type CodexEntry = {
  id: string;
  kind: 'talent' | 'class' | 'effect' | 'advantage' | 'disadvantage' | 'item-word' | 'lore';
  name: string;                    // exactly as Set returns it, when it is Set's
  text: string | null;             // null for names that have no prose
  source: 'set' | 'custom';
  contentVersion: string | null;   // the snapshot Set's text was read from
  locale: string;                  // "en" for Set's own text
};
```

```json
{ "id": "class:adventurer", "kind": "class", "name": "Adventurer", "text": "…", "source": "set", "contentVersion": "8.1bmmTgz1B0Y9UKhiu84STg", "locale": "en" }
```

Everything the API returns, this text included, is free to use in a game, commercial ones too ([AGENTS.md](https://set.world/AGENTS.md) has the license).
