Roll an item

Draw from the world’s weighted tables. Every item comes with its grade, material, and orb value.

API reference

Use this to summon one item from the weighted tables at no cost, reproducibly when a seed is given. The forge makes one at a time, so expand an army from one integer with deriveSeed and call once per soul.

Returns
the item enriched with its grade, material, orb value, a breakdown row, the seed that produced it, and the contentVersion that snapshot resolves against.
Parameters
seed?

Open endpoint ↗

Roll a character

Bring forth a character with a class, traits, attributes, and a full set of equipment.

API reference

Use this to generate one character with its stats, equipment, traits, and derived values. Pass equipmentBonus=1 for the optional gear approximation; by default finalStats equals modifiedStats.

Returns
base stats, modified stats after traits, final stats, enriched gear, orb breakdown, trait impacts, class, power rating, twenty-three derived attributes, the seed, and the contentVersion.
Parameters
seed?, equipmentBonus?

Open endpoint ↗

Roll a party

Gather a party from one seed. Choose how many characters answer the call.

API reference

Use this to generate one character with its stats, equipment, traits, and derived values. Pass equipmentBonus=1 for the optional gear approximation; by default finalStats equals modifiedStats.

Returns
base stats, modified stats after traits, final stats, enriched gear, orb breakdown, trait impacts, class, power rating, twenty-three derived attributes, the seed, and the contentVersion.
Parameters
seed?, equipmentBonus?

Open endpoint ↗

Adventure mode with party

Your party gathers here.

Roll a party to fill the four empty slots.

Craft an item using orbs

Craft one item. Spend more orbs to improve your chances of a better result.

API reference

Use this to spend orbs and receive an item, either by targeting a material tier or by rolling the best of many.

Returns
an enriched item and its slot breakdown; orb crafts also include weighted-model combination and grade odds, rarity ceilings, and a sampled reference expectation.
Parameters
tier=1..7 | orbs=N, seed?, budget?

Open endpoint ↗

/api

GET

health check

Use this to confirm the world yet lives and answers.

Returns
a single greeting that the service is present and willing.

Open endpoint ↗

/api/spec

GET

this document

Use this to discover every endpoint and its purpose without reading source.

Returns
the maintained surface map of methods, paths, query descriptions, summaries, and scenarios.

Open endpoint ↗

/api/skill

GET

agent-readable skill describing how to use the API, also reachable at /skill, /skill.md, /.well-known/skill, /.well-known/skill.md, /llms.txt

Use this to obtain the complete guide for agents and developers, that all usage patterns and recipes may be learned from a single page.

Returns
a markdown document with YAML frontmatter containing the full instruction for building upon this world.

Open endpoint ↗

/api/craft-guide

GET

crafting and economy skill, also reachable at /craft-guide, /craft-guide.md

Use this to learn the full crafting and economy system, that orb costs, crafting modes, stat boosting, and monster drops may be composed into a progression loop.

Returns
a markdown document teaching the economy from first principles through end-game.

Open endpoint ↗

/api/stats

GET

canonical 9 base stats and inclusive [min, max] bounds

Use this to obtain the canonical stat order before sending values to /api/attributes or /api/drop, that there be no ambiguity in the array.

Returns
the nine base stats in their fixed order and their inclusive bounds from 8 to 24.

Open endpoint ↗

/api/slots

GET

equipment slots, per-slot capacity, derived-attribute domain, and canonical iteration order

Use this to learn which slots exist, how many items each holds, and their advisory derived-attribute domains.

Returns
every equipment slot in canonical order with its capacity and derived-attribute domain.

Open endpoint ↗

/api/skills

GET

all skills with flavor text

Use this to obtain the full table of 288 skills from which characters draw their distinctions.

Returns
every skill with id, name, and the prose that describes its nature.

Open endpoint ↗

/api/advantages

GET

all advantages

Use this to obtain the full advantages table for building trait pickers and character creation.

Returns
every named advantage from the trait pool, ready to be scored via /api/traits/impact.

Open endpoint ↗

/api/disadvantages

GET

all disadvantages

Use this to obtain the full disadvantages table for building flaw systems and challenge modifiers.

Returns
every named disadvantage from the trait pool, ready to be scored via /api/traits/impact.

Open endpoint ↗

/api/classes

GET

all character classes with mainhand weapon mapping

Use this to obtain the 144 classes and the mainhand weapon each is bound to.

Returns
the full class list with name, flavor text, and the weapon that defines the class.

Open endpoint ↗

/api/effects

GET

all status effects with descriptions

Use this to obtain the status-effect vocabulary for a game that defines its own effect mechanics.

Returns
effect names and descriptive prose; duration, magnitude, stacking, and resistance belong to the game.

Open endpoint ↗

/api/roll

GET

generator health check

Use this to confirm the generator API is reachable before rolling.

Returns
the same greeting as /api.

