Parkour

Parkour

Set up and play the parkour, with its block palette, rewards and placeholders.

View as Markdown ·

On this page

circle-info

This module is configured in modules/parkour.yml inside the PhoenixLobby folder.

#Parkour

The parkour builds itself while the player runs, so there is nothing to build by hand. A player starts a run with /parkour, jumps as far as they can, and the run ends when they fall or when they use /parkour stop. The score is the amount of jumps they made.

Parkours are created from Editor > Parkour. Stand where you want the parkour to be and click Add Parkour.

Parkour (Add Parkour)

A parkour needs two things before anyone can play it, the Parkour Region and the Start Location. Everything else is optional. Left-click the parkour in the list to open its editor: Edit Parkour, Block Palette and Rewards. Settings shared by every parkour on the server are on Parkour Settings.

#Commands

Command Description
/parkour Starts a random parkour the player has access to
/parkour <identifier> Starts a specific parkour
/parkour stop Leaves the run
/parkour top [identifier] Shows the leaderboard

circle-info

The parkours themselves live under the parkours section at the end of the file.

#Block Palette

With this option, you can configure which blocks the generated jumps use. Left-click it to open the palette, where every block currently in use is listed.

Edit Parkour (Block Palette)

#Add Block

Inside the palette, Add Block puts another block into the list. Add as many as you like to give the run some variety.

Block Palette (Add Block)

#Random Block Per Jump

With this option, you decide how the palette is used. When it is enabled, every jump picks a new block from the palette, which gives a colourful run. When it is disabled, one block is chosen for the whole run instead, so each attempt keeps a single look.

Edit Parkour (Random Block Per Jump)

circle-info

A palette with only one block makes this option have no visible effect.

#Rewards

With this option, you can configure the rewards given for reaching a certain score. Left-click it to open the reward list of the parkour.

Edit Parkour (Rewards)

#Add Reward

Inside the list, Add Reward creates a new score reward. Each reward is its own entry with its own score and actions, so a parkour can hand out several of them during a single run.

Rewards (Add Reward)

#Required Score

With this option, you can change the score a player has to reach before the reward is earned.

Reward (Required Score)

#Repeating

With this option, you define whether the reward is given every time the score is a multiple of the required score. With a required score of 10 and repeating enabled, the player is rewarded at 10, 20, 30 and so on. With it disabled, the reward is given once at 10 only.

Reward (Repeating)

#Actions

With this option, you can edit the actions executed when the reward is earned. The same action types used by npcs and hotbar items are available here, so a reward can give money, run a command, send a message or play a sound.

Reward (Actions)

circle-info

A reward with no actions is still tracked, it simply does nothing when the score is reached.

#Placeholders

#Parkour Placeholders

Placeholders Description
%phoenixlobby_parkour_count% Returns the amount of playable parkours
%phoenixlobby_parkour_playing% Returns the amount of users playing
%phoenixlobby_parkour_playing_<parkour>% Returns the amount of users playing a parkour

The parkour is always the identifier you gave it in the editor, for example %phoenixlobby_parkour_playing_lobbyjump%.

#Run Placeholders

Placeholders Description
%phoenixlobby_parkour_score% Returns the score of the current run
%phoenixlobby_parkour_time% Returns the time of the current run
%phoenixlobby_parkour_name% Returns the parkour of the current run
%phoenixlobby_parkour_difficulty% Returns the difficulty of the current run

circle-info

These are empty while the user is not on a parkour.

#Statistic Placeholders

Placeholders Description
%phoenixlobby_parkour_gamesplayed% Returns the amount of runs the user finished
%phoenixlobby_parkour_gamesplayed_<parkour>% Returns the amount of runs the user finished on a parkour
%phoenixlobby_parkour_highscore% Returns the best score of the user on all parkours
%phoenixlobby_parkour_highscore_<parkour>% Returns the best score of the user on a parkour
%phoenixlobby_parkour_besttime% Returns the best time of the user on all parkours
%phoenixlobby_parkour_besttime_<parkour>% Returns the best time of the user on a parkour
%phoenixlobby_parkour_position% Returns the leaderboard position of the user
%phoenixlobby_parkour_position_<parkour>% Returns the leaderboard position of the user on a parkour

#Leaderboard Placeholders

Placeholders Description
%phoenixlobby_parkour_top_<parkour>_<position>_name% Returns the name on that leaderboard position
%phoenixlobby_parkour_top_<parkour>_<position>_score% Returns the score on that leaderboard position
%phoenixlobby_parkour_top_<parkour>_<position>_time% Returns the time on that leaderboard position

For example, %phoenixlobby_parkour_top_lobbyjump_1_name% returns the best player of that parkour.

circle-info

Leave the parkour out to use the global leaderboard, for example %phoenixlobby_parkour_top_1_name%. It ranks users by their best score on any parkour.

The leaderboard holds the top 20 by default, which you can change with the leaderboard size.

My Cart
Spider

Your cart is empty

Looks like the spiders padded through here. Pick a plugin and it will show up here. Continue shopping