📦Installation

There are two ways to install Yarn Spinner for Unity: via the Package Manager, and via a .unitypackage file.

Install via the Unity Package Manager (recommended)

You can install the Yarn Spinner package into your project using the Package Manager window in Unity.

Yarn Spinner is available via the OpenUPM registry. This is the simplest way to install Yarn Spinner, and makes it easy to keep it up to date.

Setting Up the OpenUPM Registry in Your Project

Before you can install Yarn Spinner from OpenUPM, you first need to configure your project so that it knows where to get the package from.

1. In Unity, open the Edit menu, and choose Project Settings.

2. In the list of sections at the left hand side of the window, select Package Manager.

This window is where you tell Unity about where to find packages that come from registries besides Unity's built-in one.

1. In the Name field, type OpenUPM.

2. In the URL field, type https://package.openupm.com.

3. In the Scopes field, type dev.yarnspinner.

4. Click Save.

When you're done, the settings window should look like this:

You can now install Yarn Spinner itself.

Installing the Yarn Spinner package

1. Open the Window menu, and choose Package Manager.

2. In the toolbar, click Packages: In Project, and choose My Registries.

1. Yarn Spinner will appear in the list. Select it, and click Install.

Yarn Spinner will download and install into your project.

You can verify that everything is imported succesfully by looking for Yarn Spinner under Packages, in the Project pane.

Install from GitHub

As an alternative to downloading Yarn Spinner from OpenUPM, you can install Yarn Spinner by downloading the package directly from GitHub, where the project's source code is stored.

To install Yarn Spinner from GitHub, follow these instructions.

1. In Unity, open the Window menu, and choose Package Manager.

2. Click the + button, and choose "Add package from git URL".

1. In the text field that appears, enter the following URL: https://github.com/YarnSpinnerTool/YarnSpinner-Unity.git.

1. The project will download and install. This might take a moment.

Install as a file

If you don't want to install Yarn Spinner as a package, you can download it as a .unitypackage file, and extract it into your project.

To download and install the file, follow these steps:

1. In Unity, open the Window menu, and choose Package Manager.

2. Locate Text Mesh Pro in the list, and select it.

3. Click the Install button to install Text Mesh Pro. This package is required for Yarn Spinner to work.

4. Next, open your browser, and go to the most recent release of Yarn Spinner for Unity on GitHub.

5. Download the .unitypackage for that release.

1. Open the .unitypackage. Unity will ask which files you want to add. In almost every case, you'll want to import all files.

1. Click Import.

Next Steps

Once you've installed Yarn Spinner, you're ready to start using it!