# 🖌️ Edit Parkour

## Change Identifier

With this option, you can rename the identifier of the parkour. The identifier is used internally by the plugin and has to be unique, and it is also the name players use with **/parkour \<identifier>**.

<figure><img src="../../.gitbook/assets/parkour/change-identifier.png" alt="" width="563"><figcaption><p>Edit Parkour (Change Identifier)</p></figcaption></figure>

## Display

With this option, you can change the item and the name used for the parkour inside the editor.

The item is only how the parkour is listed in that menu and is never seen in the world. The name is not — it is what `%phoenixlobby_parkour_name%` prints and what players read on the [leaderboard](settings.md#leaderboard), so give it something presentable.

<figure><img src="../../.gitbook/assets/parkour/display.png" alt="" width="563"><figcaption><p>Edit Parkour (Display)</p></figcaption></figure>

## Parkour Region

With this option, you define the area the generated jumps are allowed to spawn inside of. The run stays within this box, so it decides how much room the parkour has to build itself.

> **Warning:**
A parkour cannot be played until both the **Parkour Region** and the **Start Location** are set.

<figure><img src="../../.gitbook/assets/parkour/parkour-region.png" alt="" width="563"><figcaption><p>Edit Parkour (Parkour Region)</p></figcaption></figure>

## Start Location

With this option, you move the starting point of the parkour to the position you are standing at. It has to be inside the region.

<figure><img src="../../.gitbook/assets/parkour/start-location.png" alt="" width="563"><figcaption><p>Edit Parkour (Start Location)</p></figcaption></figure>

## Return Location

With this option, you define where players are sent once a run ends. If you leave it empty, they are returned to the place they started from.

<figure><img src="../../.gitbook/assets/parkour/return-location.png" alt="" width="563"><figcaption><p>Edit Parkour (Return Location)</p></figcaption></figure>

## Difficulty

With this option, you can change how far apart the jumps are. Five options are available:

| Difficulty | Jump gap |
| ---------- | -------- |
| Easy | 2 blocks |
| Medium | 2 to 3 blocks |
| Hard | 3 to 4 blocks |
| Hardcore | 4 to 5 blocks |
| Progressive | Starts at 2 blocks and steps up as the score rises |

**Progressive** uses the scores from **modules/parkour.yml** to decide when it steps up, so you can tune it with the medium-score, hard-score and hardcore-score values.

<figure><img src="../../.gitbook/assets/parkour/difficulty.png" alt="" width="563"><figcaption><p>Edit Parkour (Difficulty)</p></figcaption></figure>

## Height Variation

With this option, you can change how many blocks up or down a jump is allowed to move. A value of 0 keeps the run flat, while a higher value lets it climb and drop more.

<figure><img src="../../.gitbook/assets/parkour/height-variation.png" alt="" width="563"><figcaption><p>Edit Parkour (Height Variation)</p></figcaption></figure>

## Permission Required

With this option, you define whether a permission is needed to play the parkour. While it is disabled, the permission below is ignored and everyone can play.

<figure><img src="../../.gitbook/assets/parkour/permission-required.png" alt="" width="563"><figcaption><p>Edit Parkour (Permission Required)</p></figcaption></figure>

## Permission

With this option, you can change the permission that is checked when **Permission Required** is enabled.

<figure><img src="../../.gitbook/assets/parkour/permission.png" alt="" width="563"><figcaption><p>Edit Parkour (Permission)</p></figcaption></figure>

## Parkour State

With this option, you can disable a parkour without removing it. A disabled parkour keeps all of its settings but cannot be played.

<figure><img src="../../.gitbook/assets/parkour/parkour-state.png" alt="" width="563"><figcaption><p>Edit Parkour (Parkour State)</p></figcaption></figure>

## Clone Parkour

With this option, you can duplicate the parkour under a new identifier, which is useful when you want a second parkour sharing the same palette and difficulty.

<figure><img src="../../.gitbook/assets/parkour/clone-parkour.png" alt="" width="563"><figcaption><p>Edit Parkour (Clone Parkour)</p></figcaption></figure>

## Delete Parkour

With this option, you can remove the parkour from the server.

> **Danger:**
Deleting a parkour cannot be undone. Use **Parkour State** instead if you only want to take it out of rotation for a while.

<figure><img src="../../.gitbook/assets/parkour/delete-parkour.png" alt="" width="563"><figcaption><p>Edit Parkour (Delete Parkour)</p></figcaption></figure>

Source: https://www.phoenixplugins.com/docs/phoenix-lobby/modules/parkour/edit-parkour