Skip to content
@OnlyWorlds

OnlyWorlds

Open worldbuilding standard: 22 element types, an API, SDKs and tools.

OnlyWorlds is an open standard for worldbuilding data: one shape for a world's characters, locations, institutions, events and the rest of its 22 element types, which any tool can read and write.

The 22 element types, each with its icon, in alphabetical order

The standard

  • OnlyWorlds: the schema, 22 element types in YAML
  • schema-dist: the schema packaged for tools, with a reference decoder

Build on it

  • sdk: TypeScript (npm install @onlyworlds/sdk)
  • python-sdk: Python (pip install onlyworlds)
  • unity-sdk: Unity and C#
  • toolkit: Claude Code skills for building and using worlds
  • event-starter: a starting point for a web tool on world data, ready to deploy
  • tools: the list of tools built on OnlyWorlds, and how a tool gets on it

With AI

  • An agent reads a world through the API or MCP, and joins one from a single invitation link (how).

Use a world

  • atlas: a desktop worldbuilding studio, your world in a folder on your own computer
  • lantern: an offline-first phone app that holds your worlds
  • little-lens: a world as a web of its elements, read only
  • parlor: a room on a world, where people and their AI meet and leave with elements built into it
  • obsidian-plugin: a world as Obsidian notes, synced both ways
  • azgaar-converter: an Azgaar map export into a world
  • foundry-converter: a world into an installable Foundry VTT module

Make a world in Atlas or host one on onlyworlds.com. Docs: onlyworlds.github.io. The schema changes through the Council. Something wrong or missing: the feedback tracker. How we treat each other here, people and agents alike: the code of conduct.

Popular repositories Loading

  1. OnlyWorlds OnlyWorlds Public

    The OnlyWorlds standard: an open schema for worldbuilding data. 22 element types, defined in YAML.

    18 2

  2. toolkit toolkit Public

    A worldbuilding companion for Claude Code: bring notes, a novel or campaign docs, and build them into a world you can explore, check and keep.

    Python 3

  3. obsidian-plugin obsidian-plugin Public

    Keep an OnlyWorlds world as notes in your Obsidian vault, one note per element, synced with onlyworlds.com if you want.

    TypeScript 2 1

  4. onlyworlds.github.io onlyworlds.github.io Public

    Documentation for the OnlyWorlds standard and tools.

    JavaScript 1

  5. write-tool write-tool Public archive

    An early OnlyWorlds writing tool, no longer maintained: writing lives in Atlas now.

    TypeScript

  6. sdk sdk Public

    Build on OnlyWorlds in TypeScript: a typed client for the onlyworlds.com API, and readers for world files and the shared conventions.

    TypeScript

Repositories

Showing 10 of 23 repositories

Top languages

Loading…

Most used topics

Loading…