Migrating Assets into a User Plugin

This page explains how to migrate assets between multiple plugins without causing reference or dependency issues.

Asset migration is a common and important workflow when building maps or vehicles, especially when you want to reuse existing content provided by the Modding SDK or sample plugins.

In this example, we will migrate a walkway asset from the SampleMod content into our own plugin.

Unreal Engine assets often reference:

• Materials
• Textures
• Blueprints
• Data Assets

Simply copying files on disk would break these references. Using the Migrate function ensures that all required dependencies are transferred correctly.

In this example, we want to migrate a walkway that is later assembled using other map tools.

Navigate to the following directory:`Simuverse_SampleModMap / Infrastructure / Props / Meshes`

Inside this folder, you will find three Static Meshes that together form a walkway structure.

• Select all three Static Meshes
• Right-click on the selection
• Choose Migrate

After selecting Migrate, Unreal Engine will show a window listing all dependencies required by the selected assets.

This step is extremely important.

Any dependency that originates from the plugin:`SubwaySim2_Modding`must NOT be selected.

These references must remain untouched, as they are part of the core game content and will always be available at runtime.

This behavior is explained in more detail here:

Understanding the Plugin System

Only select dependencies that belong to the SampleMod plugin or are required for the asset to function correctly.

Once the correct dependencies are selected, click OK.

After confirming the dependencies, a Windows Explorer window will open.

Now you must select the Content folder of your target plugin.

⚠️ Important: Migration works only into a plugin’s Content directory.

Example target path:`SubwaySim_Extern / SubwaySim_SDK_Testplugin / Content`

Select the Content folder and click Select Folder.

Unreal Engine will now copy:

• The selected assets
• All required dependencies

into your plugin while keeping all references intact.

The migrated assets are now fully part of your plugin and can be:

• Used freely in your map
• Modified if needed
• Packaged correctly when building the mod

This concludes the asset migration process.

Now that the required assets have been migrated into your plugin, the next step is to define how tracks are constructed and configured.

In the following chapter, you will learn how to create and configure Superstructures, which form the foundation for track generation in the Railtool.

→ Superstructure