Worlds
A world is the top-level container in OnlyWorlds. It’s where all your elements live—every character, location, event, and concept exists within a world. Think of it as your universe’s database.
Core Properties
These fields identify and describe your world:
| Field | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | Unique world identifier (UUIDv7) |
name | string | Yes | Display name of your world |
description | string | No | Overview or summary of your world |
image_url | string (url) | No | Cover image or representative visual |
System Properties
These fields manage technical aspects:
| Field | Type | Required | Description |
|---|---|---|---|
api_key | string | Yes | 10-character key for API access |
version | string | Yes | OnlyWorlds format version (e.g., “1.0”) |
user | string (uuid) | Yes | Owner’s account identifier |
Timeline System
Optional fields for worlds with custom time tracking:
| Field | Type | Required | Description |
|---|---|---|---|
time_format_names | array[string] | No | Standard units: [“Day”, “Week”, “Month”, “Year”] |
time_format_equivalents | array[string] | No | Your custom names: [“Sol”, “Cycle”, “Season”, “Era”] |
time_basic_unit | string | No | Smallest time unit (e.g., “Day” or “Hour”) |
time_range_min | integer | No | Earliest tracked time point |
time_range_max | integer | No | Latest tracked time point |
time_current | integer | No | Current time in your world |
Timeline Examples
Fantasy world with custom calendar:
time_format_equivalents: [“Sun”, “Tenday”, “Moon”, “Turning”]time_basic_unit: “Sun”time_current: 1247 (Year 1247 of the Third Age)
Sci-fi setting with stardates:
time_format_equivalents: [“Cycle”, “Rotation”, “Orbit”, “Epoch”]time_basic_unit: “Cycle”time_range_min: 0time_range_max: 9999
Usage Notes
- The
api_keyallows tools to access your world data - Timeline fields work together - use all or none
- Custom time names map directly to standard units
- Time values are integers counting from your chosen starting point