Installation for Unity
This page shows you how to install Yarn Spinner for Unity, the Unity integration for running Yarn and Yarn Spinner scripts in your Unity-based games.
Last updated
Was this helpful?
This page shows you how to install Yarn Spinner for Unity, the Unity integration for running Yarn and Yarn Spinner scripts in your Unity-based games.
Last updated
Was this helpful?
You can download and install Yarn Spinner for Unity in a variety different ways. The best ways to download and install Yarn Spinner for Unity, and the ones that support us to continue developing it the most are via Itch.io and the Unity Asset Store.
First, visit the Yarn Spinner Itch.io Store, and click the Buy Now button, and complete the checkout process.
Once you've purchased Yarn Spinner, you'll find a Download button at the top of the page:
The download button will take you the following page, where you can download the Yarn Spinner for Unity .unitypackage
:
Once you've downloaded the .unitypackage
, with the Unity project you want to use it in open and ready to go, double click it. Unity will then allow you to import the package into your project:
For version 3 of Yarn Spinner the samples have been removed from the main repository and made a standalone package. We did this because as the samples were growing they were becoming a larger and larger portion of the install, this was essentially bloating an install of Yarn Spinner while at the same time making development slower and more annoying. The samples are a necessary element of Yarn Spinner so instead of being treated like an afterthought they have been spun out into their own thing. Now they can be developed, improved, tested, have their own dependancies, and share a common sample codebase without needing to impact the rest of Yarn Spinner, meaning more—and better—samples than in the past.
The best way to install the samples is to use the Samples button on the inspector of any Dialogue Runner, Yarn Project, or Yarn Script.
Or by navigating to Window -> Yarn Spinner -> Install Samples Package
.
Clicking on this will work out the best way to install the samples depending on how you installed Yarn Spinner itself.
While the best way to install samples is the above, depending on your environment and device setup this might not be possible. In those circumstances you will need to manually install the samples, which is what this section is about.
Inside your browser navigate to the samples site: https://github.com/YarnSpinnerTool/YarnSpinner-Unity-Samples
Click on the Code button and from the dropdown select the Download Zip option
Save this zip somewhere useful and unzip it
This folder now contains the samples package and it's time to add it to your Unity project.
Back inside Unity open the package manager from the menu Windows -> Package Manager
In the top left corner press the +
button and from the dropdown that appears select Install package from disk
Navigate to where you downloaded and unzipped the samples and select the package.json
file inside that folder
Unity will now install the samples project after a little while. Once it is done you can now browse and install the samples directly from the package manager.
select the samples package in the middle column and click on the Samples tab in the main window.
And just like that you can now install and explore the samples!