Case Status
Log In


Home ยป TroubleShooting
Community Wiki


ALWAYS Backup Your Project Before Updating Playmaker or Unity!

Ideally you should use source control so you can see exactly what's changed, roll back changes etc.

NOTE: Projects saved with PlayMaker 1.8 cannot be opened with older versions of PlayMaker!


Errors After Importing From Asset Store

There is an Asset Store Bug where it can give you the wrong version of an asset after switching Unity versions. (Case 954335).

If you switch Unity versions and then see errors when importing Playmaker, check this thread for the solution. Basically you have to force the Asset Store to re-download PlayMaker when switching Unity versions.


Duplicate File Errors in Console
In 1.8+ we've started integrating some Add-Ons in the main package. If you already have these Add-Ons in your project you might get errors from duplicate files. Please delete the older copy of these files (the ones not in Assets\PlayMaker\Actions) to fix those errors.
NOTE: Most of the time this shouldn't happen since the file IDs are the same, but it can happen, depending on how the Add-Ons were imported into your project.
Missing Playmaker Menu

If the Playmaker Menu is not available after importing Playmaker:

  • Click the main menu bar. It doesn't always redraw after importing a package.
  • Check the Unity Console for errors. Any errors (not just Playmaker errors) can stop editor extensions from compiling. Most of the time this is the problem. Fix any errors you find in the Unity Console. If you need help post the errors on the forums.
  • Sometimes Anti-Virus software can interfere with Unity imports. Try disabling virus checkers while importing.
  • Close the Playmaker Editor when importing updates. E.g., Load a default window layout.
  • Check that you have disk space. Sometimes importing can fail if you're out of space.
  • Restart Unity after importing. Sometimes Unity needs to restart.
  • Restart your computer. Sometimes the OS gets in a bad state.

Other things to try: NOTE: Backup your project first!!

  • Delete the project/Temp folder if it exists.
  • Delete the project/Library/ScriptAssemblies folder and restart.
  • Switch to another project, or make a new project, and reset the Layout to a default (e.g., Tall), then load the original project. Unity Tip: Hold Alt (windows) or Option (Mac) while Unity starts to open the Project Browser.
  • Google Drive and Dropbox folders can interfere with Unity Projects. Try moving your project out of these "special" folders.
  • Try re-downloading the Playmaker unitypackage, maybe it was corrupted on download. Unlikely but it can happen.


How To Safely Replace An Old Playmaker Installation With The Latest Version

NOTE: You only need to remove old files if you have errors after importing an update.

CAUTION: There are some files in the PlayMaker folder that you might want to keep! Follow these steps carefully:

  1. Backup your project before proceeding!
  2. Move PlayMaker/Resources/PlayMakerGlobals.asset out of the PlayMaker folder, into another "Resources" Folder. It's important that it remains in a "Resources" folder as it is a special folder within Unity.
  3. Move PlayMaker/Templates folder outside of the PlayMaker folder if you have saved templates (this is the default folder for saved templates)
  4. Delete the PlayMaker/ folder
  5. Delete Plugins/PlayMaker/ folder if it exists
  6. Import the latest version of PlayMaker
  7. Restart Unity
Globals Missing When Exporting a Unitypackage
  • Globals are stored in PlayMaker/Resources/PlayMakerGlobals.asset. You have to manually add this asset to the exported unitypackage. See Import/Export Globals.
  • NOTE: When you import PlayMakerGlobals.asset it will overwrite the current globals in the project. If you want to MERGE the globals into the project, use the Playmaker Export/Import Globals tools.
Editor Performance Tips

If you notice the Playmaker Editor slowing down with larger projects, try these workarounds:

ITween Conflicts
  • Playmaker ships with iTween included. If you get errors about multiple iTween definitions, you probably have 2 copies of iTween in your project. Remove one to fix the errors.
  • If you're using javascript to access iTween you should move the iTween directory into an Assets/Plugin folder.
Photon Build Errors

Error building Player: SystemException: \'System.Net.Sockets\' are supported only with Unity Android Pro. Referenced from assembly \'Photon3Unity3D\'

Photon is not supported in iOS and Android Basic builds. I you do not have Unity Pro, delete the Photon Unity Networking folder.

If you don't have Unity Pro, you can get Photon Plus, which will allow you to publish without Unity pro.

Unity Crashes When Updating Playmaker
Errors When Trying to Remove iTween

To remove iTween from Playmaker:

  1. Delete the PlayMaker/Actions/iTween folder
  2. Delete PlayMaker/Include/iTweenFsmEvents.cs
  3. Delete the iTween folder
No Active State:

When running, the FSM has no active state (no State being green).

  • Check that you're not looking at a prefab or template. These never have an active state since they do not exist in the scene.
  • Click in the Graph View and hit F to frame the currently active state.
  • Check if the PlayMakerFSM component on the GameObject is enabled.
  • Check if the GameObject is active.
Cannot store GameObject as Object variable with Get Component:

GameObject is not a valid component type, but the action was modified to account for this:


Duplicate Files After Updating in Unity 5.0 - 5.2

NOTE: Unity 5.3 now overwrites files instead of silently making a duplicate. In most cases this should work a lot better!

Unity 5 changed the way assets are imported from unitypackages. Instead of overwriting files, if internal asset GUIDs don't match, Unity creates a duplicate file, appending " 1" to the name. Older projects might have Playmaker files with different GUIDs (e.g., files copy/pasted in Finder/Explorer or downloaded from the forums), resulting in duplicate files when importing an update. These duplicate files generally cause errors and need to be removed!

If you import PlayMaker and find that you have duplicate files, please see "How to safely replace an old Playmaker installation" above.


Missing Scripts After Updating PlayMaker
Unity uses GUIDs to store references to components. If the GUID for a component changes then Unity loses the reference to the component and you get a Missing Script error. 

You can manually re-assign the missing script in the Unity Inspector or use this guide to fix references across the whole project.

Get/Set Property Lost References When Upgrading To Unity 5

Unity 5 removed properties that allowed you to target common components on a GameObject (e.g., guiTexture, renderer, rigidbody...). If you targeted these properties with Get Property or Set Property actions Playmaker will try to update the paths, but you may need to re-enter the target. In the future, you should target components directly - drag the Component into the Target Object field NOT the GameObject.

Please check this thread for more information.




Last modified on 12/9/2019 6:15 PM by User.

  • RSS Feed