Quickstart
Prerequisites
Check the Prerequisites page first.
Registration
- Create a new organization account at console.aukiverse.com.
- Click "apps" in the left-hand panel to add an app to your organization.
- Save your
app_key
andapp_secret
somewhere safe. They won't be displayed in the console again!
Create a new project
Open Unity Hub and create a new 3D Project using Unity Editor 2021 (preferably an LTS version).
Setting up ConjureKit
Setting up Node.js on Windows
One way to quickly install Node.js is via Chocolatey, installed following the official guide.
Once installation is complete, you can run from a new Powershell window:
choco install nodejs
Setting up Node.js on Mac
A quick way to install Node.js on Mac is to run is through Homebrew
brew install node
Verify Node.js is correctly configured
To check you have all you need and node/npm versions are correct, you should be able to run from any console:
node -v
npm -v
Node should be equal or above the min version suggested in the Prerequisites.
Authenticate towards the registry
ConjureKit and its related packages are distributed through our registry (npm.aukiverse.com). To log in to the registry, run from any location:
npx conjurekit-setup@latest login
And enter the same credentials you use to access console.aukiverse.com. Then run:
npx conjurekit-setup@latest configure --project-type Unity
Add the Auki Labs registry to your project
Now that you have configured access to the registry, you need to add it to Unity. You can add new scoped registries in Unity inside Project Settings -> Package Manager.
In detail:
- Click the left-hand '+' to add a scoped registry.
- Set the Name, URL, and Scope(s) fields as below.
- Click "Apply".
name: Auki Labs
URL: https://npm.aukiverse.com
scopes: com.aukilabs
Installing ConjureKit
Adding the registry item BEFORE completing the credentials setup will result in no My Registries
menu item visible in Package Manager or no Auki Labs
section within it.
If this happens to you, once you complete authentication, make sure you restart Unity and open Package Manager again.
With the registry configured, restart Unity to see the registry added to the Unity package manager under My Registries
.
You can now install ConjureKit and related modules from here:
Make sure Manager Stripping Level is Minimal in Edit->Project Settings->Player->Other Settings
otherwise, some ConjureKit code might get stripped when building, resulting in unexpected behavior.