Position System

What Are Positions?

Positions tell actions WHERE to do something. Every visual effect, damage area, and entity spawn needs a position.

The position system is flexible and powerful, supporting:

Predefined positions (trigger, player, target)
Relative movement (forward, left, up)
Custom coordinates
Math offsets
Entity tracking

Position Formats

Predefined Positions

The simplest and most common positions:

{trigger_pos}

Where the enchant was activated.

position: "{trigger_pos}"

What it means:

HIT_MOB: Where you hit the mob
MOB_DEATH: Where the mob died
PASSIVE: Player's location when checked

{player_pos}

The player's current location.

position: "{player_pos}"

{target_pos}

The target mob's location.

position: "{target_pos}"

Only available when:

Enchant was triggered by hitting/killing a mob
A target mob exists

Relative Positions

Move relative to where the player is facing:

Forward/Backward

position: "{forward:5}"    # 5 blocks in front of player
position: "{backward:3}"   # 3 blocks behind player

Distance is in blocks (can be decimal):

position: "{forward:2.5}"  # 2.5 blocks ahead

Left/Right

position: "{left:2}"      # 2 blocks to the left
position: "{right:2}"     # 2 blocks to the right

Based on player's facing direction (not world coordinates).

Up/Down

position: "{up:10}"       # 10 blocks above player
position: "{down:5}"      # 5 blocks below player

Always relative to Y-axis (world up/down).

Examples

Spawn arrow above and in front:

position: "{forward:10}"  # Then manually offset Y in next action

Create circle of particles:

actions:
  1:
    type: "particle-effect"
    position: "{forward:5}"
    particle: "FLAME"
    count: 10
  2:
    type: "particle-effect"
    position: "{right:5}"
    particle: "FLAME"
    count: 10
  3:
    type: "particle-effect"
    position: "{backward:5}"
    particle: "FLAME"
    count: 10
  4:
    type: "particle-effect"
    position: "{left:5}"
    particle: "FLAME"
    count: 10

Custom Coordinates

Specify exact X, Y, Z coordinates:

position: "100, 64, -200"

Format: X, Y, Z (comma-separated, spaces optional)

With Variables

Use coordinate variables:

position: "{player_x}, {player_y}, {player_z}"

This is functionally the same as {player_pos} but lets you modify coordinates:

position: "{player_x}, {player_y} + 5, {player_z}"

Math Offsets

Add or subtract from base positions:

Basic Offset

position: "{trigger_pos} + 0, 5, 0"

Format: {base_pos} + X, Y, Z

This spawns 5 blocks above the trigger position.

Negative Offsets

position: "{player_pos} - 10, 0, 10"

Moves position -10 X and +10 Z from player.

Complex Offsets

position: "{target_pos} + 5, 10, -3"

Moves +5 X, +10 Y, -3 Z from target position.

With Variables

position: "{trigger_pos} + {level}, 5, 0"

X offset increases with enchant level.

Examples

Spawn meteor above target:

type: "spawn-entity"
entity-type: "ARROW"
reference: "meteor"
position: "{target_pos} + 0, 20, 0"

Ring of explosions around hit:

actions:
  1:
    type: "explosion"
    position: "{trigger_pos} + 5, 0, 0"
    power: 2.0
  2:
    type: "explosion"
    position: "{trigger_pos} - 5, 0, 0"
    power: 2.0
  3:
    type: "explosion"
    position: "{trigger_pos} + 0, 0, 5"
    power: 2.0
  4:
    type: "explosion"
    position: "{trigger_pos} + 0, 0, -5"
    power: 2.0

Entity Positions

Track positions of spawned entities:

Basic Usage

actions:
  1:
    type: "spawn-entity"
    entity-type: "ARROW"
    reference: "my_arrow"        # Give it a reference name
    position: "{trigger_pos}"
  2:
    type: "particle-effect"
    position: "{my_arrow:position}"  # Use its position
    particle: "FLAME"
    count: 20

Format: {reference:position}

Multiple Entities

Track multiple entities with different references:

actions:
  1:
    type: "spawn-entity"
    entity-type: "ARROW"
    reference: "arrow1"
    position: "{forward:5}"
  2:
    type: "spawn-entity"
    entity-type: "ARROW"
    reference: "arrow2"
    position: "{forward:10}"
  3:
    type: "delay"
    ticks: 30
  4:
    type: "damage-area"
    position: "{arrow1:position}"
    radius: 3
    damage: 100
  5:
    type: "damage-area"
    position: "{arrow2:position}"
    radius: 3
    damage: 100
  6:
    type: "remove-entity"
    reference: "arrow1"
  7:
    type: "remove-entity"
    reference: "arrow2"

Random Positions

Create random positions using placeholders:

Random Offset

position: "{target_pos} + %phantomdungeons_math_random_-5_5%, 0, %phantomdungeons_math_random_-5_5%"

This creates a position within ±5 blocks of target (X and Z).

Random Height

position: "{trigger_pos} + 0, %phantomdungeons_math_random_10_20%, 0"

Random height between 10-20 blocks above trigger.

Complete Random Position

position: "%phantomdungeons_math_random_-10_10%, %phantomdungeons_math_random_5_15%, %phantomdungeons_math_random_-10_10%"

Random positions are calculated every time the placeholder is used. Use set-variable if you need the same random position multiple times.

With Variables

Store random offset for reuse:

