🏃♂️Parkour
Let players show their jumping skills.
New documentation for this resource under construction.
Description
An extensive arcade game, where the player has to pass the map in the shortest time. During the journey, various obstacles are waiting for adventurers.
Prerequisites
Before you run Parkour plugin on your server, there are a few requirements that you should check.
Ensure you are using Minecraft version 1.8.8 or later. (Versions below 1.8.8 are not supported!)
Your server has installed Java8 or later.
Make sure that you have already installed plugin TheCore
Installation
Unzip downloaded file.
Put
Parkour.jar
into plugins folder at your server.
Downloaded .zip file contains more .jar file depending on the server version. Choose the one that fits your server.
Restart your server.
Done
Commands & Permissions
Additional Permissions
Localized commands
This plugin brings ability to fully manage commands. As a main command, /Parkour
should not be used. You can use any alternative.
Each command has own aliases to make the usage faster.
Copy
Configuration
Detailed explanation of variables at configuration files.
Config
Automatic Updates
Resource supports automatic (startup) updates. You can enable or disable them. If disabled, you will only receive message about new version.
Localization
Fully customizable localized messages. Just make duplicate of EN.yml file(In the same folder!). Rename it and write the name of the file into config.yml.
Example of the Locale file:
Copy
Copy
Multi Localization
Plugin is able to hold different localisations at the same time. It’s up to player, which localisation wants to display.
Secondary localizations do not have to contain all translations. In case of secondary translation does not contain requested path, the primary file is used to fetch data.
Copy
Storage
Space where to save required data. Supported storages: MySQL
and SQLite
If you prefer MySQL Storage before SQLite, you need to fill variables at config.yml.
There is required that ProfileStorage and this plugin is using the same source of storage!
Analytics
Plugin sends anonymous data such as version of this resource, your server version and addition data of configuration. These data will help me in future development. All requests are asynchronous, so it has no impact on server's performance.
If you don't want to share these data, you can easily disable it.
Copy
Data collected from your server about Parkour
Copy
Options
Options file is divided to sections.
Everyting is configurable in-game via command /Parkour Settings
Addons
By enabling or modifying add-ons, Parkour becomes more attractive to players.
CompassFinishNavigation
- Compass at player's inventory shows direction to the finish of the map.TimerVisibility
- At enabling, current time is shown at action bar.JoinByStep
- Player can join the map by stepping on the start point of the map.FakeContactDamage
- Player can receive fake damage, while he step on cactus or similar block.InteractiveItem
- Collection of items(Door, Lever, Button), which player can interact while playing the map.
BungeeCord
This mode is primary determined for bigger server network, while Parkour is a separated server.
At this section, you can specify channel
how to communicate with BungeeCord. Also name
of lobbies, where player is moved at leaving the server, are listed here.
By enabling this mode, player receives special items into hotbar at joining the server.
These items are able to obtain at common server by disabling bungee mode and enabling
ExploringHotBar
flag!
Command
Commands while player is in the map are restricted. You need to specify commands, which can be invoked.
DefaultMapData
At map creation, these values are copied into map file. Set once, use more time.
Only one value is not copied. Author
section. Here you can set limit, how much maps can player create.
Visual
Section represents components displayed at chats and boss bars.
Map
Here you can define TimeFormat
used at parsing time to action bar or leaderboards.
HINT: If you want display hours use format: HH:mm:ss.SSS
BroadCast
Each significant action is broadcasted to all players. You can disable it, or you can restrict worlds, where messages won't be displayed.
ScoreBoard
These boards shows current stats in order to player's state. You can disabled them, or you can restrict worlds, where Exploring scoreboard
won't be displayed.
Board
Boards or LeaderBoards are used to display personal or summary stats. Nicely fit the server lobby scene.
There are three types of boards:
BANNER
- One leader-one line.PODIUM_ARMOR_STAND
- Each leader(place) has own location. Colored ArmorStand with player's head.PODIUM_PLAYER
- Each leader(place) has own location. NPC with leader's skin.SIGN
- Each leader(place) has own location. Skull placed above the sign.
How to create board is explained below.
Event
Event system is prepared as a competition between players at the same time. They have X seconds to join the map. When all participated players finish the map, system will find the best ones and will give them rewards.
Seting up the first Map
HINT Use
Tab
at completing commands.
Prerequisites
Create lobby point. Find suitable place, fix your position and type
/Parkour GlobalLocation SetSpawnPoint
.Build the whole map.
(Optional) Select board type for map leaders using
/Parkour Settings -> Global -> Board -> Summary -> Type
. Choose one and click on wooden door.
Reload the plugin using
/Parkour Reload [All]
(Optional) Create podiums or style place for boards.
Map
Creating new map. Choose suitable name and type
/Parkour Map Create <Name>
.Start point. Scroll you hotbar to Start item. Find suitable place, your position and right click with item(into the air).
The same for finish and checkpoints and action points.
Reload the map using
/Parkour Reload Map <MapName>
Enabling the map. Each map's modification requires Maintenance mode, so we need to quit it using
/Parkour Maintenance Disable <MapName>
.Done, you can join your first map.
Personal Board
Select board type using
/Parkour Settings -> Global -> Board -> Personal -> Type
.
Reload the plugin using
/Parkour Reload [All]
Find suitable place, fix your position and type
/Parkour Board Personal Place
Done, you should see Personal Board
Map Leader Board
As default top 3 players of each map can be displayed at LeaderBoards.
Prerequisites
Select board type using /Parkour Settings -> Global -> Board -> Leader -> Type
.
Banner
Find suitable place, fix your position and type
/Parkour Board Map <MapName> Place Banner
Done, to see the Banner, reload map using
/Parkour Reload Map <MapName>
Podium
Find suitable place for the best(1st) player, fix your position and type
/Parkour Board Map <MapName> Place Podium 1
Repeat for the next two podiums, just find new place and change the last argumennt from
1
to2
and3
.
Done. To see podiums, reload map using
/Parkour Reload Map <MapName>
Sign
Find suitable place for the best(1st) player, place sign and type
**Parkour**
MapName
Position
Repeat for the next two podiums, just find new place and change the position from
1
to2
and3
.
(Optional) Place head(skull item) above the sign to see textures of the player.
Done. To see podiums, reload map using
/Parkour Reload Map <MapName>
Summary Leader Board
There is collected more types of stats. To display them at podiums/banner can take too much place at the server. Instead of that, you can create just one place and let system to change boards with stats in definded intervals.
Board Sections
At first we need to create section, which ensures changing stat components in defined intervals.
Create section using
/Parkour Section Create <Name>
Add stat component to section using
/Parkour Section Component Add <Name> <Type>
(Optional) Change default interval duration using
/Parkour Section UpdateSwitchTime <Name> <Time>
Available component types:
TheHighestRank
Board
Banner
Find suitable place, fix your position and type
/Parkour Board Summary Place Banner <ComponentType>
Done, to see the Banner, reload map using
/Parkour Reload [All]
Podium
Find suitable place for the best(1st) player, fix your position and type
/Parkour Board Summary Place Podium <ComponentType> 1
Repeat for the next two podiums, just find new place and change the last argumennt from
1
to2
and3
.
Done. To see podiums, reload map using
/Parkour Reload [All]
Sign
Find suitable place for the best(1st) player, place sign and type
**Parkour**
TheHighestRank
Position
Repeat for the next two podiums, just find new place and change the position from
1
to2
and3
.
(Optional) Place head(skull item) above the sign to see textures of the player.
Done. To see podiums, reload map using
/Parkour Reload [All]
Reward
The main point of Reward Repository is that one reward can be used at different maps at the same time. One change of reward affects all maps, no need to manage each map's rewards separately.
Using simple in-game GUI, rewards are created in a few minutes!
For more details please, check reward setup from AdventSeason.
PlaceholderAPI
Plugin offers ability to obtain data via placeholderAPI.
Personal stats
%parkour_personal_stats_map_<MapName>_time% - Parsed time. (00:04.243)
%parkour_personal_stats_map_<MapName>_time_raw% - Raw time in milliseconds (4243)
%parkour_personal_stats_map_<MapName>_position% - Position at map
%parkour_personal_stats_map_<MapName>_position_raw% - Position at map. (If does not exists, max int value)
Map stats
%parkour_stats_map_<MapName>_time_<Order>% - Parsed time of player at requested position
%parkour_stats_map_<MapName>_name_<Order>% - Name(Nick) of player at requested position
Counts
%parkour_map_count_all% - Count of all maps
%parkour_map_count_open% - Count of opened maps
%parkour_map_count_maintenance% - Count of maps under maintenance
%parkour_map_count_c_<Category>% - Count of maps with requested category
%parkour_map_count_d_<Diffculty>% - Count of maps with requested difficulty
Player (Deprecated, may be removed at following updates)
%parkour_rank%- Current rank of the player%parkour_rank_point_amount%- Current amount of rank points at player's account%parkour_next_rank%- Next rank for the player%parkour_next_rank_point_amount%- Amount of rank points required to reach new rank%parkour_map_completed%- Count of completed maps%parkour_map_uncompleted%- Count of uncompleted maps
Player NEW!
%parkour_profile_rank% - Current rank of the player
%parkour_profile_rank_point_amount% - Current amount of rank points at player's account
%parkour_profile_next_rank% - Next rank for the player
%parkour_profile_next_rank_point_amount% - Amount of rank points required to reach new rank
%parkour_profile_map_completed_count% - Count of completed maps
%parkour_profile_map_completed_count_c_<Category>% - Count of completed maps at requested category
%parkour_profile_map_completed_count_c_<Diffculty>% - Count of completed maps at requested difficulty
%parkour_profile_map_uncompleted_count% - Count of uncompleted maps
%parkour_profile_map_uncompleted_count_c_<Category>% - Count of uncompleted maps at requested category
%parkour_profile_map_uncompleted_count_c_<Diffculty>% - Count of uncompleted maps at requested difficulty
%parkour_profile_map_daily_challenge_count% - Count of completed maps in a day
%parkour_profile_map_favourite_name% - Name of favourite map
%parkour_profile_map_favourite_time% - Reached time at favourite map
%parkour_profile_map_favourite_count% - Count of completions at favourite map
%parkour_profile_map_best_name% - Name of your personal best map
%parkour_profile_map_best_time% - Time at your personal best map
Miscellaneous
%parkour_version% - Version of the plugin
FAQ
Cannot interact with Lobby/Map/SetUp items in HotBar.
This situation occurs when the player has not got active Adventure Mode. (Some plugins that managing worlds, can switch player's gamemode e.g. Multiverse-Core, MultiWorld...)
One of the solution is to set Adventure Mode for the whole world where Parkour(Lobby/Map) is used
Last updated