✨ SCore particles

Score includes many pre-made particles shapes from XParticle library and some custom other.

How to display the particles

The command to display the particle is /score particles

You will have to select a shape and configure correctly the command to achieve to do what you want.

How to remove displayed particles

The command to clear displayed particles is /score clear {player} PARTICLES

General settings for all shapes

Define the spawn point

To define where the shape will be displayed you have two choice, by mentioning directly the location or setting an entity UUID

Using Player/Entity UUID

When you decide to use the entity UUID the shape will follow en Player/Entity if he moves. So it can deform the shape or make a cool effect.

target:{uuid of the target}
/* Example using flat UUID */
target:b33183ad-e9c0-4d48-8eea-f8c9358d3568
/* Example using a placeholder */
target:%player_uuid%

You have to specify an UUID of a player or an entity. The player name doesn't work !

Using a specific location

Using location you are sure that the shape will not be deformed, it will stay static.

location:{world},{x},{y},{z}
/* Example using flat location */
location:world,100,50,500
/* Example using placeholders */
location:%player_world%,%player_x%,%player_y%,%player_z%

Particles definition

Particle type

Define the particle used by the shape. By default it will be the FLAME particle

particle:{the particle type}
/* Example */
particle:CLOUD

List of particles available here: List of Spigot particles

Color

Instead of using particle:{particle name} if you want to use REDSTONE / DUST particles you can directly use the setting color with a custom color.

You can set two colors separated by a , to have a color transition.

color:{color Name}
/* Example one color */
color:RED
/* Example two colors with transition */
color:AQUA,BLUE

Block particles

Instead of using particle:{particle name} if you want to use BLOCK_CRACK / BLOCK particles you can directly use the setting blockdata with a material.

blockdata:{material}
/* Example */
blockdata:LAVA

Item particles

Instead of using particle:{particle name} if you want to use ITEM_CRACK/ ITEM particles you can directly use the setting itemstack with a material.

itemstack:{material}
/* Example */
itemstack:DIAMOND_SHOVEL

Offset / Shift the spawn point of the shape

You can define an offset in a specific direction, it allows you for example to display the shape around the player / entity, without having to do complex calculation.

offsetPitch: the pitch direction where the offset will be directed
offsetYaw: the yaw direction where the offset will be directed
offsetSitance: the distance of the offset
offsetX: Increase the offset X location
offsetY: Increase the offset Y location
offsetZ: Increase the offset Z location

By default these settings are set to 0

offsetPitch:{the pitch direction}
offsetYaw:{the yaw direction}
offsetDistance:{the distance}
offsetX:{x bonus}
offsetY:{y bonus}
offsetZ:{z bonus}
/* Example with flat values */
offsetPitch:0
offsetYaw:-90
offsetDistance:5
offsetY:-1
/* Example with placeholders */
offsetPitch:%player_pitch_initial%+30
offsetYaw:%player_yaw_initial%
offsetDistance:%var_myvar%

Settings of the shapes

Atom

Creates a set of elliptical orbits with a small particle sphere at the center, resembling an atom.

orbits: Number of elliptical orbits.
radius: Radius of the orbits in blocks
rate: Number of particles per orbit.

# Examples that you can run manually in-game
/score particles shape:atom color:BLUE,YELLOW orbits:4 radius:5.0 rate:100 offsetY:1
/score particles shape:atom particle:CLOUD orbits:10 radius:20.5 rate:100 offsetY:1
# Examples that you can include into your commands

Atomic

Animated version of atom with orbiting particles.

orbits: Number of orbiting paths.
radius: Radius of orbit in blocks.
rate: Rate of orbit.
time: Duration in ticks.

# Examples that you can run manually in-game
/score particles shape:atomic orbits:15 radius:5 rate:100 offsetY:1 time:200

# Examples that you can include into your commands

BlackSun

Multiple concentric circles increasing in size.

radius: Max radius in blocks.
radiusRate: Difference in radius between each circle.
rate: Particle density.
rateChange: Change of rate per layer.

# Examples that you can run manually in-game
/score particles shape:blacksun radius:10 radiusRate:0.5 rate:200 rateChange:10

