Parkour

How a Course Works

Every course has the same anatomy, set up by an admin in parkour.yml:

1. Start pad. Where you teleport in when you join. You must begin a run from here — teleporting to the finish does not count.
2. Checkpoints. An ordered list of pad locations. You must reach each one in sequence (within 2 blocks) for it to register, with a chime sound and a progress message.
3. Finish line. The final pad. Touching it (within 3 blocks) only completes the run if you started from the start and hit every checkpoint.
4. Kill floor. A configurable Y height. Fall below it and you are teleported back to your last checkpoint with your fall distance cleared.

Flight is disabled the moment you join a course, so you cannot cheese the jumps. The only way through is to actually run it.

Checkpoints & the Kill Floor

Checkpoints are the safety net of a course. As you reach each one, the system records its exact location as your new respawn point. If you fall below the kill floor — or if you type /parkour checkpoint manually — you are teleported back to the last checkpoint you touched, with your velocity zeroed and fall damage cleared.

The fall rescue is debounced so you are not yanked repeatedly if you tumble through the kill floor at speed — one teleport per second max. Each rescue plays a sad item-break sound so you know it happened.

Completing a Course & Rewards

When you touch the finish line with a legitimate run, the course completes. Your time is recorded to the hundredth of a second, a celebration sound plays, and rewards land in your balances. A server-wide broadcast announces your name, the course, and your time.

The reward types a course can pay out:

Reward amounts are set per course, so an easy beginner course might pay a few thousand Denarius while a brutal endgame course pays six figures plus a crate key. The reward commands are admin-defined, so they can hand out anything the console can grant.

Cooldowns — No Farming

Each course has a configurable cooldown (default 60 minutes) that starts the moment you complete it. While the cooldown is active, attempting to rejoin the same course is refused with a message showing how many minutes remain.

Cooldowns are per-course, so a parkour regular can rotate through several different courses in a session and stay on the reward treadmill without waiting out a single timer.

Leaderboards & Best Times

Every completion writes a record to the database: your best time ever on that course (only improved, never worsened) and your total completions. Use /parkour leaderboard <name> to see the top 10 times on any course, ranked fastest first.

The leaderboard is the prestige layer of parkour. The rewards are nice, but holding a top time on a hard course is the real flex — your name sits at the top of the list for every other runner to see.

The /parkour Command Family

Joining a course automatically leaves any course you were already in, so you never need to manually leave before switching. Quitting the server also cleans up your session and any in-memory cooldown state.

Tips for Fast Runs

• Memorize the checkpoint order. Knowing which pad comes next lets you commit to jumps instead of hesitating.
• Use momentum. Sprint-jumping and keeping your speed between pads shaves seconds off your time.
• Don't fear the kill floor. Falling resets you to your last checkpoint instantly — better to attempt a risky jump than to crawl.
• Hit checkpoints dead-center. The 2-block trigger radius is forgiving, but grazing the edge wastes time on your next jump.
• Run multiple courses. Per-course cooldowns mean rotating through three or four courses keeps you on the reward treadmill.
• Watch the leaderboard. Knowing the current top time tells you what pace to beat.
• Don't teleport away mid-run. Any teleport that is not to a checkpoint or the start pad ends your session immediately.

Quick Reference