Minimum Java Version: ________Java 17





Description
ParkourTopTen will display the heads of the players with the fastest times for a particular Parkour course. The head is displayed above a sign displaying the player's name and time for the course. The number of heads displayed is determined by the number of signs created (minimum 1, maximum 10).



The display of heads for a course will be automatically updated/refreshed whenever the course is successfully completed by a player.

To create a ParkourTopTen display for a course, first create a row of signs - any number between 1 and 10. Then, standing in front of and looking at the left most sign, run the create command - see below.

By default, the heads are placed on top of the block that the sign is attached to. Heads can also be placed directly above the sign as in the image below.



Any type of sign (oak, birch, etc.) can be used for the display, but there is a config option to force the display to use the same wood type. This will allow separate displays to be created on adjacent blocks by using different wood types for the signs.

All signs are supported including hanging signs. When placing a hanging sign, the front of the sign will be the side facing the player. As hanging signs are smaller, there is less room for text, so in order to display the time of the player, the text "Time: " should be removed from line2 in the config.yml file.



To remove a ParkourTopTen display, look at the left most sign and run the remove command.

To remove ALL the ParkourTopTen displays, simply run the remove command with the "all" argument. This will remove every display that ParkourTopTen knows about from the server.

Commands
/ptt create [course] [head_position] - create a ParkourTopTen display for the specified course where head_position is a (above) or b (behind). If not specified the head is placed on the block behind the sign.
/ptt remove - remove the ParkourTopTen display
/ptt remove all - remove all the ParkourTopTen displays from the server
/ptt help - help on running ParkourTopTen commands
/ptt reload - reload the ParkourTopTen config
/ptt info - display plugin info


Dependencies and legacy support
Version 4.3 of ParkourTopTen is compatible with Parkour 7.2+ by A5H73Y and requires Minecraft v1.20.1 and later.

Version 4.1 of ParkourTopTen requires minimum Java 17, Parkour 7.0+ and Minecraft v1.17.1 - 1.20.2.




Configuration


Permissions



Installation
Download ParkourTopTen.jar
Copy to your 'plugins' folder
Restart your server - this will create the default config.yml



Notes
1. If you prefer a player's head to only appear once in the display, then you need to configure Parkour so that only one entry is saved for each player per course.
2. Care should be taken when placing hanging signs. The front of the sign will be facing the player when the sign is initially placed. If the heads are facing the wrong way, replace the hanging signs so that they face the other direction.

3. Hanging signs have less room for text so lines may become truncated.

4. Occasionally a head may have the wrong texture. In this case, run "/ptt remove" and "/ptt create (course)" again. This will usually fix it.

5. Remember to protect the heads display using Worldguard or some other tool.


Issues and Source Code
The source code is on GitHub where you can log any bugs or requests, or join our Discord server to discuss any issues.


Acknowledgements
tastybento for TopTenHeads for Askyblock on which this plugin was originally based.
A5H73Y for the excellent Parkour plugin.

Please don't use the review section to ask for help or additional features. Use one of the options listed above and provide as much information as possible. If something's not working, then you've probably configured it wrongly, and it's just not possible to diagnose and resolve a problem in the review space, and the "review" you leave helps no-one.