Advanced Parkour

Minimum Java Version: Java 21

ADVANCED PARKOUR

Advanced Parkour is a competitive arena-based Minecraft parkour plugin built around ordered checkpoints, split timing, personal best progression, and global leaderboards.

Players join a course, start from the first checkpoint, race through the route in order, recover from mistakes with built-in reset tools, and keep pushing to beat both their own times and the server record.

GAMEPLAY SHOWCASE

Watch Advanced Parkour in action, from joining and checkpoint progression to resets, personal bests, and finish announcements.

FEATURES

Competitive Timed Parkour: Build replayable parkour arenas where players race for faster completions instead of just finishing once.
Ordered Checkpoint System: Every checkpoint has a strict route order, ensuring accurate progression tracking and preventing skips.
Split Timing & Segment Tracking: Each valid checkpoint stores split times, allowing players to improve individual sections of a course instead of only chasing a final time.
Personal Bests Per Arena: Track a player's personal record for every arena.
Checkpoint Personal Bests: Store best segment times for every checkpoint, providing advanced training feedback.
Perfect Run Tracking: Flawless runs are tracked separately, giving players an additional challenge and achievement to pursue.
Live Arena Records: Every arena stores its global record holder and best time for leaderboards, holograms, menus, and placeholders.
Reset & Recovery Items: Built-in run items allow players to instantly reset or return to their last checkpoint without interrupting gameplay.
Fail Tracking: Checkpoint teleports and reset mistakes are tracked and reflected in detailed player statistics.
Arena Isolation: The plugin prevents inventory abuse, item dropping, item pickup, and unwanted interference during active runs.
Safe Inventory & State Handling: Player inventory, armor, potion effects, and run state are fully restored when leaving a run.
Arena Signs: Create clickable join signs that display arena information and allow players to join instantly.
Checkpoint Holograms: Display immersive holograms for starts, checkpoints, and finish locations.
Scoreboards & BossBars: Show live run information such as timers, checkpoints, personal bests, and arena progress.
Per-Arena Player Rules: Configure arena-specific settings including gamemode, potion effects, scoreboards, and boss bars.
Music Support via NoteBlockAPI: Assign custom .nbs songs to arenas and preview them directly inside the setup menu.
Interactive GUI Setup: Create and manage arenas through easy-to-use in-game menus instead of manually editing configuration files.
Offline & Online Stats Viewing: View statistics for both online and offline players, including cached player data.
Advanced PlaceholderAPI Support: Includes extensive placeholders for player stats, arena data, active runs, personal bests, and leaderboards.
Built-In Leaderboards: Display top players, fastest completions, flawless runs, checkpoint teleports, and arena records.
Flat File & MySQL Storage: Choose between simple local storage or scalable MySQL support.
Developer API: Hook into join, leave, checkpoint, and statistic events through a fully featured API.
Debug & Profiling Tools: Includes testing utilities, component previews, and event timing tools for troubleshooting.

SETUP & MENUS

Advanced Parkour is designed so server owners can build a full arena without leaving the game. The setup flow is visual, fast, and safe.

Step 1: Create the Arena
Create a new arena with a unique ID.

Code:

/ap create <arena_id>

Step 2: Open the Arena Editor
Open the full in-game setup menu.

Code:

/ap edit <arena_id>

Step 3: Set Required Locations
Configure the Start and End locations directly from the GUI.

Step 4: Configure Capacity & Join Sign
Set a player cap if needed and create clickable arena signs.

Step 5: Build the Checkpoint Route
Use the checkpoint selector tool to place the route in exact order. The first checkpoint becomes the start, the last checkpoint becomes the finish.

Step 6: Arena Music Selection
If NoteBlockAPI is installed, you can assign a song to each arena and preview tracks directly from the GUI.

Step 7: Configure Player Settings
From the setup menu you can also configure:

Maximum players
Arena join sign
Checkpoint material
Arena music
Join gamemode
Arena potion effects
Per-arena scoreboard toggle
Per-arena boss bar toggle

Step 8: Register the Arena
Once start, end, and at least two checkpoints are ready, register the arena and let players join.

GAMEPLAY FLOW

