Basic Upgrade Process

This documentation covers the process of upgrading from Platformer PRO version 1.x.x to Platformer PRO 2


Warning: Ensure you have backups of your project before performing the following actions!


Base Upgrade

1. Create a new project and import Platformer PRO 2. Close Unity.

We call this the "new project".

2. Open your existing project and ensure its upgraded to Unity version supported by Platformer PRO 2 (2018.3+).

We call this the "old project".

3. In your file explorer open you old project and delete the folder Assets/2DPlatformerPro.

4. Copy the Assets/PlatformerPro folder from your new project in to your old project.


5. Open the old project. It should open without compilation errors.


For One Scene

1. Open the scene and add a PlatformerProGameManager component. If you have a 'Manager' GameObject use this, if not create a new GameObject. Turn off persistence for now.

2. Add an ItemTypeManager component (usually to a child GameObject of the GameManager). Press edit items and create one item. Close the window and choose a Resource folder to save your item data to.

3. Create a prefab for the PlatformerProGameManager and ItemTypeManager. If you already use a 'Manager' prefab then update your existing Manager prefab instead.


Note: The PlatformerProGameManager replaces the older CharacterLoader script. If you used CharacterLoader you will need to remove all instances of it and ensure there is a PlatformerProGameManager in their place.

If you used custom code to listen to loading events you will need to update this code to match the PlatformerProGameManager events.


For every Other Scene

1. Ensure the Manager prefab is in all game/level scenes.

2. For each Platformer Pro Camera find the missing script and delete the component. In its place add a new PlatformerProStandardCamera. The settings will be gone so you may need to refer to an old version of your project to setup camera settings.



1. Create an item in the ItemTypeManager for every item in your game. To replicate exiting settings you can use non-inventory/consumables as the basic item type (use power-up for power ups)

2. Update every item in the scene by:

  a. Removing the missing script component and replacing with the Item script

  b. Picking the item type from the list of available items


Note: if you use prefabs for items you only need to update the prefab.


Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk