ParkourPro - Multi-Version 1.1.0

# ParkourPro 1.1.0

## New
- **Item frame map boards** – a leaderboard poster rendered onto maps in a grid of item frames: header with your server name, podium with the top three player heads, ranked rows and a footer. Hang the top-left item frame on a wall, look at it and run `/parkour mapboard add <parkour> [alltime|daily|weekly|monthly] [WxH]`. Missing frames are placed automatically. Default size 3x4 (1x1 up to 8x8). Every colour and text is configurable under `map-boards` in config.yml.
- `/parkour mapboard remove [parkour]`, `list` and `refresh`.
- Boards refresh together with the holograms and instantly after new records, `deletetime`, `settime` and season changes.
- Rendering uses a built-in pixel font, so it works on headless servers and on Minecraft 1.8 through 26.x.
- **Update checker** – the plugin checks for a newer release on startup and every 6 hours. Admins are told on join, the console logs it, and `/parkour version` checks on demand. Configurable under `update-checker`.

## Notes
- Drop-in update: replace the jar and restart. Configs, parkours and records stay compatible; new config keys and messages are added automatically.
- New file `mapboards.yml` stores the boards.

📖 Wiki: https://stanotermans.github.io/Parkourpro-lite-wiki/
💬 Support: https://discord.gg/2UTkYj26B4

# ParkourPro 1.0.9

Twenty new features in one update. Everything in Lite 1.0.9 plus ghost replays, races, seasons, daily/weekly/monthly leaderboards, a parkour menu, rewards by time and rank, checkpoint effects, a speed check, network sync and a web API. Works on Minecraft 1.8 through 26.x.

## New in both editions
- **Checkpoint splits** – every checkpoint shows your elapsed time and the difference with your own record. Splits are stored with the record.
- **`/parkour top`** and **`/parkour pb`** – leaderboard in chat and personal best with splits and statistics.
- **Statistics** – attempts, completions, play time and race wins per player and parkour (`stats.yml` + MySQL).
- **New placeholders** – `%parkour_current%`, `%parkour_current_time%`, `%parkour_current_checkpoint%`, `%parkour_top_<parkour>_<pos>_prefix%`, `%parkour_attempts_<parkour>%`, `%parkour_completions_<parkour>%`, `%parkour_playtime_<parkour>%`, `%parkour_racewins_<parkour>%`.
- **Leave radius, cooldown and daily attempt limit** – `setleaveradius`, `setcooldown`, `setmaxattempts`.
- **Per-parkour sounds and titles** – `setsound`, `settitle`.
- **Export / import** – move a course to another world or server.
- **Creation wizard** – optional steps for reset location, leave position and leaderboard.
- **Discord webhook** – records and first completions without a bot.

## New in Pro
- **Ghost replay** – the fastest run of every parkour is recorded automatically. `/parkour ghost <parkour> [play|loop|stop]` replays it as an armor stand with the record holder's head. Optional auto-play on start.
- **Race mode** – `/parkour race create <parkour>`, `join <host>`, `start`. Countdown with titles, everyone frozen on the start plate, first over the finish wins, race wins tracked, winner commands.
- **Daily / weekly / monthly leaderboards** – `/parkour top <parkour> weekly`, extra holograms with `/parkour addperiodleaderboard`, available through the API.
- **Seasons** – `/parkour season new <name> confirm` pays the configured rewards to the top players of every parkour, archives all records and starts fresh.
- **Parkour menu** – `/parkour menu` lists every parkour with your best time, rank and attempts; click to teleport.
- **Rewards by time and rank** – `addtimereward`, `addtopreward`, `addrecordreward`, `/parkour rewards <parkour>`.
- **Checkpoint effects** – title, sound, particles or commands per checkpoint with `setcheckpointeffect`.
- **Speed check** – `anti-cheat.detect-speed` with strikes and speed-potion tolerance (off by default).
- **Network sync** – `mysql.sync-interval` refreshes holograms when another server sharing the database sets a record.
- **Web API** – read-only JSON for websites and bots: `/api/parkours`, `/api/leaderboard/<parkour>`, `/api/player/<name>`, `/api/stats/<parkour>`, `/api/season`, optional bearer token.
- **Proximity finish** (from 1.0.8) – `togglefinishproximity` lets players finish without triggering the end plate.

