ojaj.docs|Docs|License

Examples

Every snippet below is copy-paste ready for plugins/OneJumpAllJump/config.yml: keys straight from the shipped default, behavior straight from the source. Run /onejump reload after editing; no restart needed.

Start here: fix your worlds

The shipped config whitelists only the worlds world and spawn. If your main world is named anything else, jumps silently do nothing; this is the single most common "the plugin is broken" report, and the fix is one line:

# The one fix most servers need: name your worlds.
# The default config only whitelists these two worlds.
# If yours are named anything else, nothing will happen.
worlds:
  mode: whitelist
  list:
    - world        # <- your main world's exact folder name
    - spawn

Survival-friendly tuning

For a survival server where people actually built things: turn the random power off, slow the pace down, and make every second jump a coin flip instead of a certainty.

# Survival-friendly: fixed launch power, longer cooldown, 50/50 odds
velocity:
  random:
    enabled: false
  y: 0.65          # a confident hop, not a catapult

cooldown:
  seconds: 5

trigger-chance:
  enabled: true
  chance: 50

trail:
  amount: 3
  duration-ticks: 6

Keep lobbies and minigames safe

Switch the world filter to blacklist and the chaos applies everywhere except the listed worlds, the inverse of the whitelist default.

# Chaos everywhere EXCEPT the lobby and minigames
worlds:
  mode: blacklist
  list:
    - lobby
    - minigames
    - event

fall-damage:
  cancel: true     # keep the soft landings in the survival worlds

Full chaos

Every jump triggers, everyone launches hard, and the sky fills with end-rod sparks. One honest detail from the source: sound keys use the registry's dotted form. The shipped default entity_firework_rocket_launch matches no key and always resolves through the silent fallback to the same firework sound. The dotted form below is the real key.

# The full ojaj experience. We are not responsible for your builds.
trigger-chance:
  enabled: true
  chance: 100

cooldown:
  seconds: 1

velocity:
  random:
    enabled: true
    min: 0.9
    max: 1.4       # exclusive, but who is checking

particles:
  type: end_rod
  amount: 40

trail:
  amount: 10
  duration-ticks: 40

sound:
  type: entity.firework_rocket.launch   # the real registry key
  volume: 1.0
  pitch: 1.4

Custom messages

All message keys support legacy & color codes and the %player% placeholder (the trigger player's name).

# & color codes and %player% work in every message key
actionbar:
  message: '&e%player% made everybody jump!'

titles:
  enabled: true
  title: '&6GLOBAL JUMP'
  subtitle: '&eTriggered by %player%'
  stay: 30

broadcast:
  message: '&e%player% triggered a global jump!'

Everyday commands

All of these need onejump.admin (op by default); see commands & permissions.

/onejump stats    # your personal trigger count (players only, in-memory)
/onejump toggle   # flip the plugin on/off; written back to config.yml
/onejump reload   # re-read config.yml without a restart
/ojaj             # every subcommand also works under the /ojaj alias