Join the Arena: Players can join with commands or by right-clicking a linked arena sign.
Start on the First Checkpoint: Joining the arena does not instantly start the timer. The run begins cleanly on the start checkpoint.
Progress in Order: The plugin validates checkpoint order and rejects skipped progression.
Improve Every Section: Correct checkpoints record split times and update checkpoint personal bests.
Recover From Mistakes: Players can teleport to the last valid checkpoint or fully reset the run.
Chase Records: Finishing the final checkpoint can trigger a normal completion, a personal best, a global record, or both at once.
Compete Long-Term: The plugin tracks repeated play through completions, perfect runs, checkpoint stats, and leaderboards.

STATS & LEADERBOARDS

Advanced Parkour is not only about finishing a course. It is built to keep players coming back through personal bests, checkpoint bests, arena records, and live leaderboard competition.

COMMANDS & PERMISSIONS

All commands can be used via /advancedparkour or /ap.

Gameplay Commands
Default player-facing command flow.

/ap join <arena>

Join a ready arena and enter the course.
/ap start <arena>

Permission: advancedparkour.command.start
Join through the explicit start flow, useful for controlled access or staff testing.
/ap leave

Leave the current run safely and return to the arena end location.
/ap stats [player]

Open the stats menu for yourself or another online/cached offline player.

Arena Setup Commands
Requires advancedparkour.arena.* or the listed node.

/ap create <arena_id>

Permission: advancedparkour.arena.create
Create a new arena instance with a unique ID.
/ap delete <arena_id> [--confirm] [--cancel]

Permission: advancedparkour.arena.delete
Delete an arena through an explicit confirmation flow.
/ap list

Permission: advancedparkour.arena.list
Show every arena with clickable ready/edit actions.
/ap edit <arena_id>

Permission: advancedparkour.arena.edit
Open the interactive setup GUI for the chosen arena.

Administration Commands
Requires advancedparkour.admin or the listed node.

/ap

Shows plugin/version information.
/ap help

Permission: advancedparkour.command.help
Displays the dynamic help menu.
/ap reload

Permission: advancedparkour.admin.reload
Reload configuration files, items, event profiler settings, signs, and game-related caches.
/ap stop [arena]

Permission: advancedparkour.admin.stop
Force-stop the current or specified arena game.
/ap kick <player>

Permission: advancedparkour.admin.kick
Remove a player from an active run and return them to the arena end location.

Debug & Troubleshooting
Requires advancedparkour.debug.* and debug: true in config.yml.

/ap debug join <arena> [--players=p1,p2]

Permission: advancedparkour.debug.join
Start a test run instantly and optionally pull other players into it.
/ap debug component <message>

Permission: advancedparkour.debug.component
Preview MiniMessage formatting and gradients safely in-game.
/ap debug dump

Permission: advancedparkour.debug.dump
Show an event timing report for troubleshooting lag or plugin conflicts.

PLACEHOLDERS

To use these placeholders, you must have PlaceholderAPI installed on your server.

General Player Stats

Code:

%advancedparkour_name%                      - Player name
%advancedparkour_uuid%                      - Player UUID
%advancedparkour_games_played%              - Total runs started
%advancedparkour_completions%               - Total successful completions
%advancedparkour_uncompleted_runs%          - Total unfinished runs
%advancedparkour_perfect_runs%              - Total flawless runs
%advancedparkour_checkpoint_teleports%      - Total checkpoint teleports
%advancedparkour_checkpoints_reached%       - Total checkpoints reached
%advancedparkour_completion_rate%           - Completion rate percentage

Live Session / Current Arena

Code:

%advancedparkour_is_playing%                     - Whether the player is currently in a run
%advancedparkour_current_arena%                  - Current arena ID
%advancedparkour_current_arena_players%          - Current players in the player's arena
%advancedparkour_current_arena_max_players%      - Max players in the player's arena
%advancedparkour_current_arena_state%            - Arena state
%advancedparkour_current_arena_checkpoint_count% - Total checkpoints in current arena
%advancedparkour_active_run_time%                - Current formatted run time
%advancedparkour_active_run_time_raw%            - Current run time in raw milliseconds
%advancedparkour_active_fails%                   - Current fail count
%advancedparkour_active_checkpoint%              - Current checkpoint index
%advancedparkour_active_next_checkpoint%         - Next target checkpoint index
%advancedparkour_active_checkpoint_count%        - Total checkpoints in the current arena
%advancedparkour_active_perfect_run%             - Whether the run is still flawless
%advancedparkour_active_awaiting_start%          - Whether the player is waiting on the start checkpoint
%advancedparkour_active_pending_reset%           - Whether a reset is pending