Open endpoint ↗

/api/roll/set

GET

roll a full 15-item equipment set with per-slot breakdown; seedable

Use this to outfit a character with a complete equipment set in one call, reproducibly when a seed is given.

Returns
the full equipment object, an aggregate orb value, a per-slot breakdown walked in canonical order, and the contentVersion.
Parameters
seed?

Open endpoint ↗

/api/rarity

GET

score and tier an item by its roll or index vector

Use this to appraise an item and learn its material grade, tier, quality score, and the contribution of each factor.

Returns
the grade, tier, probability, orb value, material envelope, and per-factor breakdown sorted by rarity contribution.
Parameters
indexes | rolls

Open endpoint ↗

/api/rarity/tiers

GET

tier definitions and grade ranges

Use this to learn the seven grade definitions from F through S and the boundaries between them.

Returns
seven grade descriptions and the material-rank counts for tool and wearable tables.

Open endpoint ↗

/api/modifiers

GET

advisory modifier budget and hash-derived theme channels for an item

Use this to learn how much power an item of this grade is entitled to and which attribute or elemental channels its name suggests, though the magnitudes remain yours to tune.

Returns
the grade envelope with a single budget number gated by grade and a themed channel for each name factor, derived by the same pinned hash as traits.
Parameters
indexes | rolls

Open endpoint ↗

/api/modifiers/spec

GET

the modifier budget table, channel list, and theme derivation spec

Use this to obtain the budget-per-grade schedule and the hash specification, that a client may recompute every budget and theme locally.

Returns
the seven budgets beside their craft costs, the thirty-one channels, and the FNV-1a derivation rule.

Open endpoint ↗

/api/craft/cost

GET

orb cost to craft at a target tier

Use this to learn the orb price required before attempting a craft at the given tier.

Returns
the orb cost and the budget of attempts the server will expend before declaring the craft capped.
Parameters
tier=1..7

Open endpoint ↗

/api/salvage

GET

orb salvage value for disassembling an item, plus the full schedule and sink invariant

Use this to appraise what an item returns when destroyed for orbs, under the published schedule whose expected return per roll stays strictly below one orb.

Returns
the salvage value with the grade envelope, the full grade schedule, and the measured expectation that proves disassembly is a sink, not a printer.
Parameters
indexes | rolls | tier?

Open endpoint ↗

/api/boost/cost

GET

orb cost to push a stat from one value to another

Use this to price the orb cost of raising a stat across the given range.

Returns
the total orbs and each per-step cost along the climb.
Parameters
from=8..23, to=9..24

Open endpoint ↗

/api/drop

GET

calculate the orb drop for slaying an enemy

Use this to determine how many orbs a slain enemy yields, given its nine stats (each 8 to 24) and encounter class. Threat scaling, such as a 10,000-HP boss, is your math; multipliers scale the drop, not the stat block.

Returns
the rolled orb amount with the base drop, class multiplier, and variance laid bare, plus a guaranteedItem when override.guaranteedTier is set.
Parameters
stats=9-ints, class, seed?, override?

Open endpoint ↗

/api/drop/classes

GET

encounter classes and their drop multipliers

Use this to learn the five encounter classes and the multiplier each bestows upon the base drop.

Returns
trash, veteran, elite, boss, and world-boss with multipliers 1, 3, 10, 50, and 250.

Open endpoint ↗

/api/traits/impact

GET

deterministic stat modifier for a single trait

Use this to learn the exact stat modifier a trait name produces, for the hash is deterministic and does not vary.

Returns
the primary stat, its delta, the secondary stat if the tier warrants one, and the tier of the impact.
Parameters
name, kind=advantage|disadvantage

Open endpoint ↗

/api/traits/impacts

GET

precomputed bulk trait impact map

Use this to obtain every trait pre-scored with its stat modifier in a single call.

Returns
each trait name with its tier and the primary and secondary deltas the hash has ordained.
Parameters
kind=advantage|disadvantage

Open endpoint ↗

/api/attributes

GET

derive 23 attributes from the 5 primary stats

Use this to expand base stats into health, damage, speed, dodge, and the remaining derived attributes.

Returns
each of the twenty-three attributes with its computed value.
Parameters
stats=9-ints

Open endpoint ↗

/api/attributes/spec

GET

attribute formula spec

Use this to obtain the formula behind every derived attribute, that a client may recompute them locally.

Returns
the full formula table with base, primary coefficient, secondary coefficient, and the stats each attribute draws from.

Open endpoint ↗

/api/power

GET

whole-character power rating from a reconciled stat block

Use this to grade a whole character as one canonical number, that a roster’s salary cap may be a sum instead of a recipe.

Returns
the power rating beside its maximum for the level, computed by the same formula the character sheet displays.
Parameters
stats=9-ints, level?, skills?=0..4

Open endpoint ↗