Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
ā ļø please keep in mind that the description is only maintained for the latest version
2 particle types are implemented
particles
static_particle
- configurable
color,alpha,size,lifetime,texture - is emissive (glow in the dark)
static_oriented
- configurable
color,alpha,sizeX,sizeY,lifetime,rotation,post_rotation,cull,texture - is emissive (glow in the dark)
note
important thing to know is that all number arguments are actually string arguments, due to a limitation of minecrafts codebase, its so that the stuff listed below can workā
-
all number arguments(the particle parameters) support ranges ("x..y"=random from x to y), rotation arguments also support ~ which will use the command rotation context on the appropriate axis
-
all number arguments except
lifetimesupport animation sequences ("x->y->z" = animate from x to y to z), any amount of keyframes is supported, you can also add more dashes to control the timing of the keyframes -
the rotation arguments support
billboardas a value, which will cause the particle to face the players camera on he specified axes -
also if youre wondering, post_rotation is just a second pass of rotation, technically redundant, just convenient
textures
currently only 4 textures are implemented:dot
dither
smooth
pixel
shockwave
there are 5 standalone commands
commands
/fov <add|multiply|set|query> <targets> <float> [interpolation type] [interpolation duration]
- changes/gets the client FOV of the targets
/setperspective <targets> <perspective index|distance> [camera distance]
- changes the client perspective
/rendertext <targets> <x> <y> <z> <rotation> <text> <alignment> <sizeX> <sizeY> [duration] [opacity] [gui scale independent] [hide with HUD] [overlay] [shadow Color(RGBA HEX)]
- displays text on the targets screens at the inputted position
- boolean argument for making the text size independent of the clients GUI scale setting
- boolean argument for forcing the text to display even if the HUD is hidden (F1)
- boolean argument for the size being multiplied by the client window aspect ratio
/log <client|server> [targets] <logger name> <message>
- sends the message under the logger name in the client's/server's console (not in chat)
/camerarot <targets> <pitch> <yaw> <roll> [duration]
- adds rotation offset to the client camera (linear interpolation)
note
(roll works perfectly, yaw and pitch technically do too, just a bit un-intuitive, in most cases its better to use actual entity rotation instead)the mod adds 3 conditions for predicates
predicates
mouse* condition
{
"condition": "staticparticle:player_action",
"action": "attack"/"pick_item"/"use",
"context": "in_game"/"in_menu"
}
- true when the target of the predicate is holding the respective buttons in the respective context
key condition
- the mod adds 5 new keybinds that dont do anything, except for tell the server theyve been pressed by a client
{
"condition": "staticparticle:special_key",
"key": 0/1/2/3/4
}
- true when the target of the predicate is holding the respective key
movement input condition
{
"condition": "staticparticle:input",
"action": "forward/back/left/right/jump/sprint/sneak"
}