# Examples that you can include into your commands

BlackHole

A dynamic particle vortex effect.

points: Number of spiral arms.
radius: Distance from center.
rate: Rotation rate.
mode: 0 to 4 for different vortex styles.
time: Duration in ticks.

# Examples that you can run manually in-game
/score particles particle:SMOKE shape:blackhole points:30 radius:2.5 rate:1 mode:2 time:50

# Examples that you can include into your commands

ChaoticDoublePendulum

Simulates a chaotic double pendulum effect.

radius: Swing radius.
gravity: Gravity force (typically -1).
length, length2: Lengths of the pendulums.
mass1, mass2: Mass of each pendulum.
dimension3: Whether to use 3D rotation.
speed: Animation speed.
time: Duration in ticks.

# Examples that you can run manually in-game
/score particles shape:chaoticDoublePendulum radius:2 gravity:-1 length:200 length2:200 mass1:50 mass2:50 dimension3:false speed:2 time:200
/score particles shape:chaoticDoublePendulum color:RED,YELLOW radius:1 gravity:-1 length:200 length2:2000 mass1:50 mass2:50 dimension3:true speed:2 time:200
/score particles shape:chaoticDoublePendulum particle:FLAME radius:2 gravity:5 length:200 length2:200 mass1:50 mass2:50 dimension3:false speed:2 time:200
# Examples that you can include into your commands

Circle

Displays a circle of particles.

radius: radius of the circle
density: number of particles per block (higher = more dense).
drawMode: clockWise, counterClockWise, random
fillMode: disk, spiral, ring
time: time in ticks to animate the full display. (0 = instant)
directionPitch: pitch direction of the circle
directionYaw: yaw direction of the circle

Examples:

# Examples that you can include into your commands
# Display multiple Green circles in front the player
commands:
- FOR [+20,-20,+40,-40,+60,-60,+80,-80,+100,-100] > for3
- score particles shape:circle location:%player_world_initial%,%player_x_initial%,%player_y_initial%,%player_z_initial% color:GREEN,WHITE radius:3 density:100 time:10 drawMode:clockwise offsetDistance:8 offsetPitch:0 offsetYaw:%player_yaw_initial%%for3%  directionYaw:%player_yaw_initial%%for3% fillMode:disk directionPitch:-90 offsetY:-1
- END_FOR for3

CircularBeam

Animated beam with changing circle sizes over time.

maxRadius: Max circle radius in blocks.
rate: Point rate per circle.
radiusRate: Change in radius.
extend: Extension distance in blocks.
time: Duration in ticks.

# Examples that you can run manually in-game
/score particles shape:circularBeam color:PURPLE maxRadius:5 rate:500 radiusRate:15 extend:1 time:100

# Examples that you can include into your commands

Cone

Cone made of stacked circles.

height: Height of the cone.
radius: Base radius.
rate: Circle spacing.
circleRate: Points density.
fillMode: the fill Mode "disk", "ring", "spiral", by default its disk

# Examples that you can run manually in-game
/score particles shape:cone color:GREEN,YELLOW height:3 radius:2 rate:0.4 circleRate:40 fillMode:ring

# Examples that you can include into your commands

Crescent

Renders a crescent moon using two overlapping circles.

radius: size of the outer arc.
rate: resolution of the curve.
directionYaw: direction of the crescent in degrees

# Examples that you can run manually in-game
/score particles shape:crescent radius:3 rate:100 directionYaw:90 color:RED,YELLOW

# Examples that you can include into your commands

Cylinder

radius: radius of the cylinder
height: the height of the cylinder
density: number of particles per block (higher = more dense).
drawMode: clockWise, counterClockWise, random
timeToDisplay: time in ticks to animate the full display.
directionPitch: pitch direction of the square
directionYaw: yaw direction of the square

Examples:

# Examples that you can include into your commands
# Display two green cylinder in front of the player
- FOR [+20,-20] > for3
- score particles shape:cylinder location:%player_world_initial%,%player_x_initial%,%player_y_initial%,%player_z_initial% color:GREEN,WHITE radius:1 density:100 timeToDisplay:5 drawMode:clockwise offsetDistance:8 offsetPitch:0 offsetYaw:%player_yaw_initial%%for3%  directionYaw:%player_yaw_initial%%for3% directionPitch:-90 offsetY:-1 height:3
- END_FOR for3

