Getting Started with OnlyWorlds

Welcome to OnlyWorlds! This guide will help you create your first world and start using the OnlyWorlds ecosystem.

How does this work?

OnlyWorlds is a shared data format for fictional worlds. When you create characters, locations, events or other world content in any OnlyWorlds-compatible tool, they’re stored as structured data that other tools can work with.

A public API enables these tools to communicate and read-write your world data to keep it sync across all tools. This means you can write some content in one app, then immediately use another tool to place those same elements on a map.

OnlyWorlds offers a few of such tools out of the box, and intends to support the development of more by providing a useful, free ecosystem for anyone that wants to (learn to) develop.

Quick Start

1. Create your account

  • Visit onlyworlds.com and create a free account
  • Write down (and/or change) your PIN for tool use (in profile section)

2. Create your first world

  • Click "create new world" (on worlds page)
  • Give it a name and description, press Save
  • Create an element of some kind
  • Note your world's API key

3. Try some tools

  • Browse tool - view, create, edit and showcase world elements
  • Parse tool - extract elements from existing work
  • Map tool - place elements on interactive maps, manage map hierarchies
  • Mobile companion - carry your worlds in your pocket, with a cute tutorial