Uncrafted item
- Slot
- —
- Grade
- —
- Material
- —
- Rarity
- —
- Orb value
- —
- Affects
- —
Rarity ceiling—
Measured on the logarithmic rarity scale.
- Odds
- —before orb selection
- Grade —+
- —with — orbs
Roll an item
Draw from the world’s weighted tables. Every item comes with its grade, material, and orb value.
API reference
GET /api/roll/item
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?
Roll a character
Bring forth a character with a class, traits, attributes, and a full set of equipment.
API reference
GET /api/roll/character
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=uint32?, equipmentBonus=1|0|true|false? (default off)
Roll a party
Gather a party from one seed. Choose how many characters answer the call.
API reference
GET /api/roll/character
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=uint32?, equipmentBonus=1|0|true|false? (default off)
Adventure mode with party
A party explores the maze, meets Animas around corners, and fights in initiative order.
Animas wait around corners and are marked on the minimap. The party is not rendered. At an encounter, initiative orders physical attacks; floating damage and health and stamina bars show the result. Play runs automatically. Pause and Next turn let you step through combat. Arrow keys or W A S D move and turn outside combat. Space toggles automatic play; Enter advances a paused combat turn. Survivors return to the entrance after clearing the maze. Replay reuses the same characters.
Roll a party in column three to begin encounters.
Turn order and API
Each living actor gets one opportunity every 1000 / initiative milliseconds. Faster actors act more often; exact ties retain party order, then the enemy.
One action plays at a time. Attacks cost 20 stamina, including misses. Recovery is 10 / second of initiative time; insufficient stamina rests for that turn. Travel also restores stamina. Health persists through the maze.
Physical damage, dodge, critical hits, and defenses use the optional combat helper. Equipment effects are not added. The party stays off-camera; counters and resource bars show its actions.
Enemies are ordinary seeded character rolls, one per request. Replay adventure reuses the same characters and restores their local starting resources. No rewards or birth updates are made.
Rules dungeon-initiative-1. Enemy seeds derive from the first member's seed and content snapshot; the maze and combat stream also retain its display name.
Craft an item using orbs
Craft one item. Spend more orbs to improve your chances of a better result.
API reference
GET /api/craft
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, seed, snapshot, and effective inputs; orb crafts include combination/grade odds, exact actual-spend grade expectations, and score samples labeled by reference spend.
- Parameters
- tier=1..7 | orbs=N (positive integer; effective cap 100000), seed=uint32?, budget=positive-int? (tier only; effective cap 1000000)
Battle with armies
Two armies of 16 level-one characters fight with their generated weapons on a serpentine-green field.
Army I— / 16
Army II— / 16
Drag the board to rotate, use the wheel to zoom, or use two fingers to pan and zoom. Click without dragging, or focus the scene and press Space or Enter, to pause or resume. Home restores the overhead view. Arrow keys pan; Shift and arrows rotate. Black Army I faces white Army II. Red bars show health; blue bars show stamina. Class names open original character sheets. The linked scenes let you explore these optional rules in a new tab.
Awaiting armies
Battle rules and API
One optional interpretation of Set. Actual equipment, range, weight, stamina, and contact drive the Anima battle. Drag to rotate; click to pause.
Range and handling come from weapon geometry and finalStats. Melee, projectiles, healing rings, recoil, and ragdolls share the Anima scene rules.
Matching colors cannot damage each other. Present, Play, and Strum heal every living character inside their rings. Battle ends when an army falls.
Character seeds: deriveSeed(base, i), i = 0..31, alternating teams. Scene seed: deriveSeed(base, 32). Profile: anima-armies-1. Character replay also requires the matching content snapshot; battle replay requires the scene rules and assets.
GET /api/roll/character
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=uint32?, equipmentBonus=1|0|true|false? (default off)
Check the connection
Confirm that Set is reachable before drawing an identity or building a game.
API reference
GET /api
Use this to confirm the world yet lives and answers.
- Returns
- a single greeting that the service is present and willing.
Explore the API
Find each operation, its inputs, and what it returns. Use one primitive or compose a whole game.
API reference
GET /api/spec
Use this to discover every endpoint and its purpose without reading source.
- Returns
- the maintained surface map of methods, paths, query descriptions, summaries, scenarios, and workspace titles and descriptions.
Build with Set
Start with one character or learn how to bring Set’s generation, attributes, and economy into your game.
API reference
GET /api/skill
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.
Build an orb economy
Learn how crafting, stat prices, drops, and salvage fit into a progression loop you control.
API reference
GET /api/craft-guide
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.
Read the base stats
Find the nine stats, their accepted bounds, and the order used to calculate attributes and drops.
API reference
GET /api/stats
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.
Plan an equipment set
Read each slot’s capacity and the attributes it can influence. A full set holds fifteen items.
API reference
GET /api/slots
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.
Explore character skills
Browse the practices and distinctions a character can carry into your world.
API reference
GET /api/skills
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.
Explore character advantages
Find the strengths a character may inherit, then inspect their effects on base stats.
API reference
GET /api/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.
Explore character disadvantages
Find the flaws a character may inherit, then inspect their effects on base stats.
API reference
GET /api/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.
Explore character classes
Browse the classes, their mainhand weapons, and the disciplines that define them.
API reference
GET /api/classes
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.
Choose a status vocabulary
Read the world’s named conditions and descriptions. Give them mechanics in your game.
API reference
GET /api/effects
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.
Check the generator connection
Confirm that the generator route answers before requesting an item, equipment set, or character.
API reference
GET /api/roll
Use this to confirm the generator API is reachable before rolling.
- Returns
- the same greeting as /api.
Roll an equipment set
Outfit a character with fifteen items. Inspect their grades, slot domains, and combined orb value.
API reference
GET /api/roll/set
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?
Appraise an item
Read an item’s material grade, orb value, and the weighted factors that make its name rare.
API reference
GET /api/rarity
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 (19 in-range integers; mutually exclusive)
Explore item grades
Read the seven material grades from F through S and how they divide the material tables.
API reference
GET /api/rarity/tiers
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.
Read an item’s power budget
Find a graded budget and the channels suggested by an item’s name. Decide what that budget buys in your game.
API reference
GET /api/modifiers
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 (19 in-range integers; mutually exclusive)
Plan item power
Read the budget for each grade and the shared theme channels before defining equipment effects.
API reference
GET /api/modifiers/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.
Price a material-grade floor
Choose a target grade and read its orb price and maximum sampling budget.
API reference
GET /api/craft/cost
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
Appraise salvage
Find an item’s orb return under the disassembly schedule. Your game decides when it can be redeemed.
API reference
GET /api/salvage
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=1..7 (mutually exclusive; omit all for the schedule)
Price a stat increase
Compare the orb costs of raising a stat, one point at a time, up to Perfect.
API reference
GET /api/boost/cost
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
Price an enemy’s drop
Use an enemy’s stats and encounter class to calculate an orb reward for a victory in your game.
API reference
GET /api/drop
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 orb amount, seed, snapshot, base drop, class multiplier, and variance; a requested guaranteedItem includes salvage, with its requested floor, derived seed, budget, attempts, and cap outcome in guaranteedItemCraft.
- Parameters
- stats=9-ints-in-8..24, class, seed=uint32?, override=JSON?
Choose a drop class
Compare the five encounter multipliers, from trash to world-boss, before pricing a reward.
API reference
GET /api/drop/classes
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.
Read a trait’s impact
See which stats a named advantage or disadvantage changes, and by how much.
API reference
GET /api/traits/impact
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
Compare trait impacts
Read every advantage or disadvantage with its stat deltas, ready for a character builder.
API reference
GET /api/traits/impacts
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
Derive character attributes
Turn a reconciled stat block into health, stamina, damage, movement, and the other derived values.
API reference
GET /api/attributes
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-in-8..24
Read the attribute formulas
Inspect the stats and coefficients behind every derived value, then calculate them in your game.
API reference
GET /api/attributes/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.
Rate a character
Give a reconciled character one rating for your roster rules. Compare it with the maximum at your chosen level.
API reference
GET /api/power
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-in-8..24, level=1..90071992547392?, skills=0..4?
Basic lightweight combat
Experimental, optional combat rules for a game that needs a starting point.
Use your own combat rules, or start here.
Pass finalStats in canonical order. Damage includes dodge, critical hits, and 20-point stamina costs.
Initiative returns who acts first and how many action opportunities each character gets. Movement distance stays separate.
No status effects, equipment effects, or saved battle state.
basic-lightweight-combat-1
API reference
GET /api/basic-lightweight-combat/skill
Use this to adopt a small damage and initiative model when your game has no combat rules yet; skill-based games can ignore it.
- Returns
- a Markdown skill with formulas, attribute coverage, request examples, action-count semantics, and replay rules.
Resolve experimental combat
Calculate one attack or a window of action opportunities from reconciled stats.
API reference
GET /api/basic-lightweight-combat
Use this to resolve an attack or schedule turns using the optional fallback. Supply nine reconciled integer stats in 8..24; health and stamina remain in your game.
- Returns
- experimental and version stamps, effective inputs, damage and resource changes with random rolls, or chronological action opportunities and per-actor move counts. Moves are not grid distance or guaranteed attacks.
- Parameters
- mode=damage: attacker=<9>, defender=<9>, kind=physical|magical|action?, health?, stamina?, elapsedMs=0..30000?, seed=uint32?; mode=initiative: actors=JSON [{id,stats}] (1..128), startMs=integer?, durationMs=1..30000? (default 5000), end<=1000000000; rulesVersion?, contentVersion?
Read the combat formulas
Inspect the experimental damage channels, stamina rules, initiative clock, and input limits.
API reference
GET /api/basic-lightweight-combat/spec
Use this to implement or inspect the optional combat interpretation locally, including its limits and what it leaves to your game.
- Returns
- the rules version, content snapshot, stat order, damage kinds, formulas, stamina constants, initiative boundaries, exclusions, and guide links.