Skip to content

Third_Party

Jump to bottom
Jack Brett edited this page Dec 5, 2025 · 10 revisions

Now you have imported LUTE using the package version, it is important to setup a few items to ensure that you can run the scenes as intended and build to multiple platforms without hassle! This applies to version v1.2.0-alpha or above as these packages no longer included project settings or package dependencies.

Input Handling

With recent versions of Unity, the default input handling is set to use Input System Package (the new version). However, elements of our system use the old input system. Once you have opened your default project to import our tool into, it is suggested that you update the input handling to use 'both' input systems. This can be found in Player Settings (within the project settings 'Edit>Project Settings> Player' labeled as 'Active Input Handling').

Required AR Packages

As our system uses augmented reality it is imperative that the correct packages are installed.

  1. Navigate to Window/Package Manager.
  2. Head to the 'Unity Registery' tab.
  3. Install the packages that are included within the screenshot below.

image

Alternatively, you can replace the manifest.json file found within your packages folder with the one that is included with the .unitypackage release. Simply:

  1. Close your project.
  2. Copy the manifest.json file from the release, replace the same file found within 'Your Project/Packages'.
  3. Re-open your project and allow the required packages to install.
  4. You can use the helper window under 'LUTE/Utilities/Dependency Helper' to ensure all required packages and samples are installed correctly.

Map Layer

For the map features to work and render correctly, we use a specific layer called 'Map' to allow our objects and cameras to know what to render and how to handle specific objects using this layer. To set this up, simply:

  1. Click on any object a scene (the default scene that is loaded works fine).
  2. Move over to the inspector and press the 'Layer' dropdown.
  3. Press 'Add Layer...'.
  4. In any empty slot, add a layer called 'Map'.

image

  1. All objects that use this layer should update automatically but you can test it out by playing the demo scenes.

Android Build Settings

Now we have correctly set our preferences and materials, we suggest playing the demo scenes to ensure they work correctly. When ready to build to Android please note the following build settings should be set to ensure the game works as intended. Please note this is just for Android.

  1. Auto Graphics API is off and the render list looks like the screenshot below (this is for AR rendering aspects). image
  2. Minimum API Level is set to 24 or higher. image
  3. Application Entry Point is set to 'Activity' (for older java based plugins such as Mapbox). image

Adding the Demo Scenes

Now everything is ready to be built, you can add the demo scenes to the scene list if you want to try out LUTE in full. Please see the following screenshot for what scenes are included and what order they are built. Once this has been set, go ahead and build it! This should work for all mobile platforms and you should be able to use the 'Level Select' scene to navigate all the demo scenes.

image

Good luck and have fun!

Clone this wiki locally