This update brings some initialization performance improvements and reduces memory usage.

Full release notes

Tutorial Master Update 3.0.2 is here! This update brings several bug fixes. Thank you for your feedback and bug reports!

A small quality of life improvement is that you can now quickly tell whether comments have been added to any of the action nodes. Hovering over them will reveal the comment you've written.

Full release notes

Changes & Improvements​

General​

• Added support for Unity 6000.1
• API updates to allow you to go to specific stage from IStageContext

Bug fixes​

General​

• Fixed missing tooltip for Event actions

🎂 Initial release

Changes & Improvements​

This update modernizes Tutorial Master, bringing it up to speed with the latest Unity versions, while getting rid of the old ones.

General​

• Updated outdated Component help pages to point to the new documentation

• Added support for the following versions:

  • Unity 2019.4
  • Unity 2020.3
  • Unity 2021.3
  • Unity 2022.3

• Removed support for the following versions:

  • Unity 2017.1
  • Unity 2018.1
  • Unity 2018.2
  • Unity 2018.3
  • Unity 2018.4
  • Unity 2019.1
  • Unity 2019.2
  • Unity 2019.3

• Api compatibility level now requires .NET 4.x or higher

You may find complete set of requirements for Tutorial Master on this page.

Changes & Improvements​

RockTomate no longer ships Odin Serializer DLL. Instead, it includes its source code in its own assembly definition. Because of changes with Odin Serializer, the current version of RockTomate must be removed before importing a new one.

There should be no conflict with other Odin-based products in your project. Your existing Jobs won't be affected, but you should always backup your project before an upgrade.

General​

• Added support for Unity 2022.3
• Removed support for Unity 2018.4
• Api compatibility level now requires .NET 4.x or higher
• Updated Odin Serializer library (2024.2.27 - 3d90af7a)
• [Condition Editor Control] String comparison improvements. Can now compare the ordering of strings. For example (e.g. "A" < "B" would resolve to true)
• [Condition Editor Control] Can now selectively enable/disable each condition statement

Steps​

• [Build Asset Bundle] Removed Deterministic field as it's no longer being used
• [Set Variable] Improved variable assignment
• [Run Executable] Added StandardOutput and ErrorOutput output fields to pipe process error/output back to RockTomate

Macros​

• Added: dirpath()
• Added: filepath()

Bug fixes​

General​

• Fixed a bug where creating variables of UnityScene type would cause errors
• Fixed a runtime error that would happen when trying to open a Job asset file after upgrading Unity versions
• Fixed an exception being thrown when variable bank editor window reloads after re-compilation

Variables​

• [Variable Manager] Can now search variables
• [Variable Bank Window] Can now search variables
• Fixed an error that would occur when opening array editor
• Improvements to array-based formulas
• Fixed a bug when interpolated macros would resolve to System.String[] instead to an actual value. It will now interpolate the 1st item in an array instead.

Steps​

• [Print] Fixed a bug when "Print to Console" option wasn't working properly

Due to the changes in the project hierarchy, the current version of RockTomate must be removed before the new one could be imported.

Your existing jobs will be unaffected.

You may notice that steps in your existing jobs will have a status of "Unknown". This is completely normal and will be gone after you run jobs at least once.

Changes & Improvements​

Documentation​

• Macros Wiki on GitHub has been deprecated and is no longer being maintained. All content has been migrated to Macro References page.
• Steps Wiki on GitHub has been deprecated and is no longer being maintained. All content has been migrated to Step References page.

General​

• Added support for Unity 2021.2
• [Editor] Miscellaneous performance and optimization improvements
• [Editor] Disabling a Step now shows a warning message in Step Properties window. You can disable this behaviour in Preferences > RockTomate > Show Step Disabled Warning
• [Editor] Can now quickly open Step's .cs file from Step Properties window. This option is turned off by default and can be found in Preferences > RockTomate > Show Step Script Field
• [Editor] Added a scroll when dealing with large lists in variable list editor window
• [Job Session Console] Added a preference option to print Job Session console messages to Unity console window as well
• Can now mark Steps' input fields as "sensitive", which hides their output value in log messages
  • this feature is brand new so please still check your log messages that you share with public. If you think some sensitive info is still leaking please let me know
• RockTomate now stores session data in "Library/RockTomateCache" directory

Steps​

• [Build Player] Specifying file path in the Output Path field will now override the File Name and won't append an extension. This was done to ensure backwards compatibility with older configurations made before version 1.1.3
• [Upload to Asset Store] Marked Username and Password fields as sensitive
• [Build Asset Bundles] Added a missing compression option: Standard LZMA, which is now a default option

Macros​

• Added: merge()

Bug fixes​

General​

