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 →