This page outlines step-by-step instructions to be followed when installing Luna Playable into a new or existing Unity project.
Luna Playable has the following system requirements:
- Unity Personal or Pro 2018.4 or later
- MacOS or Windows
- .NET 4.7 or later
- .NET developer pack 4.7
For more information, please review the list of dependencies for Luna.
Depending on your license agreement, you will get Luna in one of two flavours: as a Unity package or as a full source code distribution. The installation steps will vary depending on your specific type of package.
Installing via Package Manager (Unity 2018.3 or newer)
Package Manager UI of Unity stores links to external packages using absolute paths. This is un-portable and will break once the project is opened on another developer's machine.
Installing Luna in Unity 2018.3 or newer can be done using Package Manager UI. To get it installed into a project, please perform the following steps:
- Unzip Luna release file anywhere you like
- Open Package Manager UI by navigating to
Window > Package Managerin main Unity menu:
- In Package Manager UI, hit "+" button located in lower left (or lower right, depending on your Unity version) part of the window, choose "Add package from disk" and select
lunafolder you unzipped Luna to in step 1:
Once finished! Feel free to open Unity editor with your project and jump to initial setup.
Manual installation (Unity 2018.2 or newer)
In order to install Luna it is required to amend
Packages/manifest.json file pointing Unity to a folder with Luna package manifest, so that Unity can discover and install Luna's editor extension. This can be done by following the below steps:
- Make sure Unity editor is shut down for the project
- Unzip Luna release file to any folder on your machinePRO TIP
Best is to keep Luna folder somewhere next to your projects, so that you can always reference Luna folder relatively to a project folder.
Packages/manifest.jsonfile with any text editor
- Add a key
"uk.lunalabs.luna"with the value of
"dependencies"(root) key. Please mind the
RELATIVE_PATH_TO_LUNA_FOLDERshould be relative to
Packagesfolder of your project. Your JSON file should look like the below:
Let's imagine the following preconditions:
- Your project sits at
- You put Luna next to your project, at
This way, your
manifest.json reference should contain an entry with
You are done! Feel free to open Unity editor with your project and jump to initial setup.