Build parkour courses players keep coming back to.

01Pro vs Lite

Lite is free and covers everything a single server needs to run great parkour courses. Pro adds the tools larger servers and networks ask for. Use the switch in the top bar to filter this whole wiki to one edition.

02Installation

One jar, no hard dependencies. Everything else is optional and detected automatically.

1. Drop the jar in plugins/

   Use ParkourPro-1.1.0.jar or ParkourProLite-1.1.0.jar. Never run both editions at the same time.

2. Restart the server

   The plugin writes config.yml, parkours.yml, records.yml and a languages/ folder with all 23 translations.

3. Pick a language and storage

   Set language in config.yml (for example nl_NL). Enable mysql if you run a network, otherwise records stay in records.yml.

4. Optional add-ons

   LuckPerms (rank prefixes on holograms), PlaceholderAPI (placeholders), WorldGuard (region restriction), ItemsAdder (custom icons in the timer), and for Pro a Discord bot token.

5. Apply changes with /parkour reload

   Reloads config, parkours, holograms and languages without a restart. New message keys are added to existing language files automatically.

Requirements

03Your first parkour

A course is three kinds of pressure plates. Look at a plate while running each command.

1. Set the start

   Look at a gold plate and run:

   /parkour setstart sky

2. Set the end

   Look at the finish gold plate:

   /parkour setend sky

3. Add checkpoints

   Look at each iron plate in course order. Repeat for every checkpoint. Checkpoints are optional.

   /parkour addcheckpoint sky

4. Set the reset location

   Stand where players should land after /parkour reset or a fall without checkpoints:

   /parkour setreset sky

5. Add a leaderboard

   Look at a block where the top list should float:

   /parkour addleaderboard sky
   /parkour setleaderboardsize sky 10

6. Protect the course from falls

   Teleport players back when they drop below Y 60:

   /parkour setfallback y sky 60
   /parkour togglefallback sky

04Creation wizard

The wizard validates every step, prevents duplicate checkpoints and creates the holograms for you.

/parkour wizard <name> start     # begin
/parkour wizard <name> cancel    # discard and exit

Your inventory is stored and restored when the wizard finishes or is cancelled. Afterwards you can still run /parkour setreset, add holograms or change any option.

05Commands

Root command /parkour with aliases /pk and /par. Admin commands need parkour.admin. Angle brackets are required, square brackets are optional.

06Records & leaderboards

A record is one best time per player per parkour. Only faster runs replace it, unless an admin overrides it with settime.

Where records are stored

• Local: plugins/ParkourPro/records.yml (or the Lite folder). Always written, even with MySQL on, so you keep a local copy.
• MySQL: table <prefix>records with one row per player and parkour. Shared across a network, all queries run off the main thread.
• Leaderboards read from MySQL first and fall back to the local file.

Managing records

/parkour deletetime sky Notch           # wipe Notch's time on "sky"
/parkour settime sky Notch 01:23.456  # set Notch's time to 1 min 23.456 s

Player lookup works for offline players: the plugin checks online players, then stored records on that parkour, then records on any parkour, then the server's player data. After both commands the leaderboard hologram is redrawn immediately and PlaceholderAPI values refresh within five seconds.

Time format for settime

07Holograms

Every parkour can show a start, end, per-checkpoint and leaderboard hologram. Default text comes from config.yml; per-parkour text from sethologram.

Renderers

• Legacy (1.8 – 1.19): invisible armor stands, one per line. Rock solid on every server.
• Modern (1.19.4+ Paper): text displays with background, opacity, scale and billboard settings via sethologramdisplay.
• HologramLib renderer (Pro, 1.20+): enable holograms.modern-renderer.enabled for packet-based holograms and player heads on leaderboard rows (heads render on 1.21.10+).

Leaderboard text

holograms:
  text:
    leaderboard:
      header:
        - "&e&lLeaderboard"
        - "&7Update every &e%update-interval%&7 %update-unit%"
      entry-format: "%pos% &8» %prefix%%player% &8- &e%time%"
      position-colors: { 1: "&6&l", 2: "&7&l", 3: "&c&l", default: "&e&l" }
      no-record-player: "Unknown"
      no-record-time: "--:--"

Offsets and visibility

start-offset, end-offset, checkpoint-offset and leaderboard-offset raise the hologram above its plate. line-spacing sets the gap between lines. visibility-range hides holograms beyond that many blocks (0 = always visible). The leaderboard refreshes every update-interval seconds and immediately after a record change.

08Configuration

Everything lives in config.yml. Change it, then run /parkour reload.

Per-parkour data

Everything set with commands is stored in parkours.yml: locations, checkpoints, hologram text, toggles such as finish-redirect, fallback-y, time-limit, proximity-finish and proximity-finish-radius. You can edit it by hand and reload, but commands are safer.

09Placeholders

With PlaceholderAPI installed, the parkour expansion registers automatically. Use auto as the parkour name when you only have one parkour.

# Example scoreboard lines
- "&6#1 &f%parkour_top_sky_1_player% &7- &e%parkour_top_sky_1_time%"
- "&bYou: &f%parkour_personal_sky_time% &7(#%parkour_personal_sky_rank%)"

