Sueta

BhopPlugin

v1.0.0

Lightweight bunny hop plugin for Paper 1.21+. Configurable speed boost, permission-based access control, and automatic momentum reset.

·Config

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

PermissionDescriptionDefault
bhop.useAllows the player to use bhopfalse
bhop.reloadAllows reloading the config in-gameop

To give all players access via LuckPerms:

/lp group default permission set bhop.use true

Commands

CommandDescriptionPermission
/bhopreloadReloads the plugin configbhop.reload

Compatibility

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

Similar projects

Config →