MechaLaunchPad

PySide desktop app, providing an end-to-end 3d content pipeline for a modular robot mech game.

Artists use this to generate their template files, to upload and locally validate new assets, preview those parts interactively on a 3D animated robot, and then publish them to the Gitlab CI/CD pipeline.

The pipeline then generates a thumbnail, and pushes it to a Unity repo + bakes a prefab (WIP).

Architecture Split

To keep the pipeline clean and flexible, the architecture is split into two repositories:

1. The App Source (MechaLaunchPad): This GitHub repository. It contains the Python source code for the PySide application, the local validation rules, the headless Blender extraction scripts, and the interactive OpenGL preview logic.
2. The Asset Pipeline (MechAssets): A target GitLab repository. This is the destination for validated .fbx files. Pushing to this repository triggers automated GitLab CI/CD pipelines that ingest the models into Unity, bake prefabs, and generate thumbnails.

Video Demo

MechaLaunchPadDemo.mp4

Setup & Running Locally

1. Requirements: Ensure you have Python 3.11+ and Blender 4.5 installed.
2. Environment: Create a virtual environment and install the dependencies:

   python -m venv venv
   .\venv\Scripts\activate
   pip install -r requirements.txt

3. Run: Launch the application using the provided batch script:

   .\run_app.bat