This page contains a list of common issues and how to solve them.

Editor

Error: "Invalid operation. Can't add script behavior TMP_Text." when adding the TextAnimatorPlayer component

Explanation: It means that you don't have a "TextMeshPro" component on your GameObject.
Solution: Add a component that inherits from TMP_Text and then try again (you can add both the GUI or the 3DMesh one).

Error: The type or namespace name 'TMPro' could not be found (missing directive or assembly reference)

Please install the package "TextMeshPro", available in the Unity's package manager.

Error: 'TMP_TextElement' does not contain a definition for 'unicode' [...]

Please update the TextMeshPro package to the latest version.

Compiler errors with TextMeshPro (e.g. "TMP_TextUtilities does not contain a definition for StringHexToInt")

Please make sure you're using a newer version of the TextMeshPro package, starting from version "1.4.1" with Unity 2018.4.X or "2.1.3" for Unity 2019.4.X.

Global Effects tags are not formatted in the Editor (Unity 2019.x or above)

If you're using Unity 2019.x or above and the Editor is not loading global effects, be sure that you have "ProjectSettings/Editor/EnterPlayModeSettings → Reload Domain" set to true and enter playmode once.

Object at index 0 is null

Please close and reopen the Inspector tab, and restart the Unity Editor.

Updating

Unity Package's Manager doesn't update to the latest version of Text Animator

This is a bug on the Unity side and it seems to be fixed from the latest 2019.X and 2020.X versions. Read here for more.
P.S. If you're using 2019.X, you can fix it by also updating and importing the asset directly from the Asset Store.

I have errors after updating to a newer version

Please be sure to read the Updating Guide and follow all the necessary steps.

Third Party Plugins

Why is the [insert any plugin here]'s integration not working?

Please be sure to read the Third Parties Integration guide and follow each related step.
If it still doesn't work, feel free to contact me.

Programming

I can't find the type "TextAnimator" in my script

Explanation: "TextAnimator" is inside the "Febucci.UI" namespace.
Solution: Be sure to include "using Febucci.UI;" at the top of your script.

Performance

Lag spike when the text is set for the first time

This might happen if you have a large codebase, and TextAnimator wasn't initialized before setting the text. To fix this, please initialize TextAnimator when your game is loading (or similar), by calling TAnimBuilder.InitializeGlobalData() (Scripting API).