## Changed
- Checkpoints must now be activated in order (`checkpoints.sequential`, default true).
- New permissions with default true: `parkour.race`, `parkour.ghost`, `parkour.menu`.

## Notes
- Drop-in update: replace the jar and restart. Configs, parkours and records stay compatible; new keys and messages are added automatically.
- With MySQL the `stats` and `period_records` tables and the `splits` column are created on first connect.
- New config sections: `ghost`, `race`, `seasons`, `web-api`, `discord-webhook`, `anti-cheat.detect-speed`, `mysql.sync-interval`.

📖 Wiki: https://stanotermans.github.io/Parkourpro-lite-wiki/
💬 Support, bug reports and new languages: https://discord.gg/2UTkYj26B4

ParkourPro & ParkourPro Lite 1.0.8

New commands (Pro and Lite)

/parkour deletetime <parkour> <player> wipes a player's record, for example a cheater. Works for offline players and with MySQL. The leaderboard hologram refreshes instantly.

/parkour settime <parkour> <player> <mm:ss.ms> sets or overwrites a player's record. Accepts 01:23.456, 1:23.4, 83.5, 45 and 1:01:23.456. The leaderboard hologram refreshes instantly.

Tab completion for both commands: parkour names, player names (online players plus players with a stored record) and an example time format.

New in Pro
/parkour togglefinishproximity <parkour> [radius] lets players finish by reaching the end plate area, without having to trigger the gold pressure plate. Optional radius from 0.5 to 10 blocks, default 1.0. All finish rules such as required checkpoints, records, rewards, end commands and redirect still apply.

Other
New messages added to the built-in defaults and to the en_US and nl_NL language files. Other languages receive the English text automatically.
Version bumped to 1.0.8.
Compatible with Minecraft 1.8 through 26.x, like the rest of the plugin.

v1.0.7-1 Changelog

Fully fixed tps and lagg issue because of leaderboard hologram

Added feature so only a start and end is needed to start a parkour not a checkpoint is needed

Fixed reset look position.

v1.0.6-1 Changelog

Fixed language files not loading — plugin now extracts all 23 language files to the languages/ folder on first start
Fixed prefix not updating when editing a language file
Fixed /parkour reload not refreshing messages after config edits
Set version to 1.0.6-1
Fixed leaderboard hologram entitie count.

✨ Dynamic TextDisplay Holograms

Bring your parkour courses to life with fully customizable floating holograms powered by Paper's native TextDisplay entities. Each hologram type — start, end, checkpoint, and leaderboard — can be configured independently with its own appearance settings.

Features:

Per-type customization — style start, end, checkpoint, and leaderboard holograms separately using /parkour sethologramdisplay <name> <type> <property> <value>
MiniMessage & legacy color codes — full support for both MiniMessage syntax (<gradient:gold:yellow>Text</gradient>, <rainbow>, <bold>, etc.) and classic & color codes anywhere text is configured
Background color — set a custom hex color (#RRGGBB), make it fully transparent, or keep Minecraft's default dark panel
Billboard modes — center, fixed, vertical, or horizontal facing
Scale — resize any hologram from tiny indicators to large displays
See-through — render holograms visible through walls
Live leaderboard — auto-updating top times displayed as a floating board, configurable refresh interval
%best_time% placeholder — show the current world record directly on the start hologram
Moveable — reposition any hologram independently of its plate using /parkour movehologram
Holograms are automatically created when you set a start, end, checkpoint, or leaderboard plate, and persist across server restarts. Fully compatible with Paper 1.19.4+.

ParkourPro & ParkourProLite — v1.0.5

A focused bug-fix and quality-of-life update addressing several reported issues and adding a handful of useful improvements.

🐛 Bug Fixes

Death handling — Players who die during a parkour run now keep their inventory and respawn at their last checkpoint or reset location, instead of being sent to world spawn.

Inventory restore — Parkour items are now properly cleared before the player's saved inventory is restored, fixing a bug where items wouldn't return to slots 3, 4, and 5.

Pressure plate spam — The "already in parkour" message is now debounced (10-second cooldown), so stepping on a plate repeatedly no longer floods chat.

Command block teleports — Teleports triggered by command blocks no longer accidentally cancel an active parkour run.

Admin bypass scope — Admin bypass now only applies to /parkour subcommands, not to all commands while in parkour.

Wizard double-fire — Item-use events in the creation wizard are debounced to prevent double activation on 1.8.

✨ Item Lore Rework (ParkourPro only)

• 
  
• The hidden §0PK: marker previously appended to item lore has been removed entirely.
• Item type is now detected by material + display name, giving you full control over lore.
• Default lore in config.yml is now &6PK:&eTELEPORT, &6PK:&eRESET, and &6PK:&eCANCEL — fully editable or removable.

💬 Messages

Any message in messages.yml can now be silenced by setting it to "" — no message will be sent at all.

🤖 Discord (ParkourPro only)

• 
  
• The /scoreboard command description and option description are now configurable via config.yml:

discord:
  command-description: "Show the top players for a parkour"
  option-description: "Name of the parkour (auto-detected if only one exists)"

• 
  
• /parkour reload now re-registers the Discord slash command instantly — no server restart needed when changing descriptions.
• The parkour argument for /scoreboard is now optional — if only one parkour exists, it is auto-detected.

Thanks for all the reports and feedback that made this update possible. As always, feel free to open an issue or reach out if you run into anything!

1.0.4 — Locking System & Major Fixes

This update brings a highly requested feature — a full parkour locking system — alongside a wave of fixes and improvements across the board.

🔒 Locking System Parkours can now be locked behind a required permission node and/or the completion of another parkour. Both conditions are checked asynchronously when a player tries to start, so there's no performance impact. Locks can be toggled globally via config (locks.enabled) or on the fly with /parkour togglelocks. New commands /parkour setrequiredpermission and /parkour setrequiredcompletion let you configure these conditions per parkour without editing any files. Lock status is saved and loaded alongside the rest of the parkour data.

🛡️ Command & Teleport Exploit Fix Players can no longer use commands or teleport during an active parkour run, closing a commonly abused loophole.

💀 Death & Respawn Death handling now properly falls back to the last checkpoint, or the start if none is set. A toggle in the config controls whether this behavior is enabled by default.

🎒 Quit & Inventory Fix Inventory restore and reset now only trigger when the player is actually in a parkour, preventing items from being incorrectly wiped when using Multiverse or similar plugins.

🛫 Leave & Flight Forced flight is no longer enabled when leaving or finishing a parkour, which was causing unintended behavior for players without flight permissions.

📊 Actionbar Fix Added a safe fallback to prevent a NoSuchMethodError crash on servers running 1.8.

🪨 Checkpoint & Iron Plate Detection Iron pressure plate detection has been expanded so checkpoint plates are recognized more reliably.

📍 setEnd Fix Corrected a location comparison bug in the /parkour setEnd logic that was causing incorrect end point behavior.

🧙 Parkour Creation Wizard Sync and removal handling in the creation wizard has been adjusted for more consistent behavior.

🔧 Lite Fix Restored the addcheckpoint command case in ParkourProLite — checkpoint setting was broken and is now working again.

Version 1.0.3 - Inventory Protection & Polish Update

What's New

Critical Bug Fixes:
- Fixed inventory loss bug - Players no longer lose items from hotbar slots 3, 4, and 5 when disconnecting during parkour challenges
- Fixed flight mode restoration - Flight permissions now correctly re-enable after completing parkour (previously only worked on manual cancellation)
- Fixed prefix configuration reloading - Prefix changes in config.yml or messages.yml now apply immediately with /parkour reload without requiring server restart
- Fixed hologram duplication on restart - Server restarts no longer create duplicate holograms, eliminating visual clutter
- Fixed startup crashes - Resolved NullPointerException errors when starting server with existing parkour data

User Experience Enhancements:
- Improved Discord integration (ParkourPro only) - /scoreboard command now auto-detects parkour on single-parkour servers, removing the need to specify parkour name

Technical Improvements:
- Complete inventory state preservation system (contents, armor, offhand, flight status)
- Enhanced parkour item detection using lore-based identification across entire inventory
- Restructured initialization sequence to prevent circular dependency issues
- Real-time configuration updates with cascading fallback system (config.yml → messages.yml → defaults)
- Proper cleanup-before-creation pattern for hologram lifecycle management
- Enhanced LuckPerms integration with dual-context querying

Verified Functionality:
- ✅ /parkour undocheckpoint - Revert to previous checkpoint
- ✅ /parkour addendcommand <parkour> <command> - Configure completion rewards
- ✅ /parkour removeendcommand <parkour> <command> - Remove completion rewards

Compatibility
- Minecraft Versions: 1.8 - 1.21.11
- Server Software: Spigot/Paper
- Java Version: Java 8+

Installation
1. Stop your server
2. Replace existing JAR file with ParkourPro-1.0.3.jar or ParkourProLite-1.0.3.jar
3. Start your server (no configuration changes required)

⚠️ Important Notice
This update is highly recommended due to critical inventory protection fixes. All existing configurations remain fully compatible.

Version 1.0.2 - Critical Stability Update

What's New

Major Bug Fixes:

- Fixed records disappearing after server restart - Leaderboard times now correctly persist and reload
- Fixed duplicate hologram spawning - Holograms no longer multiply after each server restart
- Complete parkour cleanup - /parkour delete now properly removes all holograms (start, end, checkpoints, and leaderboard)
- Targeted hologram removal - /parkour removehologram <type> now correctly removes specific types instead of all holograms
- Legacy data migration - Automatic import of existing records when switching between ParkourPro and ParkourProLite

Technical Improvements:

- Implemented dual persistence system (MySQL Database + Local YAML)
- Added physical armor stand cleanup to prevent entity persistence issues
- Synchronized configuration reloading for reliable data retrieval
- Enhanced hologram management with location-based entity removal

Installation

1. Download ParkourPro-1.0.2.jar or ParkourProLite-1.0.2.jar

Fixed hologram remove command.
now if you do ( /parkour removehologram yourparkourname all ) it will remove all the holograms.
with /parkour reload they will comeback

 ParkourPro & ParkourProLite v1.0.1 Release
We're excited to announce version 1.0.1 with critical bug fixes and quality-of-life improvements!

 What's New
Enhanced Inventory Management

Players' full inventory, armor, and offhand items are now properly saved before parkour runs and fully restored upon completion, cancellation, or leaving
Parkour now starts with a clean slate—only the three plugin items (Checkpoint, Reset, Cancel) remain during runs, preventing item loss or confusion
Improved Hologram Controls

Added /parkour movehologram command to relocate holograms for start, end, leaderboard, and checkpoints to custom positions
Added /parkour removehologram command with support for disabling individual holograms or all at once (all option)
Hologram enable/disable states and custom locations are now persisted across server restarts
Better Compatibility

Fixed anti-fly detection crash on Minecraft 1.8 to 1.21.11 servers caused by missing gliding API
Full support maintained for Minecraft versions 1.8 through 1.21.11
 Download & Install
Simply replace your existing plugin JAR with the new version and restart your server. All configurations and data are preserved.

Changelog: Inventory state capture/restore, hologram position controls, 1.8 elytra crash fix
Tested: Minecraft 1.8 – 1.21.11
Support: https://discord.gg/sEdMPqNFbM