WH40K Rogue Trader Campaign Manager

A comprehensive campaign management tool for Warhammer 40,000 Rogue Trader tabletop RPG sessions.

Overview

This tool helps Game Masters and players manage their Warhammer 40K Rogue Trader campaigns, including character sheets, ship management, crew rosters, trade goods, exploration tracking, and more.

Features

Core Management

• Character Sheets - Detailed Rogue Trader character creation and management
• Ship Management - Track your voidship's stats, components, and upgrades
• Crew Roster - Manage your crew, their skills, and assignments
• Inventory & Cargo - Track trade goods, equipment, and ship cargo
• Finance Tracking - Manage profits, expenses, and trade profits

Campaign Tools

• Exploration Log - Record explorations of the Expanse
• Session Notes - Track session recaps and important events
• Contact Network - Manage NPCs, patrons, and contacts
• Faction Reputation - Track relationships with Imperial organizations

Game Mechanics

• Skill Tests - Automated skill check rolling with modifiers
• Combat Tracker - Initiative and combat management
• Psychic Phenomena - Track warp and psychic events
• Mutation Tracking - Handle the perils of the warp

Project Structure

wh40-rogue-trader/
├── backend/           # Backend API (Node.js/Express or Python/FastAPI)
│   ├── src/
│   │   ├── controllers/
│   │   ├── models/
│   │   ├── routes/
│   │   ├── services/
│   │   └── config/
│   └── package.json
├── frontend/          # Frontend application (React/Vite)
│   ├── public/
│   └── src/
│       ├── components/
│       ├── pages/
│       ├── hooks/
│       ├── store/
│       ├── utils/
│       └── App.tsx
├── shared/            # Shared types and utilities
│   └── src/
│       ├── types/
│       └── constants/
├── docs/             # Documentation and reference materials
│   ├── rules/
│   └── examples/
├── .gitignore
└── README.md

Getting Started

Prerequisites

• Node.js 20+ (for frontend/backend)
• Python 3.10+ (optional, for MCP server)
• PostgreSQL (for database)
• Docker & Docker Compose (for containerized deployment)

Installation

1. Clone the repository:

   git clone http://192.168.50.213:4000/nasandre/wh40-rogue-trader.git
   cd wh40-rogue-trader
   

2. Install dependencies:

   # For Node.js backend
   cd backend && npm install
   
   # For React frontend
   cd ../frontend && npm install
   

3. Configure environment variables:

   cp .env.example .env
   # Edit .env with your configuration
   

4. Run the application:

   # Development mode
   docker-compose up -d
   
   # Or run individually
   cd backend && npm run dev
   cd ../frontend && npm run dev
   

API Documentation

The backend provides a RESTful API for managing all campaign data. See API Documentation for details.

Data Model

Character

• Profile (Name, Wounds, Fate Points, etc.)
• Characteristics (WS, BS, S, T, Ag, Int, Per, WP, Fel)
• Skills and Talents
• Psychic Powers (if Psyker)
• Equipment and Gear

Voidship

• Ship Class and Statistics
• Components (Weapons, Armour, Sensors, etc.)
• Crew Quarters and Capacity
• Cargo Holds and Storage
• Ship's Reputation and History

Campaign

• Timeline of Events
• Explored Systems
• Trade Routes
• Faction Relationships
• Session Logs

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Warhammer 40,000 and Rogue Trader are trademarks of Games Workshop
• This is a fan project and not officially affiliated with Games Workshop

Resources

• Rogue Trader Core Rulebook
• Cubicle 7 Entertainment
• Warhammer 40K Wiki