1️⃣ You're browsing the documentation for version 1.X. If you want to check version 2.X instead, please go here. 1️⃣


Integrated Plugins & Dialogues Systems

This asset is already compatible with the following third parties’ Dialogue Systems and Plugins. (Remember: you must enable TextMeshPro in your project.)

In case your plugin is not officially integrated, you can read here: how to manually integrate Text Animator with third parties plugins.


Easy Integration

To integrate the plugins in this section you don’t have to install any external packages. (However, you may have to disable their typewriter and replace it with TextAnimator’s one.)

  • You can simply add the TextAnimatorPlayer and TextAnimator components (near a TextMeshPro component) and set the “UseEasyIntegration” value to true.

Here’s everything summed up in an image:

textanimator easy integration setup

⚠️ Invisible tags appended to your text

If you're using Easy Integration, TextAnimator will add two invisible tags in appendix to your text in order to work. No worries, the text placement/layout will be left unchanged and it will act like if the tags are not written at all.

Explanation

This is to "force" TMPro/TextAnimator to being triggered when the text changes, even the same string has been written/pasted twice. You can disable this tag placement by adding the `#TA_NoTempFix` preprocessor define, but be aware that you won't be able to set similar texts multiple times subsequently (like text = "hello"; text = "hello") unless it has rich text tags (like text ="<shake>hello"; text = "<shake>hello").

The following plugins can be integrated also using the Easy Integration.


✔️ Dialogue System for Unity

How to setup 'Dialogue System for Unity' with 'Text Animator'
  • Use TextMeshPro instead of Unity's built-in Text
  • Remove its typewriter script/effect
  • Add the components "TextAnimator" and "TextAnimatorPlayer". to your dialogue text, as shown in the Easy Integration steps.

P.S. Be sure to have removed the DialogueSystem's Typewriter component, and only use TextAnimator's one.


✔️ Yarn Spinner

Yarn Spinner (open source): website.

How to setup 'Yarn Spinner 2.X' with 'Text Animator'

You can integrate Yarn Spinner 2.X in two main ways.

  • The first one is to use TextAnimator's typewriter (so, disabling Yarn Spinner's one), which is preferable in case you want to use all Text Animator's features like pausing the typewriter, waiting for player input and more.
    • In the "Line View" script, disable "Use Typewriter" and "Use Fade Effect".
    • Add the components TextAnimator and TextAnimatorPlayer to your dialogue text, as shown in the Easy Integration steps.
  • The second way is to keep using Yarn Spinner's typewriter (but you wouldn't be able to use Text Animator's typewriting features).
    • In the "Line View" script, set "Use Fade Effect" and "Use Typewriter Effect" to true.
    • Add a TextAnimator component to your dialogue text, and be sure to disable "Use Easy Integration".
How to setup 'Yarn Spinner 1.X' with 'Text Animator'
  • Use TextMeshPro instead of Unity's built-in Text
  • "DialogueUI" component, set "text speed" to 0.
  • "DialogueUI" component, set the "OnLineUpdate" event with TextMeshPro's text.
  • textanimator integration yarnspinner lineupdate
  • Add the components TextAnimator and TextAnimatorPlayer to your dialogue text, as shown in the Easy Integration steps.

✔️ Ink

How to setup 'Ink Unity Integration' with 'Text Animator'
  • Use TextMeshPro instead of Unity's built-in Text
  • Add the components TextAnimator and TextAnimatorPlayer to your dialogue text, as shown in the Easy Integration steps.
  • You can now set your dialogues texts by referencing the TMPro's text in your Ink script, or you can reference the TextAnimatorPlayer directly. (eg. "textAnimatorPlayer.ShowText(inkDialogueLine);).

Classic Integration

To integrate the following plugins, you can import the related integration package in your project, found in the TextAnimator/Integrations folder.

Don’t forget to a TextAnimatorPlayer and TextAnimator components (near a TextMeshPro one).

✔️ PlayMaker

How to setup 'PlayMaker' with 'Text Animator'

In order to create FSMs with PlayMaker, you have to extract the "PlayMaker - Integration" package in your project. You can find it in the Plugin/TextAnimator/Integrations folder.
After doing so, you'll find its action added to PlayMaker, called "Set Text".

textanimator integration playmaker settext action

You can use it to set the typewriter's text, showing the text dynamically etc.
To edit its settings, edit the referenced `TextAnimatorPlayer` component in the inspector.

textanimator integration playmaker statemachine example

✔️ Unity Visual Scripting

You can install Unity’s Visual Scripting from the package manager, from Unity 2021 and beyond.
Package’s tested from version: 1.7.6

How to setup 'Unity Visual Scripting' Integration with 'Text Animator'

To use Text Animator with visual scripting, be sure to go to project settings -> visual scripting -> nodes, and add TextAnimator's Runtime assembly there, like this: unity visual scripting nodes assembly febucci text animator Then, click "Regenerate Nodes".
You will now be able to use all TextAnimator methods in your visual scripting graphs, like the TextAnimatorPlayer's "ShowText" and "Start Typewriter".
You can find the TextAnimator Scripting Api here, or simply create a new node in the Visual Scripting Graph:
board unity visual scripting febucci text animator In order to subscribe to TextAnimator events (e.g. playing audio when a character is shown), you need to create a Custom Event.
To do so, you can either import the "Visual Scripting - Integration" package that you can find in the TextAnimator folder, or you manually create a C# class that acts like a "bridge" between Text Animator and Unity Visual Scripting like this: bridge events class unity visual scripting febucci text animator P.S. be sure to include its assembly in the "Nodes" section of the visual scripting settings (and then hit "regenerate nodes"), like you did before with Text Animator. You will now be able to use trigger from these events in your graph like this: events unity visual scripting febucci text animator


Partial Integration

The following plugins work with TextAnimator, but some of its feature might not be available.

✔️Naninovel

How to setup 'Naninovel' with 'Text Animator'

With Naninovel, you can use TextAnimator's animations but not the TextAnimatorPlayer component (TextAnimator's typewriter). You have to use Naninovel's typewriter.
It is a compromise in order to not change any plugin structure and stability <3

  1. You need to create and set a "Naninovel Text Mesh Pro printer", for example duplicating its "TMProDialogue" prefab. Please read the Naninovel's guide on how to add printers to naninovel.
  2. Reference Naninovel's assembly, in the Febucci.TextAnimator.Runtime asdmef (found in the Scripts/Runtime) folder.
  3. Add "TA_Naninovel" in the scripting define symbols. (Edit→Project Settings→Player→Other Settings). textanimator integration naninovel scriptdefinel
  4. Your TMPro printer must have a `TextAnimator` component on the text gameObject that you want to animate.
  5. In the text gameObject that you want to animate (like"DialogueText"), edit the "ReveableTMProText"'s "Revealing section" and disable its fade effect. You could keep this active, but TextAnimator's effects may change because of it (with a fade effect applied.); it's suggested to use TextAnimator's one at this point. textanimator integration naninovel set revealing
  6. (Don't forget to set that printer as active in your Naninovel dialogues.)

Extra: to create a printer with TextAnimator, one example may be duplicating the TMProDialogue prefab (which has the "ReveableTextPrinterPanel" component on top), locating the "DialogueText" gameobject and adding the "TextAnimator" component near the "ReveableTMProText" component.


Investigating

The following plugins are currently being researched and their integration with TextAnimator is not guaranteed (with our without code). Please read How to manually integrate Text Animator for more info and the Public Roadmap.

❓ Fungus

❓ Adventure Creator

End of the page. Go back to the Documentation Index.