LoParkour
Advanced infinitely generating parkour plugin for Minecraft
by loki
## 🚀 Building
```bash
# Windows
gradlew.bat clean build
# Linux/Mac
./gradlew clean build
```
Output: `build/libs/LoParkour-1.3.0.jar`
## 📋 Requirements
- Java 21+
- Spigot/Paper 1.20.4+
- MySQL (optional, for leaderboards)
## ✨ Features
- **Infinite Generation** - Parkour generates endlessly as you play
- **Multiple Game Modes** - Default, Speedrun, Hardcore, Gravity Shift, Elytra
- **Ghost System** - Race against top player recordings
- **Custom Schematics** - Create and use your own parkour structures
- **Visual Themes** - Customize block styles and particle effects
- **Leaderboards** - Track high scores with MySQL or local storage
- **Rewards System** - Configure rewards for score milestones
- **Multi-language** - Full localization support
## 🎮 Game Modes
- **Default** - Classic infinite parkour
- **Speedrun** - Blocks disappear after a few seconds
- **Hardcore** - Lose all rewards on fall
- **Gravity Shift** - Random gravity effects (levitation, slow falling, jump boost)
- **Elytra** - Fly through particle rings
## 🗂️ Schematics
LoParkour uses `.lpschem` format for custom parkour structures:
- Lightweight JSON-based format with GZIP compression
- Supports block states, markers (start/end points), and metadata
- Automatic conversion from old vilib format: `/lp schematic convert`
- Create schematics in-game with `/lp schematic save `
- Reload schematics: `/lp schematic reload`
## 🔧 Commands
- `/lp join` - Join parkour
- `/lp leave` - Leave parkour
- `/lp spectate ` - Spectate another player
- `/lp schematic ` - Manage schematics
- `/lp forcejoin ` - Force player to join (admin)
- `/lp reset` - Reset leaderboards (admin)
## 📊 Configuration
Main config: `plugins/LoParkour/config.yml`
- Enable/disable features
- Configure game modes
- Set up MySQL connection
- Customize generation settings
- Configure rewards
## 🌍 Localization
Add custom languages in `plugins/LoParkour/locales/`
- Default: English (`en.yml`)
- Included: Russian (`ru.yml`)
- Players can switch language in-game menu
## 🔌 Integrations
- **PlaceholderAPI** - Use parkour stats in other plugins
- **Vault** - Economy rewards support
- **HolographicDisplays** - Holographic leaderboards
- **Floodgate** - Bedrock player support
## 📝 Development
Built with LoLib 2.0 framework for modern Minecraft plugin development.
See `docs/CHANGES.md` for changelog.