actions:
  1:
    type: "set-variable"
    name: "random_x"
    value: "%phantomdungeons_math_random_-5_5%"
  2:
    type: "set-variable"
    name: "random_z"
    value: "%phantomdungeons_math_random_-5_5%"
  3:
    type: "spawn-entity"
    entity-type: "ARROW"
    reference: "arrow"
    position: "{target_x} + {random_x}, 20, {target_z} + {random_z}"
  4:
    type: "hologram"
    text: "&cIncoming!"
    position: "{target_x} + {random_x}, {target_y} + 3, {target_z} + {random_z}"

Position Patterns

Meteor Strike Pattern

Spawn falling projectiles from above:

type: "spawn-entity"
entity-type: "ARROW"
reference: "meteor"
position: "{target_pos} + %phantomdungeons_math_random_-5_5%, 20, %phantomdungeons_math_random_-5_5%"

Circle Pattern

Create effects in a circle around player:

actions:
  1:
    type: "particle-effect"
    position: "{forward:5}"
    particle: "FLAME"
    count: 20
  2:
    type: "particle-effect"
    position: "{right:5}"
    particle: "FLAME"
    count: 20
  3:
    type: "particle-effect"
    position: "{backward:5}"
    particle: "FLAME"
    count: 20
  4:
    type: "particle-effect"
    position: "{left:5}"
    particle: "FLAME"
    count: 20

Line Pattern

Create a line of effects using loop:

type: "loop"
iterations: 10
tick-interval: 2
actions:
  1:
    type: "particle-effect"
    position: "{forward:{iteration}}"
    particle: "FLAME"
    count: 10

Creates particles at 0, 1, 2, 3...9 blocks ahead.

Vertical Line

type: "loop"
iterations: 10
tick-interval: 1
actions:
  1:
    type: "particle-effect"
    position: "{trigger_x}, {trigger_y} + {iteration}, {trigger_z}"
    particle: "END_ROD"
    count: 5

Creates a vertical beam from trigger position.

Spread Pattern

Random spread around a point:

type: "loop"
iterations: 20
tick-interval: 1
actions:
  1:
    type: "particle-effect"
    position: "{target_pos} + %phantomdungeons_math_random_-3_3%, %phantomdungeons_math_random_0_5%, %phantomdungeons_math_random_-3_3%"
    particle: "EXPLOSION"
    count: 1

Common Use Cases

Effects at Hit Location:

position: "{trigger_pos}"

Effects on Target Mob:

position: "{target_pos}"

Effects Above Target:

position: "{target_pos} + 0, 2, 0"

Sounds at Player:

position: "{player_pos}"

Projectile in Front:

position: "{forward:10}"

Falling from Sky:

position: "{target_pos} + 0, 20, 0"

Ground Effect:

position: "{trigger_x}, {trigger_y}, {trigger_z}"

Or use built-in:

position: "{trigger_pos}"

Track Moving Entity:

# Spawn
position: "{forward:5}"
reference: "projectile"

# Later
position: "{projectile:position}"

Advanced Techniques

Dynamic Radius

Create expanding effect:

type: "loop"
iterations: 5
tick-interval: 5
actions:
  1:
    type: "particle-effect"
    position: "{trigger_pos}"
    particle: "FLAME"
    count: "{iteration} * 20"
    offset-x: "{iteration}"
    offset-y: 0.5
    offset-z: "{iteration}"

Particles spread more each iteration.

Spiral Effect

Combine forward movement with rotation:

type: "loop"
iterations: 20
tick-interval: 1
actions:
  1:
    type: "particle-effect"
    # Complex: requires manual calculation or rotating forward vector
    position: "{forward:{iteration}}"
    particle: "END_ROD"
    count: 5

Follow Player

Keep effect at player position:

type: "loop"
iterations: 10
tick-interval: 5
actions:
  1:
    type: "particle-effect"
    position: "{player_pos}"  # Updates each iteration
    particle: "HEART"
    count: 10

PreviousEnchant Examples NextVariable System

Last updated 1 month ago

hashtagWhat Are Positions?

hashtagPosition Formats

hashtagPredefined Positions

hashtag{trigger_pos}

hashtag{player_pos}

hashtag{target_pos}

hashtagRelative Positions

hashtagForward/Backward

hashtagLeft/Right

hashtagUp/Down

hashtagExamples

hashtagCustom Coordinates

hashtagWith Variables

hashtagMath Offsets

hashtagBasic Offset

hashtagNegative Offsets

hashtagComplex Offsets

hashtagWith Variables

hashtagExamples

hashtagEntity Positions

hashtagBasic Usage

hashtagMultiple Entities

hashtagRandom Positions

hashtagRandom Offset

hashtagRandom Height

hashtagComplete Random Position

hashtagWith Variables

hashtagPosition Patterns

hashtagMeteor Strike Pattern

hashtagCircle Pattern

hashtagLine Pattern

hashtagVertical Line

hashtagSpread Pattern

hashtagCommon Use Cases

hashtagAdvanced Techniques

hashtagDynamic Radius

hashtagSpiral Effect

hashtagFollow Player

What Are Positions?

Position Formats

Predefined Positions

{trigger_pos}

{player_pos}

{target_pos}

Relative Positions

Forward/Backward

Left/Right

Up/Down

Examples

Custom Coordinates

With Variables

Math Offsets

Basic Offset

Negative Offsets

Complex Offsets

With Variables

Examples

Entity Positions

Basic Usage

Multiple Entities

Random Positions

Random Offset

Random Height

Complete Random Position

With Variables

Position Patterns

Meteor Strike Pattern

Circle Pattern

Line Pattern

Vertical Line

Spread Pattern

Common Use Cases

Advanced Techniques

Dynamic Radius

Spiral Effect

Follow Player