Diamond

Creates a diamond (rhombus) shape in 2D or 3D.

radiusRate: Controls the width.
rate: Spacing between points.
height: Total height.

# Examples that you can run manually in-game
/score particles shape:diamond color:BLUE,AQUA radiusRate:0.6 rate:0.4 height:3

# Examples that you can include into your commands

DNA

Displays a DNA double helix with hydrogen bonds.

radius: Radius of the helices.
rate: Spacing between points.
extension: Helix stretch factor.
height: Total height.

# Examples that you can run manually in-game
/score particles shape:dna color:BLUE,AQUA radius:10 rate:0.1 height:4 extension:15

# Examples that you can include into your commands

DNA Replication

Simulates DNA replication with bonds and colors.

radius, rate, extension, height: Same as DNA.
speed: Animation speed.
hydrogenBondDist: Distance between bonds.

# Examples that you can run manually in-game
/score particles shape:dnaReplication color:BLUE,AQUA radius:4 rate:0.2 height:3 extension:5 hydrogenBondDist:1 speed:1

# Examples that you can include into your commands

Ellipse

start, end: Start and end angles.
rate: Angular spacing.
radius, otherRadius: X and Y radii.

# Examples that you can run manually in-game
/score particles shape:ellipse color:BLUE,AQUA radius:3 rate:0.8 otherRadius:2 start:50 end:200 offsetY:1

# Examples that you can include into your commands

ExplosionWave

Wavy animation representing an explosion shockwave.

rate: Particle density within the wave.
start: the initial distance from the center to start the wave.
height: the vertical amplitude of the wave.

# Examples that you can run manually in-game
/score particles shape:explosionWave rate:5 start:-3 height:3
/score particles shape:explosionWave rate:5 height:1 offsetY:-1
/score particles shape:explosionWave rate:10
# Examples that you can include into your commands

Eye

Draws an oval eye-like shape.

radius, radius2: Primary radii.
rate: Resolution.
extension: Elongation factor
directionPitch: pitch direction of the eye
directionYaw: yaw direction of the eye

# Examples that you can run manually in-game
/score particles shape:eye particle:INFESTED radius:2 radius2:2 extension:1 rate:100 directionYaw:-164

# Examples that you can include into your commands

Heart

Draws a heart using a polar curve.

cut, cutAngle: Adjust the heart’s lobes.
depth: Central notch depth.
compressHeight: Vertical compression.
rate: Resolution.
directionPitch: pitch direction of the heart
directionYaw: yaw direction of the heart

# Examples that you can run manually in-game
/score particles shape:heart particle:HEART cut:4 cutAngle:2 depth:2 compressHeight:1 rate:100 offsetY:-1 directionYaw:-75

# Examples that you can include into your commands

Helix

Draws animated 3D helices.

strings: Number of helices.
radius: Helix radius.
rate, extension: Spacing and spiral strength.
height: Total height.
speed: Animation speed.
fadeUp, fadeDown: Gradual change in radius.

# Examples that you can run manually in-game
/score particles shape:helix particle:TOTEM_OF_UNDYING strings:3 radius:2.5 rate:0.1 extension:2 height:3 speed:2 fadeUp:true fadeDown:true

# Examples that you can include into your commands

Illuminati

Creates a 3D infinity symbol shape.

size: Size of the shape.
extension: The extension of the illuminati eye.

# Examples that you can run manually in-game
/score particles shape:illuminati particle:SCULK_SOUL size:5 extension:15

# Examples that you can include into your commands

Infinity

MagicCircles

Displays expanding rings like magical glyphs.

radius: Initial radius.
rate: Point spacing.
radiusRate: Growth speed.
distance: Spacing between rings.
time: Duration in ticks.

# Examples that you can run manually in-game
/score particles shape:magicCircles radius:1 rate:3 radiusRate:1 time:20

# Examples that you can include into your command

MeguminExplosion

