The Accursed Voyage of The Mariner’s Fortune

This Obsidian vault contains all the notes, characters, locations, and session logs for the James Mariner fanclub.

Getting Started

  1. Download and Install Obsidian at obsidian.md/download
  2. Open an existing vault, or create a new one
  3. Install the Git Plugin:
    1. In Obsidian, go to Settings (gear icon)
    2. Navigate to Community plugins
    3. Click Turn on community plugins (if not already enabled)
    4. Click Browse to open the community plugins browser
    5. Search for “Obsidian Git”
    6. Click Install, then Enable
  4. Clone the Repository using the Obsidian Git plugin:
    1. Press Ctrl/Cmd+P to open the command palette
    2. Type and select “Git: Clone an existing remote repo
    3. Enter the repository URL (https://gitea.ditmarvisser.net/ditmarvisser/dnd-notes.git) when prompted
    4. Choose a local folder location
    5. Wait for the clone to complete

Syncing Changes

Once the vault is cloned, use these commands to keep it synced:

  • Pull changes: Ctrl/Cmd+P → “Git: Pull”
  • Commit changes: Ctrl/Cmd+P → “Git: Commit all changes”
  • Push changes: Ctrl/Cmd+P → “Git: Push” (or configure automatic push)

For tracking campaign dates and fantasy calendar integration, install the Calendarium plugin:

  1. Open Settings → Community plugins
  2. Click “Browse”
  3. Search for “Calendarium”
  4. Click Install, then Enable
  5. Configure your campaign calendar in plugin settings

Using Templates

Create new notes with consistent formatting using templates:

  1. Navigate to the folder where you want to create a note
  2. Press Ctrl/Cmd+P and type “Templater: Create new note from template”
  3. Select the appropriate template
  4. Fill in the YAML frontmatter fields (replace PLACEHOLDER values)
  5. Add content under the section headings

Key Features

Database Views

Access organized views of your campaign notes:

  • People - Gallery view with character portraits and quick info
  • Factions - Table view showing alignments, leaders, and relationships
  • Places - Table view of locations organized by region
  • Sessions - Chronological list of session logs sorted by date

Wiki-Style Linking

Create connections between notes using wiki-links:

  • Create a link: [[Note Name]]
  • Link to a section: [[Note Name#section-heading|Section Heading]]
  • Navigate: Ctrl/Cmd+Click on any link to open that note

Frontmatter Properties

All notes include YAML frontmatter for organization and filtering:

  • type: - Note category (npc, faction, place, session, misc)
  • status: - Current state (active, alive, unknown, deceased, etc.)
  • tags: - Custom tags for categorization
  • Type-specific properties (affiliation, region, date, etc.)

These properties enable powerful filtering and querying in database views.