Let this be a reliable API and online resource and source of inspiration. Every character, every item, every economy and attribute herein is given freely through stateless query, that any developer or agent developer may draw from these resources and follow their own creativity.

API

Let the following endpoints be called by any origin through HTTP GET. All responses are given as JSON, and no authentication is required of the caller.

  • https://set.world/api

    Use this to confirm the world yet lives and answers. Returns a single greeting that the service is present and willing.


  • https://set.world/api/spec

    Use this to discover every endpoint and its purpose without reading source. Returns the full surface map of method, path, query, summary, and scenario for each endpoint the world provides.


  • https://set.world/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.


  • https://set.world/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.


  • https://set.world/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.


  • https://set.world/api/slots

    Use this to learn which slots exist, how many items each holds, and which derived attributes each slot governs. Returns every equipment slot in canonical order with its capacity and derived-attribute domain.


  • https://set.world/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.


  • https://set.world/api/advantages

    Use this to obtain the full advantages table for building trait pickers and character creation. Returns every advantage as a weighted-table entry, ready to be scored via /api/traits/impact.


  • https://set.world/api/disadvantages

    Use this to obtain the full disadvantages table for building flaw systems and challenge modifiers. Returns every disadvantage as a weighted-table entry, ready to be scored via /api/traits/impact.


  • https://set.world/api/classes

    Use this to obtain the 116 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.


  • https://set.world/api/effects

    Use this to obtain every status effect that items and combat may inflict upon the living. Returns the full effects list with name and the prose describing its mechanical consequence.


  • https://set.world/api/roll/item

    Use this to summon a single item from the weighted tables at no cost. Returns the item enriched with its grade, material, orb value, and a breakdown row showing its place among all possible outcomes.


  • https://set.world/api/roll/set

    Use this to outfit a character with a complete equipment set in one call. Returns the full equipment object, an aggregate orb value, and a per-slot breakdown walked in canonical order.


  • https://set.world/api/roll/character

    Use this to bring forth a complete playable character with all systems resolved. Returns base stats, modified stats after traits, final stats after equipment, enriched gear, orb breakdown, trait impacts, class, and twenty-three derived attributes.


  • https://set.world/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.


  • https://set.world/api/rarity/tiers

    Use this to learn the seven grade definitions from F through S and the boundaries between them. Returns the tier table with cumulative-weight share descriptions and grade counts for tools and wearables.


  • https://set.world/api/craft/cost?tier=5

    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.


  • https://set.world/api/craft?orbs=125

    Use this to spend orbs and receive an item, either by targeting a material tier or by rolling the best of many. Returns the resulting item with its score, grade, tier, and material, plus the number of attempts or the expected percentile band.


  • https://set.world/api/boost/cost?from=14&to=18

    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.


  • https://set.world/api/drop?stats=12-14-10-11-13-16-12-14-11&class=elite

    Use this to determine how many orbs a slain enemy yields, given its stats and encounter class. Returns the rolled orb amount with the base drop, class multiplier, and variance laid bare.


  • https://set.world/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.


  • https://set.world/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.


  • https://set.world/api/traits/impacts?kind=advantage

    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.


  • https://set.world/api/attributes?stats=14-12-10-11-13-16-12-14-11

    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.


  • https://set.world/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.