• [Job Editor] Fixed a bug when editing Job or its Step properties wouldn't mark it as dirty reliably

Variables​

• Fixed a bug when Variable Banks did not respect "keep persistent" setting and would save values regardless

Steps​

• [Run Job] No longer fails when trying to run a "Loop" step in sub-Job
• [Run Job] Fixed a bug when step is marked as successful even if sub-job failed
• [Run Job] Fixed a bug when step is marked as failed if one of the steps in sub-job has failed but is marked as "suppressed"
• [Build Asset Bundles] Now correctly applies Chunk Based and Uncompressed options to asset bundles

Changes & Improvements​

General​

• Added support for Unity 2020.3
• Added support for Unity 2021.1
• Event manager data file is now required to be manually assigned instead of being auto-created on project initialisation.
• Added a shortcut option to stop a currently running RockTomate job.

Variables​

• Can now create and edit array-type variables

Steps​

• [Build Player] Added File Name field to ask for exported file name where needed. Extension will be appended depending on the chosen platform.
  • to clarify, the Output Path field is for folder output path and will always be required
• [Build Player] Now checks if the Build Target is supported by a currently running Unity engine
• [Create GameObject] Now passes created game object as an output field

Macros​

• Added: is_empty()
• Added: join()

Root Variables​

• Added: %IncludedScenesInBuild%
• Added: %AllScenesInBuild%
• %ScriptingRuntimeVersion% is no longer available in Unity versions 2019.3 and later as it's been deprecated

Bug fixes​

General​

• Fixed one-time compilation errors occurring when importing RockTomate for the first time

Variables​

• Fixed a bug when variables that have formulas enabled would be modified when copying resolved value to clipboard

Steps​

• [Create GameObject] Fixed a bug when step would create 2 same GameObjects instead of one
• [Set Variable] Fixed an error if variable was not found when "Create New" option is disabled
• [Run Job] Fixed a bug when formulas wouldn't be correctly resolved when overriding job variables

This version introduces a new dependency: LibGit2Sharp

Changes & Improvements​

General​

• Can now run Jobs via shortcuts (Unity 2019.1 or newer)
• Memory management improvements

Job Editor Window​

• Can now open recent jobs when no job has been selected
• Disabled "Run This" option for Comment steps

Step Browser Window​

• Improved search algorithm

Step Properties Window​

• Field types that have generics (e.g. List<string>) are now displayed correctly in tooltips

Variable Manager Window​

• Can now reorder variables

Variable Bank Editor Window​

• Can now reorder variables

Steps​

• Added: Run Unit Tests (requires com.unity.test-framework)
• Added 12 Git-related steps (.NET 4.6 or newer):
  • Init
  • Add
  • Remove
  • Commit
  • Apply Tag
  • Get Repository
  • Get Branches
  • Get Branch History
  • Get Work Directory Files
  • Compare Commits
  • Create Branch
  • Checkout Branch
• [Print List] Fixed an issue when trying to print with an empty list would fail this Step
• [Run Job] Added "Auto Run" option
• [Build Player] Added "Manual Cancel Fails Step" option (enabled by default). Cancelling building process manually will no longer mark Step as successful by default.

Macros​

• Added: peel()
• Added: is_git_repo()
• Added: get_git_last_commit_hash()
• Added: get_git_current_branch()

Root Variables​

• Added: %ScriptableRuntimeVersion%
• Added: %IsGitRepo%
• Added: %GitLastCommitHash%
• Added: %GitCurrentBranch%

Bug fixes​

General​

• Fixed a bug when RockTomate's preferences could not be edited and SerializedObject target has been destroyed error being printed all the time
• Fixed a bug when formula icons wouldn't render properly (Unity 2020.1 or newer)

Job Editor Window​

• Fixed a bug when opening a Job wouldn't focus the window if it's already been opened before

Step Browser Window​

• Fixed a bug when step list items wouldn't render properly (Unity 2020.1 or newer)

Changes & Improvements​

General​

• [Job Editor Window] Improved performance when large Jobs with lots of steps are rendered
• Added support for Unity 2020.2
• Upgraded Odin Serializer version
• New Step status: Unknown. If you see it, that means there was an internal error when trying to retrieve Step's status. Keep an eye out for it and if you see it, report it.

Bug fixes​

General​

• Fixed serialization issues when trying to run Steps that have fields of type Unity.Object
• Fixed a bug that caused Unity to freeze occasionally when duplicating Jobs or Variable Banks (using CTRL/CMD + D shortcut command)
• Fixed a bug that caused Unity to freeze occasionally when starting a project
• Fixed a bug when menu item at Tools > RockTomate > Utils > Open Directory > Project Root wouldn't open root of the project directory