> For the complete documentation index, see [llms.txt](https://docs.febucci.com/text-animator-unreal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.febucci.com/text-animator-unreal/welcome/quick-start.md).

# Quick Start

{% hint style="info" %}
Using the asset is a matter of a few clicks (install plugin -> add an Animated Text Block to Widget Blueprint -> observe results), but to better understand everything please have a look at the following pages, so that you can start even faster and in the right direction.
{% endhint %}

## 1. Import Text Animator <a href="#how-to-implement-text-animator" id="how-to-implement-text-animator"></a>

As the first step, you need to import Text Animator in your project.

1. **Extract and move the plugin into the Unreal Engine editor folder.** Mind to install it in the version of the editor of your current project (in Windows is usually `C:\Program Files\Epic Games\UE_<VersionNumber>)`. To see the plugin you have to put it inside **`<PathToEditorVersion>/Engine/Plugins/Marketplace`** folder. If your project doesn't have one, you can create it with that exact name.
2. **Enable Text Animator for Unreal in your Plugins window.** You should now see the plugin in your project by clicking on Edit -> Plugins. You should find Text Animator in the "Text" category or searching by name. Make sure to activate it by clicking the checkbox on the left.

   <div align="left"><figure><img src="/files/dGVt6zI8FWQnYRlDdgLS" alt=""><figcaption></figcaption></figure></div>
3. **You will be asked to restart the Editor.**
4. **After the restart the plugin will perform its first install operations and show the welcome window.** You can just close the window and proceed. You should see a new folder "Plugins/TextAnimatorFebucci" in your project's content folder.
5. **Create a Widget Blueprint and open it.** From the palette on the left, add a `Animated Text Block` widget.

This is the text widget as seen in the palette:

<div data-full-width="false"><img src="/files/Cx0eF3aHEBrzmU5BMjnS" alt=""></div>

You can now set a text (don't forget to set a font family!) and it will be ready to be animated!!

<figure><img src="/files/kcMkj1YDXwlRPYAu4MGZ" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
*Done! We told you that it would have been quick!*\
Your text is now ready for effects.
{% endhint %}

## 2. Example Levels

You can learn about most Text Animator features directly from the editor, through example levels, and see how we've set up things and their direct result (of course, this documentation includes all of them in detail plus extra customization and tips - don't miss them!).

You should see them in the `Engine/Plugins/TextAnimatorFebucci/Example` along with some extra effects for your project and to show you how customization works (for more see also [Extra Customization via C++/Blueprints](/text-animator-unreal/customization/extra-customization-via-c++-blueprints.md))

<figure><img src="/files/YVRiJRZ7zUu3ZmLNCfrc" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
To show this folder click on the three dots on the upper right section of the Content Folder and make sure "Engine Content" and "Plugin Content" are checked.
{% endhint %}

## 3. Animating your first texts <a href="#animating-your-first-texts" id="animating-your-first-texts"></a>

Here’s how to quickly animate your first texts.

![](/files/LbSngiydDWQ4wqPxUKid)

### Writing effects in your text <a href="#id-1-writing-effects-in-your-text" id="id-1-writing-effects-in-your-text"></a>

To add effects in your text, you can use rich text tags like this: “`I'm <shake>freezing</shake>`”, where "shake" is a tag ID for a built-in effect.&#x20;

* On the right hand side, in the Details window, try writing in the Text property and experimenting with the following tags: `<wiggle>` `<shake>` `<wave>` `<bounce>`, like “`<wiggle>I'm joking</wiggle> hehe now <shake>I'm scared</shake>`”, then compile the Widget Blueprint. You'll witness the results right away.

{% hint style="success" %}
Your text is animating letters based on the effects you’ve written.
{% endhint %}

### Showing letters dynamically <a href="#id-2-showing-letters-dynamically" id="id-2-showing-letters-dynamically"></a>

As you've seen, letters were typewritten. In general, to show letters dynamically (like a typewriter):

* Make sure a Typewriter is selected under the Typewriter category. By default, `Typewriter By Character` is selected.
* Tell TextAnimator that you want to use the typewriter. This is simply done with the bool variable below, "Starts Automatically".

<div align="center"><figure><img src="/files/Cn218QPRjfgaXZsbi81T" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Your text is now shown dynamically, like a typewriter.&#x20;
{% endhint %}

***

Have fun animating your texts! You can proceed to the next page for a more in-depth look on all the asset's features.
