Skip to content

Getting Started Guide

Welcome to the Imperium Maledictum Digital documentation! This guide will help you get up and running with the project.

What is Imperium Maledictum Digital?

Imperium Maledictum Digital is a comprehensive character sheet and journal application for the Imperium Maledictum tabletop role-playing game. It provides:

  • 📝 Digital Character Sheets - Track all character stats, skills, and equipment
  • 📖 Campaign Journal - Document your adventures and character development
  • ☁️ Cloud Sync - Optional synchronization across devices
  • 🖥️ Multi-Platform - Works on web, desktop, and mobile
  • 🎮 Complete Rules - All skills, talents, and equipment from the rulebook

Quick Start Options

🌐 Use the Web App

The easiest way to get started is to use the hosted web application:

  1. Visit maledictum.jatoft.se
  2. Click "Create New Character"
  3. Start building your character!

Features:

  • No installation required
  • Works on any modern browser
  • Optional cloud sync with token
  • Automatic updates

💻 Download Desktop App

For offline use and better performance:

  1. Go to the Releases page
  2. Download the installer for your platform:
    • Windows: .exe installer
    • macOS: .dmg disk image
    • Linux: .AppImage or .deb
  3. Install and run the application

Benefits:

  • Works completely offline
  • Faster performance
  • SQLite database storage
  • Native OS integration

🛠️ Run Locally (Developers)

For development or customization:

bash
# Clone the repository
git clone https://github.com/yourusername/imperium_maledictum.git
cd imperium_maledictum

# Install dependencies
npm install

# Run development server
npm run dev

Visit http://localhost:5173 to see the app.

Core Concepts

Characters

Characters are the heart of the system. Each character has:

  • Basic Information: Name, origin, faction, role
  • Characteristics: The 9 core attributes (WS, BS, STR, etc.)
  • Skills: All 20 skills with advances and specializations
  • Talents: Special abilities and traits
  • Equipment: Weapons, armor, and gear
  • Resources: Fate, wounds, influence

Journal Entries

Track your campaign progress:

  • Session summaries
  • Character development
  • Important events
  • NPC interactions
  • Personal notes

Cloud Sync

Optional feature for syncing across devices:

  1. Get a sync token from your GM or create your own
  2. Enter token in Settings
  3. Data syncs automatically

User Interface Overview

Common Tasks

Creating a Character

  1. Click "Create New Character"
  2. Enter basic information:
    • Name
    • Origin (Hive World, Feudal World, etc.)
    • Faction (Inquisition, Administratum, etc.)
    • Role (Warrior, Savant, etc.)
  3. Set characteristics (or use suggested values)
  4. Add skills and advances
  5. Select talents
  6. Save your character

Managing Skills

  • Each skill can have 0-4 advances
  • Each advance adds +5 to the skill
  • Skills can have specializations
  • Some specializations come from the rulebook
  • You can add custom specializations

Using the Journal

  1. Go to your character sheet
  2. Click "Journal"
  3. Create a new entry
  4. Add session date and title
  5. Write your notes (supports Markdown)
  6. Save the entry

Enabling Cloud Sync

  1. Click the settings icon
  2. Select "Cloud Sync"
  3. Enter your sync token
  4. Click "Enable Sync"
  5. Your data will sync automatically

Mobile Usage

The app is fully responsive and works great on mobile devices:

  • Character sheets adapt to narrow screens
  • Navigation uses a hamburger menu
  • Tables convert to card layouts
  • Touch gestures supported throughout

Offline Support

The app works offline thanks to service worker caching:

  • Static assets cached automatically
  • Character data stored locally
  • Sync when connection returns
  • No data loss

Getting Help

In-App Help

  • Hover over (?) icons for tooltips
  • Check the Rulebook reference
  • Use the search function

Community Support

Documentation

Next Steps

Now that you understand the basics:

  1. Create your first character - Step-by-step tutorial
  2. Explore the rulebook - Learn about skills and talents
  3. Set up cloud sync - Share across devices
  4. Join the community - Get help and share feedback

Ready to serve the Emperor? Get started now →