# Perfect World Database

Game database for Perfect World (Angelica-engine MMORPG, live since 2005):
items, monsters, NPCs, quests, recipes, resource mines, and interactive maps
of the main world and dungeons.

## Data meaning

- Entity numbers (levels, HP, prices, damage, socket chances) come from a
  parse of the game client's own data files. The dataset era is pinned per
  release; see the changelog for the current one.
- Base monster drop rates are server-side in this game and are never
  published here; only client-visible extra-drop tables appear.
- Refining success chances on the calculator and refining guide are
  community-measured base rates for the pinned era — not extracted values.
  Per-item Mirage Celestone costs and refine-bonus addon ids ARE extracted.
- Build summaries on /builder sum extracted base item fields only; refining
  odds are community-measured era constants; recorded socket counts are
  capacity only — gem effects are absent from the data.
- Featured builds at /builds are put together by the site from extracted
  items; their summaries sum base item fields like /builder. Personal builder
  links are URL-only and are not stored server-side.
- Quest ids exist in two in-game namespaces; both are served
  (`quest` internal, `quest-public` player-visible).
- Set-piece bonus strings on /armor-sets are quoted verbatim from the
  client's addon table; piece thresholds live inside those strings. Two
  placeholder-named sets reference bonus ids absent from the data and show
  pieces only.
- Skill text on /skills is client config strings from the pinned era,
  quoted as stored; level-by-level numbers are runtime client data this
  site does not ship.

## Machine entry points

- [Data index](/data/index.json): API index
- [Kinds](/data/kinds.json): entity kinds + counts
- [Entity record](/data/entity/{kind}/{id}.json): one entity record
- [Full plane dump](/data/entities/{kind}.json): full plane as one JSON array
  (item ≈11 MB, quest ≈19 MB, monster ≈7 MB, recipe ≈1.2 MB, npc ≈0.9 MB,
  quest-public ≈0.8 MB, mine ≈0.2 MB; also equipment-addon, armor-set)
- [Search index](/data/search-index.json): MiniSearch index payload
- [Maps registry](/data/maps.json): map registry with bounds and transforms
- [Builder catalog](/data/builder-catalog.json): projected equipment rows for the gear builder
- [Builder](/builder): gear-set builder with shareable URL state
- [Builds](/builds): featured gear builds curated by the site, one permalink each
- [Build record](/data/build/{slug}.json): machine record for a published build
  (slots, stats, builder URL)
- [Armor sets](/armor-sets): equipment set gallery with piece lists and verbatim set bonuses
- [Skills](/skills): skill database — effect text, requirements, sage/demon variants
- [Classes](/classes): class overview linking one page per playable class with its restricted equipment and quests
- [Map](/map): interactive zone maps for all 32 zones
- [Changelog](/changelog): dataset changelog (methodology)

Pages render the same records these endpoints return.