BhopPlugin

What is BhopPlugin?

BhopPlugin brings bunny hop mechanics to your Paper server, inspired by the movement systems found in games like CS:GO and Source engine titles. Every consecutive jump preserves and amplifies your momentum, rewarding skilled players who time their jumps well and creating a satisfying high-speed movement experience.

---

How it works

When a player jumps, their stored speed is multiplied by the configured speed-boost value and capped at max-speed. This new speed is applied to their horizontal velocity while preserving direction, meaning skilled players can chain jumps to reach high speeds. Momentum is lost if the player stands still for more than 500ms or enters water, keeping the mechanic fair and controllable.

---

Features

• Smooth momentum accumulation across consecutive jumps
• Fully configurable speed boost multiplier and speed cap
• Permission-based access so you control who can bhop
• Automatic momentum reset on water contact or standing still
• In-game config reload without server restart
• No external dependencies — drop in and go

---

Configuration

bhop:
  # Multiplier applied to 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

---

Permissions

Permission	Description	Default
bhop.use	Allows the player to use bhop	false
bhop.reload	Allows reloading the config in-game	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

---

Compatibility

• Paper 1.21+
• Java 21+
• No dependencies required