xokz's Particle Effects

Functions:

xze:fx/lightning/spawn_with {...} | Spawns a lightning-shaped bolt of particles

• particle: String | Particle the lightning is drawn with
• Must be run at the starting point, and as the entity to move towards
  • To target a location instead, spawn a marker there and run as that

Examples:

execute positioned ~ ~1 ~ as @p run function xze:fx/lightning/spawn_with {particle:"minecraft:electric_spark"}

• Put this in a repeating command block and see what happens

TPS Impact: Low

Functions:

xze:fx/spiral/spawn_with {...} | Draws a columnal spiral between the origin point and target entity

• particle: String | Particle the spiral is drawn with
• radius: Number | Radius of the spiral, in blocks
• period: Number | Distance required for the spiral to complete a full rotation, in blocks
• angle: Number | The starting rotation angle of the spiral, in radians. If unsure, use 0
• Must be run at the origin point, and as the entity to move towards
  • To target a location instead, spawn a marker there and run as that

Examples:

execute positioned ~ ~1 ~ as @p run function xze:fx/spiral/spawn_with {particle:"minecraft:electric_spark",radius:0.8,period:2,angle:0}

• Put this in a repeating command block

Notes:

• Increase the gamerule max_command_sequence_length to a larger number like 1000000, otherwise the spiral may get cut off

TPS Impact: Medium

• Depends how long the spiral is and how frequently it is being spawned

Functions:

function xze:fx/circle/spawn_with {...} | Draws a circle perpendicular to the context direction

• particle: String | Particle the circle is drawn with
• radius: Number | Radius of the circle, in blocks

Examples:

/execute anchored eyes positioned ^ ^ ^5 run function xze:fx/circle/spawn_with {particle:"minecraft:end_rod",radius:2.5}

TPS Impact: None

Functions:

xze:fx/sphere/spawn_with {...} | Draws a sphere

• particle: String | Particle the sphere is drawn with
• radius: Number | Radius of the sphere, in blocks

Examples:

/execute anchored eyes positioned ^ ^ ^8 run function xze:fx/sphere/spawn_with {particle:"minecraft:end_rod",radius:4}

TPS Impact: Very Low

• Very large spheres (radius >=16) may have a multi ms impact, as they run many particle commands

Functions:

xze:fx/line/spawn_with {...} | Draws a line between the context position and the context entity

• particle: String | Particle the line is drawn with
• Must be run at the origin point, and as the entity to move towards
  • To target a location instead, spawn a marker there and run as that

Examples:

execute positioned ~ ~1 ~ as @p run function xze:fx/line/spawn_with {particle:"minecraft:electric_spark"}

• Put this in a repeating command block

TPS Impact: Very Low

Functions:

function xze:fx/block_edges_moving/spawn_with {...} | Spawns particles that briefly move along the edge of a block

• particle: String | Particles that are spawned

Examples:

/execute anchored eyes positioned ^ ^ ^4 run function xze:fx/block_edges_moving/spawn_with {particle:"minecraft:end_rod"}

Notes:

• Automatically snaps to the block grid, no need to manually align

TPS Impact: None

Functions:

function xze:fx/block_verticies/spawn_with {...} | Draws a particle on the 8 corners of a block

• particle: String | Particles that are spawned

Examples:

/execute anchored eyes positioned ^ ^ ^4 run function xze:fx/block_verticies/spawn_with {particle:"minecraft:end_rod"}

Notes:

• Automatically snaps to the block grid

TPS Impact: None

xze:marker/spawn | Spawns the marker at the context location. If the marker is already spawned, teleports it there instead

xze:marker/delete | Deletes the marker via /kill

xze:marker/tp | Teleports the marker to the context location

Every effect takes in a particle argument. This argument typically takes the form of a simple particle name, like "minecraft:flame". However, the macro itself is just the arguments for the /particle command internally, which means that additional arguments can be provided in the field in every effect (except for the moving block outline effect). For example, this can be used to create an expanding sphere, like so:

/execute at @s anchored eyes positioned ^ ^ ^10 run function xze:fx/sphere/spawn_with {particle:"minecraft:end_rod ~ ~ ~ ^ ^ ^100000 0.000002 0 force",radius:4}

• The speed is controlled by the Speed argument, the 0.000002. Very small changes can make big differences.
• The direction is controlled by the last value in the Delta argument, the ^100000. Making this value negative (^-100000) will cause the sphere to contract instead.

Sometimes it may be desired to use a certain particle in an effect, but the given particle persists for too long afterwards. For example, spawning a minecraft:flame lightning bolt would result in the lightning shape lasting for several seconds.

To remedy this, the Delta, Speed, and Count arguments in the particle field can be adjusted to make the particle disappear after a tick. For example:

/execute positioned ~ ~1 ~ as @p run function xze:fx/lightning/spawn_with {particle:"minecraft:flame ~ ~ ~ ^ ^ ^10000 10000 0"}

• Put this in a repeating command block

• This works by making the particle move so fast that they disappear the next tick.