Muddy Terrain Games

Products Docs Careers Support
Local CI/CD for Unreal Tool Banner

Spending hours packaging your Unreal plugin for every single engine version? Say no more. Local CI/CD for Unreal is a free, open-source, and lightweight tool designed to completely automate the tedious process of packaging and archiving your projects. Focus on building great plugins, not on fighting with build scripts.

This tool is 100% free and licensed under MIT. No strings attached. 🎉

View on GitHub Read The Docs

How to Use

Get running in three simple steps.

  1. Download the Tool: Clone or download the repository from GitHub.
  2. Create your config.json: Duplicate config.example.json, rename it to config.json, and edit it to point to your project and engine installations.
  3. Run the Pipeline: Open a PowerShell window and run ./run_pipeline.ps1. The tool will validate your setup and handle the rest.

Configuration

All settings are managed in the config.json file. This allows you to define everything from your project path to the specific engine versions you want to build for.

CI/CD Tool Engine Version Configuration

For a full breakdown of all settings, please see the detailed configuration guide.

Download on GitHub See Configuration Guide

Key Features

  • Automated Example Project Generation: 📦
    Automatically generates clean, version-specific C++ and Blueprint-only example projects for each engine version from a single master project.

  • Multi-Version Plugin Packaging: ⚙️
    Run one script to package your plugin for all specified Unreal Engine versions. No more manual UAT commands.

  • Optional Cloud Uploads: ☁️
    Automatically upload all your packaged builds to Google Drive, Dropbox, or any other cloud provider using the powerful rclone tool.

  • Time-Saving Cache: ⚡️
    Use the -UseCache flag to skip any builds that already exist in your output folder. Perfect for iterating on a single engine version without rebuilding everything.

  • MIT Licensed & Open Source: ❤️‍🔥
    Completely free to use, modify, and distribute. We believe in empowering the community with powerful, accessible tools.

  • Simple JSON Configuration: 🔗
    Set up all your project paths, engine locations, and output directories in a single, easy-to-read config.json file. Get set up in minutes.

Why Use This Tool?

  • Save Massive Amounts of Time: ⏳ What used to be a tedious, manual process that took hours can now be done in the background with a single command.
  • Eliminate Human Error: 🎯 Automated scripts don't forget steps or make typos in command-line arguments. Get consistent, reliable builds every time.
  • No Complex Setup: 🛠️ You don't need to learn Jenkins, TeamCity, or any other complex CI/CD platform. If you have Windows and PowerShell, you're ready to go.
  • Built for Unreal Developers: 💻 This isn't a generic build tool; it's made specifically for the Unreal Engine workflow and understands its packaging process.

Resources & Support

Get The Tool Read The Docs