Terrain Access Key

Overview

How to input a key for access to cloud-streamed terrain maps.

Page Contents

Terrain Access Key

Important

If you intend on using terrain datasets, you must have a terrain key, which will allow you to stream the datasets from the cloud. Please contact us directly in order to acquire a key.

If you have been given a terrain access key, you can enter it into the RIDE config file which stores other configuration information needed to run certain RIDE systems and services. 

Enter Key via RIDE repository

If you are working out of the RIDE repository, you can enter the Terrain Key via the Level Select Options menu.  The Options menu shows the current Terrain Key being used, and gives the user/developer the ability to change it and then verify with the cloud server the key is valid. Additionally, users may change their key via the Config tab in the debug menu.

Enter Key via Project Specific repository

If you are working out of a project specific repository, you can provide the same functionality as the Level Select Menu (show the key and give the ability to change it).

However, if you have a single key that all users/developers will use on this project, you can hard-code the Terrain Key in your application.  RIDE itself is unable to provide keys in source code because of the wide range of users/developers that use RIDE, but you are free to do so in your own project.

If you would like to do this, add the following code to your initialization code:

string key = "<enter Terrain Key here>";
RideConfigSystem configSystem = Globals.api.systemAccessSystem.GetSystem<RideConfigSystem>();
configSystem.SetTerrainKey(key);
configSystem.Save(); 

Enter Key by hand editing config file

Not recommended, but you can simply enter the terrain key into your config file by hand.  Navigate to the config file in the folder mentioned below in the Config File Location section, edit the file, and enter your key into the appropriate config entry.

Config File Location

The config file information is stored as user-specific information so that it can be changed if desired.

ref: https://docs.unity3d.com/ScriptReference/Application-persistentDataPath.html

User Name is the user that is logged in.

Company Name and Product Name is found in Unity Editor, inside Player Settings.

The config file can be located at the following paths, depending on the platform being used:

Windows

c:\Users\AppData\LocalLow\config\ride.json

MacOS

~/Library/Application Support/Company Name/Product Name/config/ride.json

iOS

/var/mobile/Containers/Data/Application/Documents/config/ride.json

Android

/storage/emulated/0/Android/data/files/config/ride.json