**
\n BouncePads \u2014 Complete Plugin Documentation<\/p>\n
—<\/p>\n
Overview<\/p>\n
What is BouncePads?<\/p>\n
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.<\/p>\n
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.<\/p>\n
Plugin Information<\/p>\n
| Detail | Value |
\n|——–|——-|
\n| **Plugin Name** | BouncePads |
\n| **Version** | 1.0.0 |
\n| **API Version** | 1.21+ |
\n| **Supported Versions** | Paper\/Spigot 1.21 – 1.21.11 |
\n| **Server Software** | Paper, Spigot, and all forks |
\n| **Java Version** | 21+ |
\n| **Soft Dependencies** | PlaceholderAPI, WorldGuard, Vault |<\/p>\n
How It Works<\/p>\n
“`
\nPlayer steps on configured block (or pressure plate above it)
\n \u2502
\n \u25bc
\nPlugin detects the bounce block
\n \u2502
\n \u25bc
\nChecks: enabled? world allowed? permission? cooldown?
\n \u2502
\n \u25bc
\nCalculates velocity (vertical + horizontal + direction + multipliers)
\n \u2502
\n \u25bc
\nApplies velocity to player
\n \u2502
\n \u25bc
\nPlays sound effects and particle effects
\n \u2502
\n \u25bc
\nApplies fall damage protection
\n \u2502
\n \u25bc
\nSets cooldown timer
\n“`<\/p>\n
Use Cases<\/p>\n
| Server Type | How BouncePads Helps |
\n|————-|———————|
\n| **FFA \/ PvP Arenas** | Strategic launch points around the map for quick traversal |
\n| **BedWars \/ SkyWars** | Launch pads between islands with directional bouncing |
\n| **Lobby Servers** | Fun bounce areas to guide players to different games |
\n| **Parkour Maps** | Momentum-based bounce chains with varying heights |
\n| **Hub \/ Spawn** | Directional pads pointing players toward attractions |
\n| **Minigame Networks** | Configurable per-world launch systems |<\/p>\n
—<\/p>\n
Features Summary<\/p>\n
Core Features
\n“`
\n\u2705 Turn any solid block into a bounce pad
\n\u2705 Per-block velocity configuration (vertical + horizontal)
\n\u2705 Three activation modes: Direct, Pressure Plate, Hybrid
\n\u2705 Different bounce strengths for different blocks
\n\u2705 Smooth velocity application without potion effects
\n\u2705 Works for all players server-wide
\n\u2705 Automatic fall damage protection after bouncing
\n\u2705 Per-block cooldown system
\n\u2705 Per-player toggle (on\/off for bouncing, sounds, particles)
\n“`<\/p>\n
Directional Bouncing
\n“`
\n\u2b06\ufe0f VERTICAL_ONLY \u2014 Pure upward bounce (default)
\n\ud83c\udfaf PLAYER_FACING \u2014 Launch in player’s look direction
\n\u2197\ufe0f PLAYER_FACING_HORIZONTAL \u2014 Horizontal look direction + vertical
\n\ud83e\udded FIXED_DIRECTION \u2014 Always launch toward configured compass direction
\n\ud83d\udcab AWAY_FROM_CENTER \u2014 Launch away from the block’s center
\n“`<\/p>\n
Pressure Plate System
\n“`
\n\u2705 Supports all 15 pressure plate types in Minecraft
\n\u2705 Different velocity multipliers per plate type
\n\u2705 Weighted pressure plates give stronger bounces
\n\u2705 Restrict which plate types work on each block
\n\u2705 Player-only activation (excludes mobs and items)
\n“`<\/p>\n
Effects System
\n“`
\n\ud83d\udd0a Custom sound effects per block (any Minecraft sound)
\n\ud83c\udf86 Custom particle effects per block (any Minecraft particle)
\n\ud83c\udf1f Particle trails while player is airborne
\n\ud83d\udca5 Launch and landing particle effects
\n\ud83c\udfb5 Configurable volume and pitch per block
\n\ud83d\udd07 Per-player sound\/particle toggles
\n“`<\/p>\n
Preset System
\n“`
\n\ud83d\udccb 8 built-in presets ready to use
\n\ud83d\udcdd Create unlimited custom presets from existing blocks
\n\ud83d\udcce Apply presets to any block instantly with one command
\n\ud83d\udd12 Built-in presets protected from accidental deletion
\n\ud83d\udcbe All presets saved persistently in presets.yml
\n“`<\/p>\n
GUI Management System
\n“`
\n\ud83d\udda5\ufe0f Full inventory-based management GUI
\n\ud83d\udccb Paginated block list with click-to-edit
\n\u270f\ufe0f Interactive block editing with increase\/decrease buttons
\n\ud83c\udfa8 Color-coded toggles and status indicators
\n\ud83d\udcca Statistics display within GUI
\n\ud83d\udce6 Preset selection and application GUI
\n\u2699\ufe0f Personal player settings GUI
\n\u2705 Confirmation dialogs for destructive actions
\n\ud83d\udcac Chat-based input for precise value entry
\n“`<\/p>\n
World Restrictions
\n“`
\n\ud83c\udf0d DISABLED mode \u2014 bouncing works in all worlds
\n\ud83d\udccb WHITELIST mode \u2014 bouncing only in listed worlds
\n\ud83d\udeab BLACKLIST mode \u2014 bouncing everywhere except listed worlds
\n\ud83d\udd04 Per-world activation mode overrides
\n\ud83d\udcca Per-world velocity multipliers
\n\ud83d\udee1\ufe0f WorldGuard region-based restrictions
\n“`<\/p>\n
Performance Optimizations
\n“`
\n\u26a1 Optimized movement event handling with early exits
\n\ud83d\udce6 Concurrent data structures for thread safety
\n\u23f1\ufe0f Debounce system prevents double-processing
\n\ud83d\uddd1\ufe0f Automatic expired cooldown cleanup
\n\ud83d\udcbe Asynchronous data saving
\n\ud83d\udcca Configurable cache limits
\n\ud83d\udd27 Minimal TPS impact even with 100+ concurrent players
\n\ud83d\udccb Efficient HashSet\/HashMap lookups for O(1) block detection
\n“`<\/p>\n
Integrations
\n“`
\n\ud83d\udcca PlaceholderAPI \u2014 10+ placeholders available
\n\ud83d\udee1\ufe0f WorldGuard \u2014 Region-based bounce restrictions
\n\ud83d\udcb0 Vault \u2014 Economy support prepared for future features
\n\ud83d\udcc8 bStats \u2014 Anonymous usage metrics
\n“`<\/p>\n
Configuration
\n“`
\n\ud83d\udcdd Every message customizable in messages.yml
\n\u2699\ufe0f Every setting configurable in config.yml
\n\ud83d\udce6 Block data stored separately in data\/blocks.yml
\n\ud83d\udccb Presets stored separately in data\/presets.yml
\n\ud83d\udc64 Player data stored separately in data\/players.yml
\n\ud83c\udfa8 Full color code support (& codes + hex &RRGGBB)
\n\ud83d\udd04 Hot-reload without server restart via \/bp reload
\n“`<\/p>\n
—<\/p>\n
Installation Guide<\/p>\n
Requirements<\/p>\n
| Requirement | Details |
\n|————-|———|
\n| **Server Software** | Paper or Spigot (or any fork) |
\n| **Minecraft Version** | 1.21 through 1.21.11 |
\n| **Java Version** | Java 21 or higher |
\n| **Disk Space** | Less than 1MB |<\/p>\n
Optional Dependencies<\/p>\n
| Plugin | Purpose | Required? |
\n|——–|———|———–|
\n| **PlaceholderAPI** | Display bounce stats in chat, scoreboard, etc. | No |
\n| **WorldGuard** | Region-based bounce pad restrictions | No |
\n| **Vault** | Economy integration (prepared for future) | No |<\/p>\n
Step-by-Step Installation<\/p>\n
**Step 1: Download the Plugin**
\n“`
\nDownload BouncePads-1.0.0.jar from the official download page
\n“`<\/p>\n
**Step 2: Install the JAR**
\n“`
\nPlace BouncePads-1.0.0.jar into your server’s plugins\/ folder<\/p>\n
Server\/
\n\u251c\u2500\u2500 plugins\/
\n\u2502 \u251c\u2500\u2500 BouncePads-1.0.0.jar \u2190 Place here
\n\u2502 \u2514\u2500\u2500 … other plugins
\n\u251c\u2500\u2500 server.jar
\n\u2514\u2500\u2500 …
\n“`<\/p>\n
**Step 3: Start or Restart Your Server**
\n“`
\nThe plugin will generate its configuration files automatically:<\/p>\n
plugins\/BouncePads\/
\n\u251c\u2500\u2500 config.yml \u2190 Main configuration
\n\u251c\u2500\u2500 messages.yml \u2190 All messages
\n\u2514\u2500\u2500 data\/
\n \u251c\u2500\u2500 blocks.yml \u2190 Bounce block data
\n \u251c\u2500\u2500 presets.yml \u2190 Preset templates
\n \u2514\u2500\u2500 players.yml \u2190 Player preferences and stats
\n“`<\/p>\n
**Step 4: Verify Installation**
\n“`
\nCheck console for startup message:<\/p>\n
[BouncePads] ========================================
\n[BouncePads] BouncePads v1.0.0
\n[BouncePads] Server: Paper 1.21.1
\n[BouncePads] Bounce Blocks: 2
\n[BouncePads] Presets: 8
\n[BouncePads] Loaded in 45ms
\n[BouncePads] ========================================
\n“`<\/p>\n
**Step 5: Configure and Add Blocks**
\n“`
\nUse in-game commands to add bounce blocks:
\n\/bp add slime_block 1.5
\n\/bp add emerald_block 3.0<\/p>\n
Or edit config files and reload:
\n\/bp reload
\n“`<\/p>\n
Upgrading<\/p>\n
“`
\n1. Stop your server (recommended) or use \/bp reload after replacing
\n2. Replace the old JAR with the new version
\n3. Start your server
\n4. Check console for any migration messages
\n5. All data and configurations are preserved automatically
\n“`<\/p>\n
—<\/p>\n
Quick Start Guide<\/p>\n
Your First Bounce Pad (30 seconds)<\/p>\n
“`bash
\n Step 1: Add a slime block as a bounce pad with velocity 1.5
\n\/bp add slime_block 1.5<\/p>\n
Step 2: Place a slime block anywhere in your world<\/p>\n
Step 3: Step on it and bounce!
\n“`<\/p>\n
Setting Up Multiple Blocks with Different Powers<\/p>\n
“`bash
\n Low bounce – for subtle movement
\n\/bp add honey_block 0.8<\/p>\n
Medium bounce – standard jump pad
\n\/bp add slime_block 1.5<\/p>\n
High bounce – significant height
\n\/bp add emerald_block 2.5<\/p>\n
Super launch – extreme height
\n\/bp add diamond_block 4.0<\/p>\n
Directional launch – forward momentum
\n\/bp add gold_block 2.0
\n\/bp set gold_block direction player_facing
\n\/bp set gold_block horizontal 1.5
\n“`<\/p>\n
Velocity Reference Guide<\/p>\n
| Velocity | Approximate Height | Best For |
\n|———-|——————-|———-|
\n| 0.5 | ~1.5 blocks | Small hop, decoration |
\n| 0.8 | ~2.5 blocks | Gentle bounce, lobby |
\n| 1.0 | ~3 blocks | Short jump, parkour |
\n| 1.5 | ~5 blocks | Standard jump pad |
\n| 2.0 | ~8 blocks | High jump, FFA |
\n| 2.5 | ~12 blocks | Very high jump |
\n| 3.0 | ~18 blocks | Extreme jump, BedWars |
\n| 4.0 | ~25+ blocks | Launch pad, SkyWars |
\n| 5.0+ | ~35+ blocks | Cannon-style launch |<\/p>\n
Using Presets<\/p>\n
“`bash
\n View available presets
\n\/bp preset list<\/p>\n
Apply a preset to a block
\n\/bp preset apply slime_block super_launch<\/p>\n
Save your custom block as a preset
\n\/bp preset save my_custom_pad emerald_block<\/p>\n
Apply your custom preset to another block
\n\/bp preset apply gold_block my_custom_pad
\n“`<\/p>\n
Built-in Presets<\/p>\n
| Preset Name | Velocity | Horizontal | Direction | Description |
\n|————-|———-|————|———–|————-|
\n| `small_hop` | 0.8 | 0.0 | Vertical | Subtle movement |
\n| `medium_jump` | 1.5 | 0.0 | Vertical | General purpose |
\n| `high_launch` | 2.5 | 0.0 | Vertical | Significant height |
\n| `super_launch` | 4.0 | 0.0 | Vertical | Extreme height |
\n| `directional_push` | 1.0 | 1.5 | Player Facing | Forward momentum |
\n| `elytra_launcher` | 3.0 | 2.0 | Player Facing | Elytra takeoff |
\n| `slime_authentic` | 1.2 | 0.0 | Vertical | Realistic slime feel |
\n| `trampoline` | 1.0 | 0.0 | Vertical | Continuous bouncing |<\/p>\n
Using the GUI<\/p>\n
“`bash
\n Open the main management GUI
\n\/bp gui<\/p>\n
The GUI provides:
\n – Block List: View and edit all configured blocks
\n – Presets: Browse and apply presets
\n – Settings: Toggle your personal preferences
\n – Statistics: View bounce statistics
\n – Reload: Reload configuration
\n“`<\/p>\n
—<\/p>\n
Activation Modes<\/p>\n
Mode Overview<\/p>\n
BouncePads supports three activation modes that determine how players trigger bounce pads. Each block can have its own mode, or you can set a global default.<\/p>\n
| Mode | Trigger Method | Best For |
\n|——|—————|———-|
\n| **DIRECT** | Step directly on the block | FFA, PvP arenas, fast response |
\n| **PRESSURE_PLATE** | Step on pressure plate above block | BedWars, controlled activation |
\n| **HYBRID** | Either method works | Flexible setups, mixed maps |<\/p>\n
DIRECT Mode<\/p>\n
“`
\nPlayers bounce immediately when stepping on the configured block.
\nNo pressure plate needed. Fastest response time.<\/p>\n
Player
\n \u2193
\n [Bounce Block] \u2190 Player steps here, bounces immediately
\n“`<\/p>\n
**Setup:**
\n“`bash
\n\/bp add slime_block 1.5
\n\/bp set slime_block mode direct
\n“`<\/p>\n
PRESSURE_PLATE Mode<\/p>\n
“`
\nRequires a pressure plate placed on top of the bounce block.
\nPlayers only bounce when the pressure plate is triggered.<\/p>\n
Player
\n \u2193
\n [Pressure Plate] \u2190 Player steps here
\n [Bounce Block] \u2190 This provides the bounce
\n“`<\/p>\n
**Setup:**
\n“`bash
\n\/bp add iron_block 2.0
\n\/bp set iron_block mode pressure_plate<\/p>\n
Then place a pressure plate on top of the iron block in-game
\n“`<\/p>\n
HYBRID Mode<\/p>\n
“`
\nBoth direct stepping and pressure plates work.
\nMost flexible option.<\/p>\n
Player Player
\n \u2193 \u2193
\n [Bounce Block] [Pressure Plate]
\n [Bounce Block]<\/p>\n
Both trigger the bounce!
\n“`<\/p>\n
**Setup:**
\n“`bash
\n\/bp add gold_block 1.5
\n\/bp set gold_block mode hybrid
\n“`<\/p>\n
Setting Global Mode<\/p>\n
“`bash
\n Set default mode for ALL blocks
\n\/bp mode direct
\n\/bp mode pressure_plate
\n\/bp mode hybrid
\n“`<\/p>\n
Per-World Mode Override<\/p>\n
“`yaml
\n In config.yml
\nworld-restrictions:
\n world-modes:
\n pvp_arena: DIRECT
\n bedwars: PRESSURE_PLATE
\n lobby: HYBRID
\n“`<\/p>\n
Pressure Plate Multipliers<\/p>\n
Different pressure plate types can apply different velocity multipliers.<\/p>\n
| Plate Type | Default Multiplier | Effect |
\n|———–|——————-|——–|
\n| All Wood Plates | 1.0x | Standard bounce |
\n| Stone Plate | 1.2x | 20% stronger |
\n| Polished Blackstone | 1.2x | 20% stronger |
\n| Light Weighted (Gold) | 1.5x | 50% stronger |
\n| Heavy Weighted (Iron) | 2.0x | Double power |<\/p>\n
**Example:** Block velocity 2.0 + Heavy Weighted Plate = 2.0 \u00d7 2.0 = **4.0 actual velocity**<\/p>\n
Restricting Plate Types Per Block<\/p>\n
“`bash
\n Only allow stone and heavy weighted plates on this block
\n (Set in blocks.yml manually)
\n“`<\/p>\n
“`yaml
\n In data\/blocks.yml
\nIRON_BLOCK:
\n mode: PRESSURE_PLATE
\n allowed-plates:
\n – STONE_PRESSURE_PLATE
\n – HEAVY_WEIGHTED_PRESSURE_PLATE
\n“`<\/p>\n
—<\/p>\n
Commands Reference<\/p>\n
Main Command<\/p>\n
“`
\n\/bouncepad (aliases: \/bounce, \/bp, \/jumppad, \/launchpad)
\n“`<\/p>\n
Block Management Commands<\/p>\n
| Command | Description | Permission | **Examples:** Remove a block List all blocks View detailed info Block Setting Commands<\/p>\n | Command | Value Type | Example | Global Settings Commands<\/p>\n | Command | Description | Permission | Player Commands<\/p>\n | Command | Description | Permission | World Management Commands<\/p>\n | Command | Description | Permission | **Examples:** Block bouncing in specific worlds Show current configuration Preset Commands<\/p>\n | Command | Description | Permission | **Examples:** Apply built-in preset Save current block configuration as custom preset Apply custom preset to another block Delete a custom preset Information Commands<\/p>\n | Command | Description | Permission | —<\/p>\n Permissions Reference<\/p>\n User Permissions<\/p>\n | Permission | Description | Default | Admin Permissions<\/p>\n | Permission | Description | Default | Bypass Permissions<\/p>\n | Permission | Description | Default | Block-Specific Permissions<\/p>\n “` Examples: Set per-block permission requirement: Wildcard<\/p>\n | Permission | Description | Default | Permission Setup Examples<\/p>\n **LuckPerms \u2014 Give all players access to basic bouncing:** **LuckPerms \u2014 VIP gets bypass cooldowns:** **LuckPerms \u2014 Admin gets everything:** blocks.yml \u2014 Block Configuration<\/p>\n Each bounce block entry supports these settings:<\/p>\n PlaceholderAPI Support<\/p>\n Requirements Available Placeholders<\/p>\n | Placeholder | Description | Example Output | Block-Specific Bounce Placeholders<\/p>\n “` Usage Examples<\/p>\n **Scoreboard (using any scoreboard plugin):** **Tab List:** **Chat Format:** FAQ<\/p>\n General Questions<\/p>\n **Q: What versions does BouncePads support?** **Q: Does it work with Folia?** **Q: Is there a block type limit?** **Q: Does it affect server performance?** **Q: Can I use any block as a bounce pad?** Configuration Questions<\/p>\n **Q: Can I have different velocities for different worlds?** **Q: Can I make a block only work with specific pressure plates?** **Q: Can I have different activation modes in different worlds?** **Q: How do I change all messages?** Gameplay Questions<\/p>\n **Q: Do mobs trigger bounce pads?** **Q: Can players bypass cooldowns?** **Q: Does the plugin use Jump Boost potion effect?** **Q: Can I disable fall damage from bounces?** **Q: Can players disable bouncing for themselves?** Technical Questions<\/p>\n **Q: Can other plugins interact with BouncePads?** **Q: How is data stored?** **Q: Can I reload without restarting?** **Q: How do I reset everything?** —<\/p>\n Troubleshooting<\/p>\n Common Issues<\/p>\n Bounce pads not working<\/p>\n “` 2. Check world restrictions: 3. Check block is configured: 4. Check activation mode: 5. Check permissions: 6. Check player toggle: Players taking fall damage after bouncing<\/p>\n “` 2. Check protection duration: 3. Check if cleared on teleport: Sounds or particles not working<\/p>\n “` 2. Check per-block settings: 3. Check player preferences: 4. Check sound\/particle names: GUI not opening<\/p>\n “` 2. Check permission: 3. Try command version instead: Config not reloading<\/p>\n “` 2. Check console for errors: 3. Try regenerating: Debug Mode<\/p>\n Enable debug mode for verbose console output:<\/p>\n “`yaml Then check console for detailed logs about bounce detection, velocity calculations, permission checks, and more.<\/p>\n Performance Issues<\/p>\n “` 1. Increase movement threshold: 2. Increase debounce time: 3. Increase cleanup interval: 4. Reduce particle counts: 5. Disable trails: Getting Help<\/p>\n “` 1. Enable debug mode and reproduce the issue —<\/p>\n Support & Contact<\/p>\n Getting Support<\/p>\n | Channel | Link | Best For | When Reporting Bugs<\/p>\n Please include the following information:<\/p>\n “` Performance Metrics<\/p>\n | Metric | Value | Make bounce blocks and other blocks jump high based on the velocity you input for minigames ….<\/p>\n","protected":false},"featured_media":161519,"template":"","meta":{"_minecraft_slug":"ultimatebounce","_minecraft_project_id":"wDS1a7TM","_minecraft_author":"geturplugins","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":38,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ultimatebounce.zip","_minecraft_size_bytes":142618,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:39:36.322068Z","_minecraft_date_created":"2026-03-24T23:02:27.935520Z","_minecraft_date_modified":"2026-03-22T04:15:02.025542Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ultimatebounce","_minecraft_icon_attachment_id":161519,"_minecraft_imported_at":"2026-06-09T15:30:34+00:00","_minecraft_import_hash":"b2d99181a693dc333b06c8e7159d255b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,129,123,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-161518","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/bp add
\n| `\/bp remove
\n| `\/bp set
\n| `\/bp list [page]` | List all configured blocks | `bouncepad.list` |
\n| `\/bp info
\n“`bash
\n Add blocks
\n\/bp add slime_block 1.5
\n\/bp add emerald_block 3.0 hybrid
\n\/bp add diamond_block 2.0 pressure_plate<\/p>\n
\n\/bp remove emerald_block<\/p>\n
\n\/bp list
\n\/bp list 2<\/p>\n
\n\/bp info slime_block
\n“`<\/p>\n
\n|———|———–|———|
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n| `\/bp set
\n|———|————-|————|
\n| `\/bp mode
\n| `\/bp reload` | Reload all configuration files | `bouncepad.reload` |<\/p>\n
\n|———|————-|————|
\n| `\/bp toggle` | Toggle bouncing on\/off | `bouncepad.toggle` |
\n| `\/bp toggle sounds` | Toggle bounce sounds | `bouncepad.toggle.sounds` |
\n| `\/bp toggle particles` | Toggle bounce particles | `bouncepad.toggle.particles` |
\n| `\/bp toggle all` | Toggle everything | `bouncepad.toggle` |<\/p>\n
\n|———|————-|————|
\n| `\/bp world mode
\n| `\/bp world add
\n| `\/bp world remove
\n| `\/bp world list` | Show world configuration | `bouncepad.world` |<\/p>\n
\n“`bash
\n Only allow bouncing in specific worlds
\n\/bp world mode whitelist
\n\/bp world add pvp_arena
\n\/bp world add bedwars_lobby<\/p>\n
\n\/bp world mode blacklist
\n\/bp world add creative_world<\/p>\n
\n\/bp world list
\n“`<\/p>\n
\n|———|————-|————|
\n| `\/bp preset list` | List all presets | `bouncepad.preset` |
\n| `\/bp preset apply
\n| `\/bp preset save
\n| `\/bp preset delete
\n“`bash
\n List all available presets
\n\/bp preset list<\/p>\n
\n\/bp preset apply slime_block super_launch<\/p>\n
\n\/bp preset save my_launch_pad emerald_block<\/p>\n
\n\/bp preset apply gold_block my_launch_pad<\/p>\n
\n\/bp preset delete my_launch_pad
\n“`<\/p>\n
\n|———|————-|————|
\n| `\/bp stats [player]` | View statistics | `bouncepad.stats` |
\n| `\/bp gui` | Open management GUI | `bouncepad.gui` |
\n| `\/bp help [command]` | Show help | `bouncepad.use` |
\n| `\/bp debug` | Show debug info | `bouncepad.debug` |<\/p>\n
\n|————|————-|———|
\n| `bouncepad.use` | Use bounce pads | `true` |
\n| `bouncepad.toggle` | Toggle personal settings | `true` |
\n| `bouncepad.toggle.sounds` | Toggle sounds | `true` |
\n| `bouncepad.toggle.particles` | Toggle particles | `true` |
\n| `bouncepad.gui` | Open settings GUI | `true` |
\n| `bouncepad.stats` | View own statistics | `true` |<\/p>\n
\n|————|————-|———|
\n| `bouncepad.admin` | All admin permissions (parent node) | `op` |
\n| `bouncepad.add` | Add bounce blocks | `op` |
\n| `bouncepad.remove` | Remove bounce blocks | `op` |
\n| `bouncepad.set` | Modify block settings | `op` |
\n| `bouncepad.list` | List all blocks | `op` |
\n| `bouncepad.info` | View block details | `op` |
\n| `bouncepad.mode` | Change global mode | `op` |
\n| `bouncepad.reload` | Reload configuration | `op` |
\n| `bouncepad.world` | Manage world restrictions | `op` |
\n| `bouncepad.preset` | Manage presets | `op` |
\n| `bouncepad.stats.others` | View other players’ stats | `op` |
\n| `bouncepad.debug` | Use debug commands | `op` |
\n| `bouncepad.gui.admin` | Admin GUI features | `op` |<\/p>\n
\n|————|————-|———|
\n| `bouncepad.bypass` | All bypass permissions (parent node) | `op` |
\n| `bouncepad.bypass.cooldown` | Skip cooldowns | `op` |
\n| `bouncepad.bypass.world` | Ignore world restrictions | `op` |
\n| `bouncepad.bypass.region` | Ignore WorldGuard regions | `op` |
\n| `bouncepad.bypass.permission` | Ignore per-block permissions | `op` |
\n| `bouncepad.bypass.falldamage` | Always have fall protection | `op` |<\/p>\n
\nbouncepad.block.
\n bouncepad.block.slime_block
\n bouncepad.block.emerald_block
\n bouncepad.block.diamond_block
\n“`<\/p>\n
\n“`bash
\n\/bp set slime_block permission bouncepad.block.slime_block
\n“`<\/p>\n
\n|————|————-|———|
\n| `bouncepad.*` | Every BouncePads permission | `op` |<\/p>\n
\n“`bash
\n\/lp group default permission set bouncepad.use true
\n\/lp group default permission set bouncepad.toggle true
\n“`<\/p>\n
\n“`bash
\n\/lp group vip permission set bouncepad.bypass.cooldown true
\n“`<\/p>\n
\n“`bash
\n\/lp group admin permission set bouncepad.* true
\n“`<\/p>\n
\n– PlaceholderAPI plugin installed on your server
\n– `integrations.placeholderapi.enabled: true` in config.yml (default)<\/p>\n
\n|————-|————-|—————|
\n| `%bouncepad_enabled%` | Player’s bounce toggle | `true` |
\n| `%bouncepad_sounds%` | Player’s sound toggle | `true` |
\n| `%bouncepad_particles%` | Player’s particle toggle | `false` |
\n| `%bouncepad_total_blocks%` | Total configured blocks | `5` |
\n| `%bouncepad_total_bounces%` | Player’s total bounces | `1234` |
\n| `%bouncepad_server_bounces%` | Server-wide total bounces | `98765` |
\n| `%bouncepad_cooldown%` | Current cooldown remaining | `2.5s` or `Ready` |
\n| `%bouncepad_last_block%` | Last block bounced on | `SLIME_BLOCK` |
\n| `%bouncepad_world_allowed%` | Current world allows bouncing | `true` |
\n| `%bouncepad_mode%` | Global activation mode | `Direct` |
\n| `%bouncepad_bounces_
\n%bouncepad_bounces_slime_block% \u2192 500
\n%bouncepad_bounces_emerald_block% \u2192 123
\n%bouncepad_bounces_diamond_block% \u2192 42
\n%bouncepad_bounces_gold_block% \u2192 78
\n“`<\/p>\n
\n“`
\n&aBounces: %bouncepad_total_bounces%
\n&eStatus: %bouncepad_enabled%
\n“`<\/p>\n
\n“`
\n&7[&a%bouncepad_total_bounces% bounces&7]
\n“`<\/p>\n
\n“`
\n%bouncepad_total_bounces% bounces | %player_name%
\n“`<\/p>\n
\nA: Paper and Spigot versions 1.21 through 1.21.11. All subversions are fully tested and supported.<\/p>\n
\nA: The current version is designed for Paper\/Spigot. Folia compatibility may be added in a future update.<\/p>\n
\nA: No. You can configure as many different block types as bounce pads as you want.<\/p>\n
\nA: BouncePads is heavily optimized. The movement event handler uses early-exit checks, debouncing, and caching. Most servers report zero measurable TPS change even with 100+ players.<\/p>\n
\nA: Any solid block can be used. Blocks like signs, banners, buttons, and pressure plates themselves cannot be bounce pads (pressure plates go ON TOP of bounce blocks).<\/p>\n
\nA: Yes. Use `world-restrictions.world-multipliers` in config.yml to set per-world velocity multipliers.<\/p>\n
\nA: Yes. Set the `allowed-plates` list for that block in blocks.yml to restrict which plate types trigger it.<\/p>\n
\nA: Yes. Use `world-restrictions.world-modes` in config.yml to override the global mode per world.<\/p>\n
\nA: Every single message is in messages.yml. Edit the file and run `\/bp reload`.<\/p>\n
\nA: In Pressure Plate mode with `player-only: true` (default), mobs cannot trigger bounces. In Direct mode, only player movement is checked.<\/p>\n
\nA: Players with `bouncepad.bypass.cooldown` permission skip all cooldowns.<\/p>\n
\nA: No. BouncePads applies direct velocity to the player, not potion effects. This is smoother and more controllable.<\/p>\n
\nA: Yes. Each block has a `fall-damage-protection` setting. When enabled, players won’t take fall damage after bouncing for a configurable duration.<\/p>\n
\nA: Yes. Players can use `\/bp toggle` to turn bouncing on\/off for themselves without affecting other players.<\/p>\n
\nA: Yes. The plugin provides a complete public API with custom events. Other plugins can add\/remove blocks, bounce players, listen to bounce events, and more.<\/p>\n
\nA: All data is stored in YAML files in the `plugins\/BouncePads\/data\/` folder. No database required.<\/p>\n
\nA: Yes. Use `\/bp reload` to reload all configuration files without server restart.<\/p>\n
\nA: Stop the server, delete the `plugins\/BouncePads\/` folder entirely, and restart. All default files will be regenerated.<\/p>\n
\n1. Check if plugin is enabled:
\n \u2192 Verify “general.enabled: true” in config.yml<\/p>\n
\n \u2192 Run \/bp debug to see if world is allowed
\n \u2192 Check world-restrictions section in config.yml<\/p>\n
\n \u2192 Run \/bp list to see all configured blocks
\n \u2192 Run \/bp info
\n \u2192 If mode is PRESSURE_PLATE, a plate must be on top
\n \u2192 Run \/bp debug to see current mode<\/p>\n
\n \u2192 Player needs bouncepad.use (default: true)
\n \u2192 Check if block has specific permission requirement<\/p>\n
\n \u2192 Player may have disabled bouncing: \/bp toggle
\n \u2192 Run \/bp debug to check bouncing-enabled status
\n“`<\/p>\n
\n1. Check fall damage protection is enabled:
\n \u2192 \/bp info
\n \u2192 Enable: \/bp set
\n \u2192 Default is 5000ms (5 seconds)
\n \u2192 Increase in config.yml: fall-damage.protection-duration<\/p>\n
\n \u2192 config.yml: fall-damage.clear-on-teleport
\n“`<\/p>\n
\n1. Check global toggles:
\n \u2192 config.yml: sounds.enabled and particles.enabled<\/p>\n
\n \u2192 \/bp info
\n \u2192 Player may have toggled off: \/bp toggle sounds<\/p>\n
\n \u2192 Must be valid Minecraft names
\n \u2192 Case-insensitive, but UPPER_CASE recommended
\n“`<\/p>\n
\n1. Check GUI is enabled:
\n \u2192 config.yml: gui.enabled: true<\/p>\n
\n \u2192 Player needs bouncepad.gui<\/p>\n
\n \u2192 \/bp list, \/bp info
\n“`<\/p>\n
\n1. Check YAML syntax:
\n \u2192 Use a YAML validator (yamllint.com)
\n \u2192 Common issues: tabs instead of spaces, missing colons<\/p>\n
\n \u2192 Look for “Failed to reload” messages<\/p>\n
\n \u2192 Delete the problematic file
\n \u2192 Run \/bp reload to regenerate defaults
\n“`<\/p>\n
\n config.yml
\ngeneral:
\n debug: true
\n“`<\/p>\n
\nIf you experience TPS drops:<\/p>\n
\n performance.movement-threshold: 0.2 (default 0.1)<\/p>\n
\n performance.bounce-debounce: 200 (default 100)<\/p>\n
\n performance.cleanup-interval: 2400 (default 1200)<\/p>\n
\n particles.max-per-bounce: 20 (default 50)<\/p>\n
\n particles.show-trail: false
\n“`<\/p>\n
\nIf you can’t resolve your issue:<\/p>\n
\n2. Copy the relevant console output
\n3. Note your server version and plugin version
\n4. List any other plugins that might conflict
\n5. Contact support (see below)
\n“`<\/p>\n
\n|———|——|———-|
\n| **Bug Reports** | https:\/\/discord.gg\/xctckUQukB | Reporting bugs with reproduction steps |
\n| **Feature Requests** | https:\/\/discord.gg\/xctckUQukB | Suggesting new features |
\n| **Discord** | https:\/\/discord.gg\/xctckUQukB | Quick questions, community help |<\/p>\n
\n1. Server software and version (e.g., Paper 1.21.1)
\n2. BouncePads version (e.g., 1.0.0)
\n3. Java version (e.g., Java 21)
\n4. Other plugins installed (plugin list)
\n5. Steps to reproduce the bug
\n6. Expected behavior vs actual behavior
\n7. Console errors (if any)
\n8. config.yml settings (relevant sections)
\n“`<\/p>\n
\n|——–|——-|
\n| Event Processing | < 0.5ms per bounce |\n| Memory Footprint | < 5MB base |\n| TPS Impact | Negligible with 100+ players |\n| Startup Time | < 200ms |\n| JAR Size | ~150KB |\n\n License\n\n```\nARR License \nCopyright (c) 2026 geturplugins\n```\n\n Credits\n\n```\nDeveloper: geturplugins\nTested on: Paper 1.21 - 1.21.11\nBuilt with: Maven, Spigot API, Paper API\nMetrics: bStats\n```\n\n---\n\n**Thank you for using BouncePads!** \ud83c\udf89**\n<\/p>\n","protected":false},"excerpt":{"rendered":"