> For the complete documentation index, see [llms.txt](https://gley.gitbook.io/mobile-pedestrian-system/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gley.gitbook.io/mobile-pedestrian-system/quick-start.md).

# Quick Start

Some prerequisites must be met before running the test scene.

## Open Settings Window

The entire package configuration is managed through the Settings Window.

To open the Settings Window go to **Tools->Gley->Pedestrian System**

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2F6PyYkOoW1ZNsr13TIzlz%2FOpenSettingsWindow.jpg?alt=media&amp;token=dd64c6d4-b109-47ba-9192-e2817daa9209" alt=""><figcaption><p>Open Settings Window</p></figcaption></figure>

The following window will open:

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FnltEfpE23zdJTyVO7u78%2Fimage_2024-07-15_152045029.png?alt=media&amp;token=ce50ab4b-4731-46dd-b3b7-ea9618cbeb5b" alt=""><figcaption><p>Settings window</p></figcaption></figure>

## Import Required Packages

The system relies on the **Burst Compiler** for enhanced performance.

Click **Import Required Packages** and **Install All**

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2Fx315y81RZujms9ZbwHtA%2FImportRequiredPackage.JPG?alt=media&amp;token=8342db33-b364-422d-b665-20dc5d9f325a" alt=""><figcaption><p>Import packaged</p></figcaption></figure>

In the console, an Installation Started message will appear. Please wait until the package is imported.

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FwvRD8uTp22MP2jVNpk0i%2Fv2-InstalationMessage.PNG?alt=media&amp;token=48b7c575-6188-4595-81d4-a3ec072d70bf" alt=""><figcaption></figcaption></figure>

This will install the latest version of Burst available within the Package Manager.

If you are not using an LTS (Long Term Support) version of Unity, the latest version of Burst may cause compatibility issues. In such cases, it is recommended to open the Package Manager and install the version of Burst that is compatible with your Unity version.

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FbOuRH8dkoZr6tfDg0Rd3%2Fimage_2024-07-15_153513823.png?alt=media&amp;token=6403997e-2119-4f6d-bdc2-fb923211f048" alt=""><figcaption></figcaption></figure>

## Layer setup

The system does not include a layer preset because we do not want to override the existing layer configuration. The layers used in the demo scene are as follows:

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FfjsJ1zDsahAByYjVoPbd%2Fimage_2024-07-15_155636673.png?alt=media&amp;token=ddbbce59-05e1-421b-a75a-4e5a6614e31e" alt=""><figcaption><p>Layer setup</p></figcaption></figure>

The layer names do not need to match those in the image, but names must assigned to layers 8, 9, 10, 11, 12, 13, and 14. Empty layer names will not work. Demo scene objects are already assigned to these layers.

To verify the layer setup, navigate to:

&#x20;**Settings Window -> Scene Setup -> Layer Setup**

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2Fk0yCnH4IqRUU365PLi4D%2FLayerSetup.JPG?alt=media&amp;token=0610b8ff-86dc-4c55-bcd8-a77154b76d55" alt=""><figcaption></figcaption></figure>

For an in-depth understanding of the layer setup, read [Prepare Scene](/mobile-pedestrian-system/setup-guide/prepare-scene.md).

## Physics Setup

{% hint style="info" %}
This is not mandatory, but it is recommended.
{% endhint %}

To enable pedestrians to climb the sidewalk border, a box collider is used as a workaround.

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2F9WzLMw0IQYtGf9Kg08F9%2Fimage_2024-07-15_163616918.png?alt=media&amp;token=34af5e7e-f2b2-4e44-bb82-d61f2df5e275" alt=""><figcaption></figcaption></figure>

This collider should not interact with any other objects.&#x20;

To ensure this, open the **Project Settings** -> **Physics**.

Make sure the collider is configured to collide only with the road layers.

Important: The collider must not collide with itself to prevent any unintended interactions.

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FAF0XdT3I3cZRqNlviqvC%2Fimage_2024-07-15_164115994.png?alt=media&amp;token=603a2105-0b48-4569-861a-00eb9cc05ff6" alt=""><figcaption></figcaption></figure>

## Test the **Pedestrian Example** scene

Open the **PedestrianExample** scene located at **Assets/Gley/PedestrianSystem/Example/PedestrianExample.unity**

To activate the pedestrians within the scene, open the **Settings Window** as previously explained and press the **Apply Settings** button.

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2FRZE2GoVCOOAVt2T0NT88%2Fimage_2024-07-15_162859608.png?alt=media&amp;token=243727c7-b557-4c35-ab19-d798453849f4" alt=""><figcaption></figcaption></figure>

Once the scripts have been compiled, you can test the movement of the pedestrians in the scene.

Additionally, the scene features a user-controlled car, allowing you to navigate around the environment

{% hint style="info" %}
For **URP** navigate to **Scene Setup -> Convert Materials** to URP and all material shaders will be converted to URP.
{% endhint %}

<figure><img src="https://449878595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCzYS154gIDHX1Uf5YcUv%2Fuploads%2Fhay1hD5afaIHazyURiNN%2FURPPedestrians.JPG?alt=media&amp;token=b54d2802-8281-410e-a647-5e9978f21ee6" alt=""><figcaption></figcaption></figure>
