Skip to main content

Advanced Actions

EasyMenu 7 provides powerful flow control actions, including non-blocking delays, coordinate teleports, potion effects, and interactive user prompts.

Delay (type: delay)​

Pauses pipeline execution for a specified duration before proceeding.

EasyMenu delays are managed asynchronously using Folia schedulers and never sleep or block server threads.

actions:
  - type: message
    message: "&eTeleporting in 3 seconds. Please do not move..."
  - type: sound
    sound: "BLOCK_NOTE_BLOCK_HAT"
  - type: delay
    duration: 3s # e.g. 500ms, 3s, 1m
  - type: teleport
    world: "world"
    x: 100.5
    y: 64.0
    z: -200.5
  - type: message
    message: "&aTeleported!"

Teleport (type: teleport)​

Teleports the player to a target world and coordinates.

actions:
  - type: teleport
    world: "world_nether"  # World name
    x: 0.5                 # X coordinate (placeholders supported)
    y: 70.0                # Y coordinate
    z: 0.5                 # Z coordinate
    yaw: 90.0              # Horizontal angle (optional)
    pitch: 0.0             # Vertical pitch (optional)
    safe: true             # Find safe landing spot (default: true)
    reset-velocity: true   # Reset momentum/fall velocity (default: true)
    no-fall-ticks: 40      # Invulnerability ticks against fall damage (default: 40)

Potion Effects (type: potion-effect)​

Applies a status effect or buff to the player for a set duration.

actions:
  - type: potion-effect
    effect: "SPEED"   # PotionEffectType enum
    duration: 30s     # Duration (e.g. 10s, 1m)
    amplifier: 1      # Amplifier (0 = Lv1, 1 = Lv2)
    ambient: true     # Ambient beacon particle style
    particles: true   # Show particles

In-Action Chat Input (type: input)​

Prompts the player to enter a value in chat before completing the command sequence.

actions:
  - type: input
    prompt: "&eEnter withdrawal amount (1 to 100,000) in chat:"
    input-type: integer # text, integer, decimal, boolean
    min: 1
    max: 100000
    timeout-seconds: 30 # Timeout limit in seconds
    command: "bank withdraw {player} {input}"

:::tip Menu-Level Form Inputs EasyMenu 7 also features a menu-wide Inputs system that renders as real text boxes and sliders in Native Dialogs! :::