Star
Journal Guide

Understanding Journal Structure

This guide explains the technical structure of Mythic GME Mobile journal files. While the app provides the best experience for creating and managing journals, this documentation helps developers and power users understand the data format for custom integrations or advanced usage.

Important Note

The recommended way to create and manage journals is through the Mythic GME Mobile app. This documentation is primarily for:

  • Developers interested in app integration
  • Users who want to process journal data externally
  • Understanding the technical structure of journal files

Journal File Structure

Each journal file is a JSON document containing these key elements:

  • JournalName: The name of your journal/campaign
  • ChaosFactor: Current chaos factor (1-9)
  • Scenes: Array of scene objects
  • Characters: Array of character objects
  • Threads: Array of thread objects
  • Features: Array of feature objects
  • LogEntries: Optional array of game events

Core Components

Scenes

Track individual story segments with these properties:

{
  "SceneSummary": "Scene description",
  "SceneChaosFactor": 5,
  "SceneNotes": "Detailed notes about the scene",
  "SceneType": "Expected Scene | Altered Scene | Interrupt Scene"
}

Characters

Keep track of important people in your story:

{
  "Character": "Character name",
  "Description": "Optional character description"
}

Threads

Manage storylines and plot points:

{
  "Thread": "Thread name",
  "Description": "Optional thread description"
}

Features

Track important locations, items, or events:

{
  "Feature": "Feature name",
  "Description": "Optional feature description"
}

Event Logging

The journal automatically tracks various game events:

Scene Checks

  • Scene transitions
  • Scene types
  • Chaos factor changes

Fate Checks

  • Questions asked
  • Probability odds
  • Roll results

Random Events

  • Event focus
  • Meaning rolls
  • Character/Thread connections

Technical Reference

For developers and advanced users, you can download a sample journal template that shows the complete file structure:

Download Template

Note: This template is for reference purposes. For regular use, we recommend creating journals directly in the Mythic GME Mobile app.

Best Practices

  • Use the Mythic GME Mobile app for the best journal management experience
  • Keep descriptions clear and concise
  • Regularly export your journals for backup
  • Consider using the app's built-in tools for random events and fate checks