Message placeholders

Inside language files and hologram text: %player%, %parkour%, %time%, %checkpoint%, %completed%/%total%, %record%, %status%, %radius%. Colour codes use &, hex colours use #RRGGBB, an empty string disables a message.

10Permissions

11Gameplay & anti-cheat

14MySQL & languages

MySQL

mysql:
  enabled: true
  host: localhost
  port: 3306
  database: parkourpro
  username: root
  password: secret
  table-prefix: parkour_

The table is created on first connect. The prefix may only contain letters, digits and underscores. When the database is unreachable the plugin logs the error and keeps working from records.yml.

Languages

Bundled: en_US, nl_NL, de_DE, fr_FR, es_ES, it_IT, pt_BR, ru_RU, pl_PL, tr_TR, zh_CN, zh_TW, ja_JP, ko_KR, sv_SE, cs_CZ, fi_FI, da_DK, no_NO, ro_RO, uk_UA, el_GR, hu_HU. Edit any file in languages/ and reload. Missing keys are filled in from the English defaults so an update never breaks a translation.

15FAQ & troubleshooting

Not answered here? Ask on the Discord server.

16Changelog

1.1.0

• Pro: item frame map boards, a leaderboard poster on maps with header, podium heads, rows and footer (/parkour mapboard).
• Both: update checker with admin notification on join and /parkour version.

1.0.9

• Both: checkpoint splits, statistics, top and pb, new placeholders, leave radius, cooldown and daily limit, per-parkour sounds and titles, export / import, wizard steps for reset, leave and leaderboard, Discord webhook.
• Pro: ghost replay, race mode, daily / weekly / monthly leaderboards, seasons, parkour menu, speed check, rewards by time and rank, network sync, checkpoint effects, web API.

1.0.8

• Both: /parkour deletetime <parkour> <player> wipes a player's record; works for offline players and MySQL; leaderboard refreshes instantly.
• Both: /parkour settime <parkour> <player> <mm:ss.ms> sets or overwrites a record; leaderboard refreshes instantly.
• Both: tab completion for both commands; new messages in the English defaults and the en_US / nl_NL files.
• Pro: /parkour togglefinishproximity <parkour> [radius], finish without triggering the end pressure plate.
• Both: checkpoints must now be activated in order. Skipping a checkpoint no longer counts the ones in between (checkpoints.sequential, default true).

1.0.7-1

• Both editions run on Minecraft 26.2.
• Fixed the TPS and lag issue caused by the leaderboard hologram.
• Fixed the reset look position.
• Pro: a parkour now only needs a start and an end; checkpoints are optional.

17Downloads

18Pumpkin edition

ParkourPro Lite is also available for Pumpkin, the Minecraft server written in Rust. It is a separate, native build: the Spigot/Paper jar does not run on Pumpkin.

Installation

1. Download the .wasm file

   Get ParkourPro Lite from the Pumpkin Market. Pick the file that matches your Pumpkin version.

2. Put it in plugins/

   Place the file in the plugins/ folder of your Pumpkin server and start the server.

3. Allow file access

   On first start Pumpkin asks to allow fs.write.data. The plugin needs it to save parkours, records and settings in its own data folder. Answer y.

4. Pick a language

   Set language in config.yml (for example nl_NL) and run /parkour reload.

Your first parkour

1. Start

   Place a gold pressure plate (light weighted), look at it or stand on it and run /parkour setstart <name>.

2. Finish

   Place a second gold pressure plate and run /parkour setend <name>.

3. Checkpoints

   Place iron pressure plates (heavy weighted) and run /parkour addcheckpoint <name> for each one, in course order.

4. Leaderboard

   Stand where you want the leaderboard and run /parkour addleaderboard <name>.

Step on the start plate to begin. Your inventory is emptied during the run and given back when you finish, cancel or leave.

Commands

Root command /parkour, aliases /pk and /par.

Permissions

Pumpkin requires permission nodes to start with the plugin name, so they differ from the Spigot/Paper editions.

Configuration and languages

config.yml uses the same layout and names as the Spigot/Paper edition, so the Configuration page applies to the sections below. All 23 languages are included in the languages/ folder.

Files

Not available on Pumpkin yet!

• All Pro features: there is no Pro edition for Pumpkin yet.
• End and reward commands, MySQL, the Discord webhook, PlaceholderAPI placeholders and the update checker.
• Anti-cheat checks, parkour locks, death handling, custom sounds and titles per parkour, import and export, the creation wizard.
• Title and boss bar timers, and rank prefixes on the leaderboard.

Known issues

19Support & Discord

Need a language that is not bundled, found a bug, or want help setting something up? Join the Discord server.

• New language: ask in the server, or translate languages/en_US.yml yourself and send it in. It will be bundled in the next release for everyone.
• Bugs: post your server version, plugin edition and version, and the console log around the error.
• Feature requests and setup help: welcome as well. Pro buyers get priority support.
• Happy with the plugin? Leave a review on the platform you downloaded it from. It is the best way to support the project.