UltimateBounce

** BouncePads — Complete Plugin Documentation --- Overview What is BouncePads? BouncePads is a lightweight, performance-optimized Minecraft plugin that transforms any solid block into a configurable bounce/jump pad. When a player steps on a configured block, they are automatically launched into the air with customizable velocity, direction, sound effects, and particles. Inspired by popular servers like CubeCraft, Hypixel, and Hive, the plugin brings smooth, lag-free bounce mechanics to your server. Perfect for FFA arenas, BedWars, SkyWars, parkour maps, lobbies, and any gamemode that needs launch pads. Plugin Information | Detail | Value | |--------|-------| | **Plugin Name** | BouncePads | | **Version** | 1.0.0 | | **API Version** | 1.21+ | | **Supported Versions** | Paper/Spigot 1.21 - 1.21.11 | | **Server Software** | Paper, Spigot, and all forks | | **Java Version** | 21+ | | **Soft Dependencies** | PlaceholderAPI, WorldGuard, Vault | How It Works ``` Player steps on configured block (or pressure plate above it) │ ▼ Plugin detects the bounce block │ ▼ Checks: enabled? world allowed? permission? cooldown? │ ▼ Calculates velocity (vertical + horizontal + direction + multipliers) │ ▼ Applies velocity to player │ ▼ Plays sound effects and particle effects │ ▼ Applies fall damage protection │ ▼ Sets cooldown timer ``` Use Cases | Server Type | How BouncePads Helps | |-------------|---------------------| | **FFA / PvP Arenas** | Strategic launch points around the map for quick traversal | | **BedWars / SkyWars** | Launch pads between islands with directional bouncing | | **Lobby Servers** | Fun bounce areas to guide players to different games | | **Parkour Maps** | Momentum-based bounce chains with varying heights | | **Hub / Spawn** | Directional pads pointing players toward attractions | | **Minigame Networks** | Configurable per-world launch systems | --- Features Summary Core Features ``` ✅ Turn any solid block into a bounce pad ✅ Per-block velocity configuration (vertical + horizontal) ✅ Three activation modes: Direct, Pressure Plate, Hybrid ✅ Different bounce strengths for different blocks ✅ Smooth velocity application without potion effects ✅ Works for all players server-wide ✅ Automatic fall damage protection after bouncing ✅ Per-block cooldown system ✅ Per-player toggle (on/off for bouncing, sounds, particles) ``` Directional Bouncing ``` ⬆️ VERTICAL_ONLY — Pure upward bounce (default) 🎯 PLAYER_FACING — Launch in player's look direction ↗️ PLAYER_FACING_HORIZONTAL — Horizontal look direction + vertical 🧭 FIXED_DIRECTION — Always launch toward configured compass direction 💫 AWAY_FROM_CENTER — Launch away from the block's center ``` Pressure Plate System ``` ✅ Supports all 15 pressure plate types in Minecraft ✅ Different velocity multipliers per plate type ✅ Weighted pressure plates give stronger bounces ✅ Restrict which plate types work on each block ✅ Player-only activation (excludes mobs and items) ``` Effects System ``` 🔊 Custom sound effects per block (any Minecraft sound) 🎆 Custom particle effects per block (any Minecraft particle) 🌟 Particle trails while player is airborne 💥 Launch and landing particle effects 🎵 Configurable volume and pitch per block 🔇 Per-player sound/particle toggles ``` Preset System ``` 📋 8 built-in presets ready to use 📝 Create unlimited custom presets from existing blocks 📎 Apply presets to any block instantly with one command 🔒 Built-in presets protected from accidental deletion 💾 All presets saved persistently in presets.yml ``` GUI Management System ``` 🖥️ Full inventory-based management GUI 📋 Paginated block list with click-to-edit ✏️ Interactive block editing with increase/decrease buttons 🎨 Color-coded toggles and status indicators 📊 Statistics display within GUI 📦 Preset selection and application GUI ⚙️ Personal player settings GUI ✅ Confirmation dialogs for destructive actions 💬 Chat-based input for precise value entry ``` World Restrictions ``` 🌍 DISABLED mode — bouncing works in all worlds 📋 WHITELIST mode — bouncing only in listed worlds 🚫 BLACKLIST mode — bouncing everywhere except listed worlds 🔄 Per-world activation mode overrides 📊 Per-world velocity multipliers 🛡️ WorldGuard region-based restrictions ``` Performance Optimizations ``` ⚡ Optimized movement event handling with early exits 📦 Concurrent data structures for thread safety ⏱️ Debounce system prevents double-processing 🗑️ Automatic expired cooldown cleanup 💾 Asynchronous data saving 📊 Configurable cache limits 🔧 Minimal TPS impact even with 100+ concurrent players 📋 Efficient HashSet/HashMap lookups for O(1) block detection ``` Integrations ``` 📊 PlaceholderAPI — 10+ placeholders available 🛡️ WorldGuard — Region-based bounce restrictions 💰 Vault — Economy support prepared for fu