ParkourPro - Multi-Version 1.0.6-1

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