DUXPLIMA Documentation

parkour.conf

Parkour: courses, runs, checks, ghosts, ratings and seasons.

Parkour: an island that is a course. Its team builds the course; anybody runs it. A run starts on a plate over the start block, is saved at every checkpoint plate, and ends on a plate over the finish block. The best time of every runner on every course is kept.

The file is plugins/uxmSkyblock/modules/parkour.conf. Every default below is the shipped value.

KeyDefaultWhat it does
enabledtrueWhether islands can be made as Parkour courses.

markers

What marks a course.

KeyDefaultWhat it does
plateLIGHT_WEIGHTED_PRESSURE_PLATEThe plate a run starts and ends on.
start-underEMERALD_BLOCKThe block under a plate that makes it the start.
finish-underGOLD_BLOCKThe block under a plate that makes it the finish.
checkpointHEAVY_WEIGHTED_PRESSURE_PLATEThe plate that is a checkpoint wherever it stands. A runner who falls is put back on the last one.
runs.fall-depth8How far below the last checkpoint, or the start, a runner may fall before being put back on it.
runs.time-limit30mHow long a run may take before it is dropped.
runs.board-size10How many runners the course command shows, fastest first. From 1 to 100.
runs.splitstrueWhether each checkpoint says how long the run took to it, and how far ahead of or behind the runner's best run at the same checkpoint.

rewards

What a finish pays. Each is a list of action lines, as in effects.conf, run for the runner in the order written: [console] lines run a command, as "[console] eco give %player_name% 100". %time% is the run's time, %millis% the same in milliseconds, and %was% the time beaten, empty when there was none.

KeyDefaultWhat it does
first-finishempty listThe first time a runner finishes a course.
personal-bestempty listEach time a runner beats their own best on a course.
course-recordempty listEach time a runner finishes a course faster than anybody has, the first finish on a course included.
season-recordempty listEach time a runner finishes a course faster than anybody has in the season under way, the season's first finish there included. Seasons come from the season system; with none under way this pays nothing.
again-after24hHow long after a runner is paid a new best or a record on a course the same list pays them there again. A first finish is paid once for good. Rewards are never paid to the course's own team, who build it.
shortest-run5sA run quicker than this pays nothing, so a course of a step or two earns no reward.

tags

The tags a course's team gives it with the coursetag command: one difficulty and one category, each by a name below. The language files word each one under parkour.difficulties and parkour.categories; a name they do not word is shown as written. Add, take off or rename them freely.

KeyDefaultWhat it does
difficultieseasy, medium, hard, expertEasiest first.
categoriesclassic, speed, maze, dropper, puzzle

ratings

How runners rate a course with the courserate command: a runner who has finished a course, and is not of its team, gives it from 1 star to the most below, from 2 to 10. A second rating takes the place of the first.

KeyDefaultWhat it does
enabledtrue
stars5

ghost

The ghost a runner races. Every runner's best run on a course is recorded as it goes, and the next run is raced against it: an item only the runner sees retraces the run, from the start plate to the finish.

KeyDefaultWhat it does
enabledtrue
againstRECORDWhose ghost is raced: RECORD for the course's fastest run, whoever ran it, or OWN for the runner's own best, and the course's fastest before they have one.
sample-every100msHow often a run is sampled. The ghost moves on a straight line between two samples. At least 50ms.
itemPLAYER_HEADThe item the ghost is drawn as. A player head wears the face of whoever ran it.
height1.4How far above the ground the item floats, how large it is drawn, from above 0 up to 4, and whether it glows, so it shows through the course.
scale0.6
glowtrue

checks

What ends a run that is not run on foot. The course's own return to the last checkpoint after a fall is never counted.

KeyDefaultWhat it does
flighttrueFlying or opening wings during a run ends it.
teleporttrueAny teleport during a run ends it: a pearl, chorus fruit, a command or another plugin.
speed.enabledtrueMoving faster than this across the ground ends a run.
speed.fastest16The most blocks a second a runner covers, measured over a quarter of a second at least, so a fall does not count. Sprint jumping is about 7, and a Speed effect or ice adds to it.
bypass-permissionuxmskyblock.parkour.checks.bypassA player with this permission is not checked. Leave it empty for nobody.

modes

The game modes on a course, which is how a run is played. Whatever a player brings to a course is kept aside while they are on it and given back when they leave: their items, experience, effects and mode. Nothing the team makes in creative leaves the course, and a run starts empty handed.

KeyDefaultWhat it does
buildCREATIVEThe mode of the course's own team while they are on it and not running: how the course is built.
playSURVIVALThe mode of anybody running, and of everybody else on the course: SURVIVAL or ADVENTURE.
keep-permissionuxmskyblock.parkour.keepmodeA player with this permission keeps their own mode and items on a course. Leave it empty for nobody.