Stylized magical explosion effect.

size: Overall explosion size.

# Examples that you can run manually in-game
/score particles shape:meguminExplosion color:RED size:5

# Examples that you can include into your commands

Polygon

Draws a polygon with optional internal connections

points: Number of corners.
connection: How many corners to connect.
size: Radius of the polygon.
rate: Resolution.
extend: Connection extension factor.

# Examples that you can run manually in-game
/score particles shape:polygon points:5 connection:5 size:5 rate:1 extend:1

# Examples that you can include into your commands

Rainbow

Displays stacked rainbow arcs with colored layers.

radius: Radius of the rainbow
rate: Rate of points more = more points
curve: Curve 1 for up and -1 for down
layers: Number of arcs.
compact: Reduces spacing between arcs.

# Examples that you can run manually in-game
/score particles shape:rainbow radius:3 rate:100 curve:2 layers:1 compact:1

# Examples that you can include into your commands

Ring

Draws a flat ring (annulus).

radius: Radius of the ring.
density: Particle density.
time: Durationto display in ticks.
drawMode: Drawing order : clockWise, counterClockWise or random
directionPitch: pitch direction of the circle
directionYaw: yaw direction of the circle

# Examples that you can run manually in-game
/score particles particle:SONIC_BOOM shape:ring radius:5 density:100 time:0

# Examples that you can include into your commands

Sphere

Draws a full 3D sphere.

radius: Sphere radius.
rate: Density of points

# Examples that you can run manually in-game
/score particles particle:SNEEZE shape:sphere radius:5 rate:30

# Examples that you can include into your commands

SpikeSphere

Draws a sphere with random spikes.

radius, rate: Base sphere parameters.
chance: Chance of spike.
minRandomDistance, maxRandomDistance: Spike length range.

# Examples that you can run manually in-game
/score particles particle:GLOW shape:spikeSphere radius:4 rate:20 chance:30 minRandomDistance:2 maxRandomDistance:4

# Examples that you can include into your commands

Square

height: height in blocks along vertical axis.
length: length in blocks along direction vector.
width: width in blocks perpendicular to the wall direction.
density: number of particles per block (higher = more dense).
timeToDisplay: time in ticks to animate the full display.
drawMode: "vertical" or "horizontal" — controls iteration order.
verticalOrder: "up" or "down" — order along height.
horizontalOrder: "near" or "far" — order along length.
directionPitch: pitch direction of the square
directionYaw: yaw direction of the square

# Examples that you can run manually in-game
...

# Examples that you can include into your commands
commands:
# A line of explosion
- score particles shape:square location:%player_world_initial%,%player_x_initial%,%player_y_initial%,%player_z_initial% particle:EXPLOSION height:1 length:30 timeToDisplay:20 density:1 directionYaw:%player_yaw_initial% directionPitch:%player_pitch_initial% verticalOrder:up horizontalOrder:near offsetY:-1
# A wall of flame
- score particles shape:square location:%player_world_initial%,%player_x_initial%,%player_y

Star

Creates a 3D star with animated spikes.

points: Number of base sides.
spikes: Number of star tips.
rate: How many display of points
spikeLength: Tip length.
coreRadius: Core radius.
neuron: Tip curvature.
prototype: Use helices instead of lines.
speed: Animation speed.

# Examples that you can run manually in-game
/score particles shape:star points:5 spikes:5 rate:20 spikeLength:20 coreRadius:4 speed:1 neuron:3

# Examples that you can include into your commands

Tesseract

Draws tesseract

size: Overall size.
rate: Density.
speed: speed.
time: Display time.

# Examples that you can run manually in-game
/score particles shape:tesseract size:3 rate:100 speed:2 time:200 offsetY:2 particle:END_ROD

# Examples that you can include into your commands

Vortex

Spiral effect like a galaxy or tornado.

points: Number of spiral arms.
rate: Rotation speed.
time: Duration.

# Examples that you can run manually in-game
/score particles shape:vortex particle:ENCHANT points:5 rate:25 time:100 offsetY:2

# Examples that you can include into your commands

PreviousPlaceholders Next🧮 SCore Variables

Last updated 1 month ago