Building worlds

Start here if you want to create or convert worldbuilding content.

  1. Create an account at onlyworlds.com
  2. Note your PIN from your profile page
  3. Create a world and copy its API key
  4. Choose your approach:
    • Your First World - Build Dan Simmons’ Hyperion setting from the ground up
    • Migration Guide - Convert existing content with free AI parsing (WorldAnvil exports, Google Docs, scattered notes, book text, even photos of handwritten notes)
    • Tool Directory - Browse available tools for different workflows

The web interface handles basic element creation. The Parse Tool and OnlyWorldsBot convert unstructured text into structured OnlyWorlds elements automatically. Specialized tools offer better workflows for specific tasks.

Developing tools

OnlyWorlds provides a REST API with no licensing requirements. Build whatever you need. The Template Tool is designed for extension by LLMs—anyone can build custom tools or commercial applications without writing code manually.

Quick start:

Authentication uses API-Key and API-Pin headers. The base URL is https://www.onlyworlds.com/api/worldapi/. Full documentation at onlyworlds.com/api/docs.

Contributing

The framework improves through community input on element definitions, field specifications, and tool requirements.

Provide feedback through:

See Contribution for guidelines on submitting changes.

Reference