Personal Best / Records

Code:

%advancedparkour_current_arena_best%            - Player PB for the current arena
%advancedparkour_current_arena_best_raw%        - Player PB for the current arena in milliseconds
%advancedparkour_current_arena_record_holder%   - Global record holder of current arena
%advancedparkour_current_arena_record_time%     - Global record time of current arena
%advancedparkour_current_arena_record_time_raw% - Global record time of current arena in milliseconds
%advancedparkour_arena_best:<arena_id>%         - Player PB for a specific arena
%advancedparkour_arena_best_raw:<arena_id>%     - Player PB for a specific arena in milliseconds
%advancedparkour_checkpoint_best:<arena_id>:<checkpoint>%     - Player PB for a specific checkpoint split
%advancedparkour_checkpoint_best_raw:<arena_id>:<checkpoint>% - Raw checkpoint split PB in milliseconds

Global Plugin Data

Code:

%advancedparkour_arenas_total% - Total arenas registered
%advancedparkour_arenas_ready% - Total arenas marked ready
%advancedparkour_active_games% - Total active game instances
%advancedparkour_active_players% - Total players currently inside parkour runs

Arena-Specific Placeholders

Code:

%advancedparkour_arena:<arena_id>:players%              - Current players in that arena
%advancedparkour_arena:<arena_id>:max_players%          - Max player cap
%advancedparkour_arena:<arena_id>:ready%                - Whether the arena is ready
%advancedparkour_arena:<arena_id>:state%                - Arena state
%advancedparkour_arena:<arena_id>:checkpoint_count%     - Total checkpoints
%advancedparkour_arena:<arena_id>:record_holder%        - Arena record holder
%advancedparkour_arena:<arena_id>:record_time%          - Arena record time
%advancedparkour_arena:<arena_id>:record_time_raw%      - Arena record time in milliseconds
%advancedparkour_arena:<arena_id>:song%                 - Selected NoteBlock song
%advancedparkour_arena:<arena_id>:gamemode%             - Arena join gamemode
%advancedparkour_arena:<arena_id>:scoreboard_enabled%   - Arena scoreboard toggle
%advancedparkour_arena:<arena_id>:bossbar_enabled%      - Arena boss bar toggle
%advancedparkour_arena:<arena_id>:potion_effects_count% - Amount of arena join effects
%advancedparkour_arena:<arena_id>:has_potion_effects%   - Whether the arena applies effects

Leaderboard Syntax

Code:

%advancedparkour_leaderboard:<stat>:<position>:<name|uuid|value|formatted_value>%

Tracked Statistic Leaderboards

Code:

games_played
completions
uncompleted_runs
perfect_runs
checkpoint_teleports
checkpoints_reached

Arena Time Leaderboards

Code:

arena_time_<arena_id>

Checkpoint Split Leaderboards

Code:

checkpoint_time_<arena_id>_<checkpoint_index>

Examples

Code:

%advancedparkour_leaderboard:completions:1:name%
%advancedparkour_leaderboard:completions:1:value%
%advancedparkour_leaderboard:arena_time_easy:1:formatted_value%
%advancedparkour_leaderboard:checkpoint_time_easy_3:1:name%
%advancedparkour_leaderboard:checkpoint_time_easy_3:1:formatted_value%

TERMS OF SERVICE

By using this plugin, you agree to the following terms, which may be updated by the author at any time.

All payments are final and non-refundable.
Redistribution or resale of this plugin is prohibited.
You are not permitted to modify, decompile, or extract any part of the plugin's source code.
Support is provided exclusively to legitimate customers. We cannot offer support for plugins obtained through unauthorized or illegal means.

bStats METRICS

This plugin collects anonymous usage statistics through bStats.

This data helps us understand how Advanced Parkour is being used in the wild and helps guide future development. No private information is collected.

Enjoying the plugin?

We spend hundreds of hours making Advanced Parkour the best minigame experience for your server.
If you like the plugin, please consider leaving a 5-star review!

A huge thank you to everyone who has purchased and supported the project so far!

Advanced Parkour v1.0.7

Overview Updates (7) History