Effectlib - yuuwu/MagicSpells GitHub Wiki

Description

Effectlib is an external plugin used with magicspells and various other plugins. It allows you to create complicated effects in your spells. a lot of people have trouble understanding how to create effects because of how it's all layed out, and what everything does and looks like.

Effectlib effects are to be placed under the effects: of a spell, positions work the same aswell.

Download Link: https://dev.bukkit.org/projects/effectlib Magicspells 4.0+ Does not require effectlib to be installed.

Plugin Source: https://github.com/Slikey/EffectLib

Configuration

General Configuration:

Option	Description	Default Value
`effectlib`	Starts a section where you define the effect specific options	null
`class`	Defines the effectlib class	""
`particle`	the name of the particle that is displayed. (uses different particle names compared to general magicspells)	spell_mob
`particles`	the amount of particles that are displayed	50
`color`	The HEX color of the particle. `REDSTONE`, `SPELL_MOB` and `SPELL_MOB_AMBIENT` particles can be colored.	000000
`relativeOffset`	The x,y,z offset relative to the caster, will follow where you look	0,0,0
`iterations`	How many times the effect is played	500
`period`	How many ticks in between each iteration	1
`material`	Defines the block type to be used in `BLOCK_CRACK`, `BLOCK_DUST` and `FALLING_DUST`	""
`materialData`	The data value of the material being used	0
`speed`	The speed of the particle	0
`delay`	a delay before the effect is played (in ticks)	0
`visibleRange`	display particles to players within this radius	32
`offset`	The x,y,z offset relative to the caster, will not follow where you look	0,0,0
`targetOffset`	will offset the target location	0,0,0
`yaw`, `yawOffset`	Used to modify the direction of the origin location	0
`pitch`, `pitchOffset`	Used to modify the direction of the origin location, -90 would make the effect face upwards.	0
`particleOffsetX`	This can be used to apply an x offset to spawned particles	0
`particleOffsetY`	This can be used to apply an y offset to spawned particles	0
`particleOffsetZ`	This can be used to apply an z offset to spawned particles	0
`particleSize`	Used to scale up or down the size of a particles, currently only works with the redstone particle in 1.13+	1
`disappearWithOriginEntity`	Should this effect stop playing if the origin entity becomes invalid?	false
`disappearWithTargetEntity`	Should this effect stop playing if the target entity becomes invalid?	false
`duration`	How long a spell or effect should last, in milliseconds	null
`type`	The type of the effect, delayed, instant or repeating	instant

Effect types:

ConeEffect
DragonEffect
CylinderEffect
AnimatedBallEffect
ArcEffect
BigBangEffect
AtomEffect
BleedEffect
CircleEffect
CloudEffect
ColoredImageEffect
CubeEffect
DiscoBallEffect
DnaEffect
DonutEffect
EarthEffect
EquationEffect
ExplodeEffect
FlameEffect
FountainEffect
GridEffect
HeartEffect
HelixEffect
HillEffect
IconEffect
ImageEffect
JumpEffect
LineEffect
LoveEffect
ModifiedEffect
MusicEffect
PlotEffect
ShieldEffect
SkyRocketEffect
SmokeEffect
SphereEffect
StarEffect
TextEffect
TornadoEffect
TraceEffect
TurnEffect
VortexEffect
WaveEffect
WarpEffect

Cone:

Description: Creates a cone out of a swirl Source Code

Example Example Configuration: https://hastebin.com/xeneyecehi.css

Configuration:

Option	Description	Default Value
`angularVelocity`	The angular velocity of the cone.	0.19634954084936207
`lengthGrow`	How much the length grows throughout the effect.	0.05
`radiusGrow`	How much the radius grows throughout the effect.	0.006
`particlesCone`	The particle count for the cone itself. (Affects full length of the cone).	180
`randomize`	Boolean, Whether to randomize the particles instead of it looking like a swirl.	false
`rotation`	How much the cone rotates around the y-axis. `0.5`, `1`, `1.5`, `2`, `2.5`	0

Dragon:

Description: Creates multiple strands of fire that shoot out as arcs. Source Code

Example Example Configuration: https://hastebin.com/raworifeca.cpp

Configuration:

Option	Description	Default Value
`arcs`	Defines how many arcs used.	20
`length`	How long each arc is	4
`particles`	How many particles used per arc.	30

Note: Iterations, length and particle count are important to build this effect nicely.