Installation¶
Getting Octoputs into your Unity project takes about two minutes. You will import it from the Asset Store, accept one prompt, and you are ready to build.
Quick Install¶
- Import from the Unity Asset Store. Open the Asset Store page for Octoputs, click Add to My Assets, then open the Package Manager in Unity (Window > Package Manager) and import it.
- Accept the Jungle bootstrap prompt. After import, a dialog appears asking to install the Jungle Core dependencies. Click Install - everything else happens automatically.
- You are ready. All packages are installed and you can start building drag-and-drop interactions right away. Head to the basic tutorial to create your first one.
Verify Installation¶
Open Window > Jungle > Jungle Hub to confirm that all packages are present and up to date.
The Jungle Hub shows each installed package, its version, and update availability. If any package shows as missing, click Install next to it.
Requirements¶
| Requirement | Details |
|---|---|
| Unity version | 2021.3 LTS or newer |
| Render pipeline | Any (Built-in, URP, HDRP) |
| Newtonsoft JSON | Auto-installed by the Jungle bootstrap. If your project already has it, no duplicate is added. |
| Platform | All platforms supported by Unity |
Project Structure¶
After installation, your project contains:
Assets/
Plugins/
Jungle/
Jungle Core/ - Shared infrastructure (values, processes, conditions)
Octoputs - 3D Drag And Drop/
Runtime/ - All runtime components
Editor/ - Inspector customizations
Examples/ - Example scenes (optional, can be deleted)
Troubleshooting¶
Only use these steps if the automatic bootstrap did not work
The bootstrap prompt handles all of this for you. These manual steps are a fallback.
Manual Registry Setup¶
If the bootstrap dialog did not appear or was dismissed, add the Jungle scoped registry manually:
- Open
Packages/manifest.jsonin a text editor. - Add the Jungle registry to the
scopedRegistriesarray:
{
"scopedRegistries": [
{
"name": "Jungle",
"url": "https://registry.jungle.dev",
"scopes": [
"com.jungle"
]
}
]
}
- Save the file. Unity will resolve and download the packages on the next domain reload.
Common Issues¶
"Missing assembly reference" errors after import : Open Window > Jungle > Jungle Hub and install any missing packages. If the Hub is not available, ensure the Jungle Core package is present in your Packages folder.
Newtonsoft JSON conflicts : If your project uses a different version of Newtonsoft JSON, the Jungle bootstrap detects this and skips the duplicate. If you see version conflicts, remove the older version and let Jungle install its dependency.
Scripts not compiling after Unity upgrade
: Delete the Library/ folder and reopen the project to force a clean reimport. Then reopen the Jungle Hub to verify all packages.