ojaj.docs|Docs|License

Configuration

Everything lives in plugins/OneJumpAllJump/config.yml. Reload from disk with /onejump reload; the plugin caches all values on load, so there is no per-jump config lookup.

Full example

# OneJumpAllJump: default config.yml (generated on first run)
enabled: true            # master toggle

cooldown:
  seconds: 2             # per-player trigger cooldown

velocity:
  y: 0.42                # vanilla jump ≈ 0.42
  random:
    enabled: true
    min: 0.35
    max: 1.10            # upper bound is exclusive

trigger-chance:
  enabled: false
  chance: 100            # percent (1-100)

fall-damage:
  cancel: true           # cancels fall damage while enabled

particles:
  enabled: true
  type: end_rod          # any Minecraft particle ID
  amount: 25

trail:
  enabled: true
  particle: happy_villager
  amount: 5              # particles per tick
  duration-ticks: 10     # 20 ticks = 1 second

sound:
  enabled: true
  type: entity_firework_rocket_launch
  volume: 1.0
  pitch: 1.2

actionbar:
  enabled: true
  message: '&e%player% made everybody jump!'

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

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

worlds:
  mode: whitelist        # whitelist or blacklist
  list:
    - world
    - spawn

Master toggle

KeyTypeDefaultDescription
enabledbooleantrueMaster switch. When false, no jumps trigger at all. /onejump toggle flips and saves this key.

cooldown

KeyTypeDefaultDescription
cooldown.secondsint2Minimum seconds between trigger attempts per player. Starts even if the odds roll fails.

velocity

KeyTypeDefaultDescription
velocity.ydouble0.42Fixed vertical velocity applied to every player. Vanilla jump ≈ 0.42.
velocity.random.enabledbooleantrueGive each player an independent random launch power instead of the fixed value.
velocity.random.mindouble0.35Minimum launch power.
velocity.random.maxdouble1.10Upper bound: exclusive. Values above ~0.9 launch players well above jump height.

trigger-chance

KeyTypeDefaultDescription
trigger-chance.enabledbooleanfalseEnable probability-based triggering.
trigger-chance.chanceint (1–100)100Percent chance a passing jump actually launches the server.

fall-damage

KeyTypeDefaultDescription
fall-damage.cancelbooleantrueCancels fall damage events server-wide (every entity) while enabled, not only plugin-caused falls.

particles

KeyTypeDefaultDescription
particles.enabledbooleantrueSpawn a burst on every launched player.
particles.typeparticle IDend_rodAny Minecraft particle ID (end_rod, flame, cloud, explosion…). Invalid IDs fall back to end_rod.
particles.amountint25Particles per burst.

trail

KeyTypeDefaultDescription
trail.enabledbooleantrueLeave a particle trail behind launched players.
trail.particleparticle IDhappy_villagerTrail particle; invalid IDs fall back to happy_villager.
trail.amountint5Particles spawned every tick.
trail.duration-ticksint10Trail length in ticks (20 ticks = 1 second).

sound

KeyTypeDefaultDescription
sound.enabledbooleantruePlay the synchronized jump sound.
sound.typesound IDentity_firework_rocket_launchAny Minecraft sound ID; invalid IDs fall back to the firework launch.
sound.volumefloat1.0Playback volume.
sound.pitchfloat1.2Playback pitch.

actionbar

KeyTypeDefaultDescription
actionbar.enabledbooleantrueShow the hotbar message on every launch.
actionbar.messagestring'&e%player% made everybody jump!'Supports & color codes and %player%.

titles

KeyTypeDefaultDescription
titles.enabledbooleantrueShow the fullscreen title + subtitle.
titles.titlestring'&6GLOBAL JUMP'Main title line.
titles.subtitlestring'&eTriggered by %player%'Subtitle line.
titles.fadeinint5Fade-in duration in ticks.
titles.stayint30Time on screen in ticks.
titles.fadeoutint10Fade-out duration in ticks.

broadcast

KeyTypeDefaultDescription
broadcast.enabledbooleantrueAnnounce the trigger in chat.
broadcast.messagestring'&e%player% triggered a global jump!'Supports & color codes and %player%.

worlds

KeyTypeDefaultDescription
worlds.modewhitelist | blacklistwhitelistwhitelist: jumps only count in listed worlds. blacklist: jumps count everywhere except listed worlds.
worlds.liststring list[world, spawn]World names as they appear on disk. If your main world is named differently, add it; this is the #1 'nothing happens' cause.

Parsing & fallbacks

  • Particle and sound IDs are matched against the Minecraft registry (NamespacedKey.minecraft(...), lowercase). Unknown names fall back silently; check the server log-free behavior by testing a jump after edits.
  • /onejump toggle writes the new enabled value back to config.yml, so toggling survives restarts.
  • Alpha caveat: keys may be added or renamed between versions; keep a backup of your tuned config.yml.