BetterDoubleJump

A New Minecraft Mechanic for Your Server

BetterDoubleJump introduces a smooth, customizable, and responsive double-jump system designed to enhance any type of server — from Survival and Parkour to RPGs and Minigames. Its highly configurable mechanics, visual effects, and player-driven customization make it a powerful addition to your gameplay experience.

🚀 Features

• Intuitive Double Jump
  A responsive and natural-feeling double jump mechanic.

• Full Customization
  Adjust power and height in config.yml to match your server’s style.

• Particle Effects
  Choose any vanilla particle effect to display on jump.
  Optional trailing effects follow the player mid-air.

• Player Customization
  Players can toggle their own trails and (when allowed) set custom RGB colors for DUST particles.

• Configurable Sounds
  Choose sound type, volume, and pitch for each jump.

• Fully Translatable
  All messages editable via messages.yml with full Hex color support (&#RRGGBB).

💻 Commands & Usage

BetterDoubleJump features a simple and easy-to-learn command system.

/bdj help                  - Shows the help menu with all available commands.
/bdj reload                - Reloads the configuration files (config.yml & messages.yml).
/bdj trail toggle          - Enables or disables your personal particle trail.
/bdj trail color <r,g,b>   - Sets the color of your trail (e.g., /bdj trail color 255,0,0).

🔑 Permissions

Control every aspect of the plugin with a comprehensive set of permissions.

betterdoublejump.use:
  description: Allows the player to use the double jump feature.
  default: true

betterdoublejump.reload:
  description: Allows reloading the plugin's configuration.
  default: op

betterdoublejump.trail.toggle:
  description: Allows the player to toggle their own particle trail.
  default: true

betterdoublejump.trail.color:
  description: Allows the player to set their own particle trail color.
  default: op

⚙️ Configuration

Everything is customizable. Tweak the core mechanics in config.yml and change all text in messages.yml.

config.yml:

double-jump:
  power: 1.2
  height: 1.0

particles:
  type: "CLOUD"
  trail-enabled-by-default: true
  trail-type: "REDSTONE"

sounds:
  enabled: true
  type: "ENTITY_BAT_TAKEOFF"
  volume: 1.0
  pitch: 1.5

messages.yml:

# Hex color codes are supported with the &#RRGGBB format

prefix: "&#4287f5&lBetterDoubleJump "

reload: "%prefix%&#00FF00Configuration reloaded successfully."
no-permission: "%prefix%&#FF0000You do not have permission to execute this command."
player-only: "%prefix%&#FF0000This command can only be executed by a player."
trail-on: "%prefix%&#00FF00Your particle trail has been enabled."
trail-off: "%prefix%&#FFA500Your particle trail has been disabled."
trail-color-set: "%prefix%&#00FF00Trail color set to %color%."
invalid-color: "%prefix%&#FF0000Invalid color format. Use R,G,B (e.g., 255,0,0)."
invalid-particle: "%prefix%&#FF0000The trail particle type cannot be colored."

usage:
  main: "%prefix%&#FFFF00Usage: /bdj <reload|trail>"
  trail: "%prefix%&#FFFF00Usage: /bdj trail <toggle|color <r,g,b>>"

unknown-command: "%prefix%&#FF0000Unknown command. Type &#FFFF00/bdj help&#FF0000 for a list of commands."

help:
  - "&#a9a9a9&m--------------------------------------------------"
  - "%prefix%&7Available Commands:"
  - ""
  - " &f/bdj help &8- &eShows this help screen."
  - " &f/bdj reload &8- &eReloads the plugin configuration."
  - " &f/bdj trail toggle &8- &eToggles your particle trail on or off."
  - " &f/bdj trail color <r,g,b> &8- &eSets the color of your trail."
  - ""
  - "&#a9a9a9&m--------------------------------------------------"