Upgrading from Tessera to Tessera Pro

Unfortunately, it's not possible to preserve compatibility in Unity when replacing a .dll with a set of scripts.

If you previously developed a game with Tessera, and you have now downloaded Tessera Pro instead, you'll see the following error.

Don't panic. All your data is still there.

To fix it, please follow the following instructions.

Backup your project

Always a sensible idea before making any major changes.

Enable Visible Meta Files and Force Text Serialization

This is the default for new projects, but just in case, go to Edit > Project Settings > Editor and select:

• Version Control Mode: Visible Meta Files
• Asset Serialization Mode: Force Text

Replace the Unity references

Close Unity, then open the scene files in any text editor. Then you want to make the following replacements:

Find: fileID: -65694588, guid: 5ec9deea42ffdf94eae3261973878f98
Replace: fileID: 11500000, guid: e3ad2bf01b7a6b7409eb683402aa8669

Find: fileID: 2003858105, guid: 5ec9deea42ffdf94eae3261973878f98
Replace: fileID: 11500000, guid: 8a3f7e4cbfb5a184b8e397a0175d7112

Similarly, in any TesseraPalette assets you have:

Find: fileID: -96226770, guid: 5ec9deea42ffdf94eae3261973878f98
Replace: fileID: 11500000, guid: 333e56fb2e5d1ff4bb53c10611586ded

Save your changes, then reload the scene in Unity. If done correctly, the scripts should now work.

Delete the dummy references

In order to warn users that references have changed, Tessera Pro comes with some "dummy" files that use the old references. These are only used for a warning, so can be safely deleted afterwards. The files are:

• TesseraDummy.dll
• Editor/DummyTesseraTileEditor.cs
• Editor/DummyTesseraGeneratorEditor.cs
• Editor/DummyTesseraPaletteEditor.cs

Downgrading

Follow the same steps for going from Tessera Pro to Tessera, just swapping which strings to find/replace.