NOTE: Always BACKUP Unity Projects before importing updates! Use version control!
PlayMaker 1.8+ Notes:
- FSMs saved with 1.8.+ cannot be opened in older versions of Playmaker!
- With 1.8+ some add-ons will be integrated in the main package. If you already have these add-ons in your project you might get errors from duplicate files. Simply delete the older copy of the file (the one not in Assets\PlayMaker\Actions) to fix the error.
Unity 2017.2 Patch
The next Playmaker update is still in beta. In the meantime, please import this patch to fix Obsolete warnings in 2017.2:
Import and install PlayMaker 1.8.5 first, then import the patch.
Unity 5 Upgrade Notes:
- 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 the target no longer exists and you will need to re-target the action. Instead, you should target the component directly - drag the Component into the Target Object field NOT the GameObject.
- Unity 5 changes the way assets are imported from a unitypackage. It now uses GUIDs. This can cause duplicate files if you have the same file in your project with a different GUID (e.g., you copied the file in Finder or Windows Explorer and Unity assigned it a new GUID). Please see the Troubleshooting link below to fix this.
- Some Add-Ons and custom actions need to be updated. Please report any problems you run into on the forums so we can look into them asap.
- Fixed missing system events in iOS builds in Unity 5.6 (#1659).
- Fixed actions sometimes executing twice in action sequence (#1620, #1635).
- Fixed Variables tab not showing variables for selected sub-FSM when playing (#1651).
- Fixed new variable popup messing up variable categories (#1622).
- Fixed ambiguous match error with new mono runtime preview in Unity 2017.1 beta.
- Fixed some defines for Unity 2017+
- Action Browser: Escape clears search field. Second escape closes the browser.
- Action Browser: Added "Show Used Actions Only" option in Settings Menu.
- Moved PlayMakerFSM.LateUpdate to optional separate component for better performance.
- PlayMakerPrefs: Added preference to control logging of Performance Warnings in builds.
- PlayMakerPrefs: Added preference to Show Event Handler Components added to GameObjects.
- Updated Spanish translations. Thanks, Matias Ignacio!
- Fixed Playmaker Defines for iOS in Unity 5.4 (#1567)
- Fixed Conditional Expression action not finding global variables.
- Fixed Conditional Expression action not re-evaluating the expression if it changes at runtime (#1604).
- Fixed Scale Time bug with Adjust Fixed Delta Time not being respected (#1603).
- Unity 5.6 compatibility.
- Fixed GC spikes in FSM Logging in editor.
- Added SceneManager actions.
- Auto-expand description in State Inspector (#1617).
- Added Enable State Labels in Build preference setting. Defaults to false.
- Added Themes in Preferences > Graph View to support new Flat theme.
- Added more filtering options to the FSM Browser: Show Disabled FSMs, Show FSMs on Prefabs, Show Prefabs when Playing.
- Included Scale option in PlayMakerGUI Inspector for State Labels.
- Fixed type loading bugs in WSA builds.
- Fixed issues with new Call Method Editor.
- Added Favorites category in Action Browser. Use action context menus to Add/Remove actions from Favorites.
- Added Recent category in Action Browser. Recently added actions are added to the top of this list. Set the size of the list in the settings menu.
- Added option to scale State Labels in PlayMakerGUI. Useful on retina/HiDPI displays (#1540)
- Debugging: Cmd/Ctrl-Alt-Click any state to jump to it while playing game in editor (there doesn't have to be a valid transition).
- Fixed FSM selection bug after maximizing/unmaximizing the Playmaker editor (#1477)
- Fixed Set Property actions made from new drag and drop context menu. Temporary fix here.
- Fixed array parameters in Call Method action (#1481)
- Fixed Escape key in Variables Manager.
- Fixed WSA build errors.
- New custom editor for Call Method action. Should be a lot easier to use than old editor!
- Added MOUSE UP AS BUTTON, PARTICLE COLLISION, JOINT BREAK, JOINT BREAK 2D system events.
- Support OnParticleCollision in Collision Event action.
- New Set Procedural Vector actions (Substance).
- Save Debugger Step Mode on compile.
- Updated French and Chinese localized editor text.
- Playmaker now requires Unity 4.6 or higher.
- 1.8.1 integrates the following Add-ons and Actions:
Mecanim Animator Add-on
Vector2, Quaternion, and Trigonometry actions
If you already have these add-ons in your project you might get errors from duplicate files. Simply delete the older copy of the file (the one not in Assets\PlayMaker\Actions) to fix the error.
- Integrated Physics2D, Mecanim, Vector2, Quaternion, and Trigonometry actions.
- Added Coroutine support to actions. See FsmStateAction API (#1432)
- Added Parameter name browsing to Get/Set Animator Float/Int/Bool/Trigger actions.
- Log Missing Variables as Warnings instead of Errors so they don't stop the game from running.
- Added foldout next to Name in PlayMakerFSM Inspector for more compact view.
Added namespace support to script popup menu (E.g., Add Script and Add Component actions).
Click on missing variable warning in the console to select the GameObject.
- Added Every Frame option to GUILayoutToolbar action for when button content is changing.
Save Welcome Window "Show At Startup" setting per project.
Cleaned up Export/Import Globals tools. Now uses unitypackages and file save/open dialogs.
Added FsmEditor.OnFsmChanged callback. Useful for third party tool developers. Note the delegate might get called multiple times with some changes because of the way changes can chain in the editor.
Added Ctrl+Up/Down shortcuts to move selected transition up/down. Moved old shortcuts to Ctrl+Alt+Up/Down.
Rename selected action with F2 (#899).
FSM Log Window improvements:
Added clickable info to collision events.
Added StateTime to Exit entry in FSM Log window.
Added option to not show Exit entries in FSM Log window settings.
Added experimental "Manual Update" option in FSM Inspector.
Added experimental "Keep Delayed Events On State Exit" option in FSM Inspector.
- Fixed errors caused by threading problems with async loading (#1424).
- Fixed null ref error and variable values not updating in DebugFlow (#1430).
- Fixed false Missing Variable errors with OwnerDefault variables that previously specified a variable.
- Fixed bug where active control sometimes lost focus if error status changed (e.g. when editing required field).
- Put TextureExtensions in a namespace to fix conflicts with Cross Platform Native Plugin (#1434).
- Fixed graph not re-sizing when editing state names and descriptions.
- Fixed State context menu sometimes appearing when right clicking in other windows (e.g., FSM Log Window).
- Fixed State Inspector debugging of CustomActionEditors using EditField().
- Fixed empty FSM drop down in main toolbar after Maximize/Un-maximize window.
- Fixed build errors and warnings with WP8.
- Fixed Unity 5.4 beta warnings.
- FSMs saved with 1.8.0 cannot be opened in older versions of Playmaker!
- Playmaker now requires Unity 4.3 or higher.
- The Run FSM action in previous versions exposed all FSM variables. In 1.8.0 only variables marked as Inspector are exposed. Make sure all variables you currently use are marked as Inspector BEFORE upgrading to 1.8.0!
- 1.8.0 now properly finds errors in Templates. This means you might see new errors after upgrading - but they are likely errors that were already in the templates that were just not found before!
- Much faster loading in Unity 4.5+
- Array and Enum variables and actions.
- Added New Variable and New Event to selection menus to quickly add these without switching tabs.
- Added Auto Update Tools to help fix upgrade problems.
- Copy/Paste variables between FSMs in Variables Manager.
- Timeline Log window for more visual debugging.
- Variable Categories to keep your variables organized.
- Define custom editor colors in Preferences. Can be used on states etc.
- Added search categories to Event Browser (Filters: All, Global, Local, System).
- Preserve state selection across re-compiles and playmode changes.
- Only show variables marked as Inspector in Run FSM action.
- Improved feedback when drag/dropping project/scene assets.
- Added Preference to draw links behind states.
- Get/Set Property selection menus are faster. Use "More..." to drill down.
- Added ErrorCheck to Invoke Method and Start Coroutine actions to catch missing method names.
- Added FinishEvent to Smooth Look At Direction action.
- Added "Clear Transition Target" to transition context menu.
- Added "No search results" to Action Browser when search returns no results.
- Get Mouse Button actions: Implemented OnEnter so stored result behaves properly in stack with other actions.
- Added WiiU, Playstation Vita, XBoxOne, and PS4 compile directives to incompatible actions.
- Stop Animation action: Stops current animation if no name provided (#911)
- Experimental Auto Name feature for actions (in Action Editor Settings menu)
- Added Collider selection menu when auto-adding missing Colliders in Actions panel.
- Log error if Get/Set FSM variable actions cannot find the specified FSM.
- Improved error checking and usage counts in Templates.
- Template Browser now shows Templates with errors.
- Actions now cache component access for improved performance (and Unity 5 compatibility).
- Option to lock and password protect FSMs.
- Show active state in minimap.
- Array and Enum actions
- Call Static Method
- Conditional Expression
- Raycast All
- Destroy Objects
- Convert Seconds To String
- Random Wait
- Move Object
- Set Drag
- Fixed potential corruption of data when editing Prefab Instances.
- Fixed memory leak with last selected FSM (#2166)
- Fixed AnimationCurve parameters losing wrapmode in templates. (#859)
- Fixed Call Method error check when target behaviour is not known at edit time.
- Fixed Ambiguous Method errors in Call Method action with overridden methods.
- Fixed save template bug when project had parent folder with "Assets" in the name. (#1018)
- Fixed template sometimes not finding proper save directory (#2168)
- Fixed "Find script in action browser" not auto-scrolling if already selected. (#1027)
- Fixed bug with negative numbers in Animate Variables actions.
- Fixed nullref error when renaming event then setting it to global. (#1007)
- Fixed Action Browser shortcut conflict with OSX focus window shortcut. (#977)
- Fixed Graph View bug where mouse clicks passed through scrollbars (#738)
- Fixed starting values of Ease Actions (#1253)
- Fixed Add Force action retaining old x, y, z values (#1197)
- Fixed GUI Text with custom font not rendering in Unity 5 (#1207)
- Fixed templates with duplicate names not showing in Template menus (#1153)
- Fixed State auto-framing in Unity 4.3 on play.