BhopPlugin

A lightweight bunny hop plugin for Paper servers that preserves and amplifies player momentum across jumps.

Features

• Smooth momentum accumulation on consecutive jumps
• Configurable speed boost and speed cap
• Permission-based access control
• Momentum resets on water contact or standing still for too long
• No external dependencies

Requirements

• Paper 1.21+
• Java 21+

Installation

1. Download the latest .jar from the releases page
2. Drop it into your server's plugins/ folder
3. Restart the server
4. Configure plugins/BhopPlugin/config.yml to your liking

Configuration

bhop:
  # Multiplier applied to the player's speed on each jump.
  # Higher values = faster acceleration. Recommended: 1.1 - 1.5
  speed-boost: 1.28

  # Maximum horizontal speed a player can reach (in blocks/tick).
  # Vanilla sprint speed is roughly 0.28. Default cap is ~4.5x that.
  max-speed: 4.5

  # Enable debug logging in console (for development only).
  debug: false

Permissions

Permission	Description	Default
bhop.use	Allows the player to use bhop	false
bhop.reload	Allows reloading the config	op

To give all players access via LuckPerms:

/lp group default permission set bhop.use true

Commands

Command	Description	Permission
/bhopreload	Reloads the plugin config	bhop.reload

How it works

When a player jumps, their current stored speed is multiplied by speed-boost and capped at max-speed. This new speed is then applied to their horizontal velocity, preserving direction. Momentum is lost if the player stands on the ground for more than 500ms or enters water.

License

MIT