Upgrading Carbon on existing projects
Migrate an existing Carbon project to a new version of Unreal Engine
Upgrading project in-place
Follow these steps to perform the in-place upgrade of your Carbon project:
Prerequisites
Prior to commencing the upgrade process, please ensure the following prerequisites are met:
Unreal Engine Installation: Verify that the desired Unreal Engine version is installed via the Epic Games Launcher.
Carbon for Unreal Installer: Obtain the latest Carbon for Unreal installer from the Carbon Portal.
Custom Modifications (Optional): If you have made any modifications to Carbon blueprints, it is highly recommended to document these changes (e.g., modifying fixture settings).
Step 1: Close Unreal Engine
To avoid any issues, ensure that all instances of Unreal Engine are completely saved and closed on your machine.
Step 2: Backup your Project
Before proceeding with any modifications to your project, create a complete backup of your entire Unreal Engine project folder. Copy the entire project directory and paste to a secure and separate location, such as a dedicated "backups" directory.
It is highly recommended to compress the backup project to a ZIP file to reduce file size and protect your project.
Step 3: Delete the Existing Carbon Plugin
Navigate to your project's Plugins folder, located at <projectRoot>\Plugins. Within this directory, locate and delete the CarbonCore folder.
Step 4: Associate Project with New Unreal Engine Version
At the root of your project folder, locate your project's .uproject file. Right click on this file and select the Switch Unreal Engine version... option. From the drop-down list that appears, choose the new Unreal Engine version you wish to associate with and use for this project.
Step 5: Install the New Carbon Plugin
Execute the Carbon for Unreal installer package. During the installation wizard, it is crucial to select the newly associated Unreal Engine project as the target directory for the plugin installation. For a more thorough walk-through on the Carbon installation process, please follow the article on Installing Carbon for Unreal.
Step 6: Open Your Upgraded Project
Once the plugin installation is complete, open your project. You can do this either through the Epic Games Launcher or by double clicking the .uproject file. After the project has fully loaded, verify that Carbon for Unreal is installed in your project
Last updated