Compatibility
Minecraft: Java Edition
1.21.x
1.20.6
1.20.1
Platforms
Fabric
Supported environments
90% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Licensed MIT
Published 5 months ago
Updated last month
Magic Particles
A fabric server side cosmetics mod, that allows administrator to create custom particles using simple json files
Commands
/mp
- List all available magic particles -magic-particles.root
/mp set <id>
- Set current magic particle -magic-particles.particle
/mp disable
- Disable current magic particle -magic-particles.disable
/mp reload
- Reload magic particles and messages -magic-particles.reload
Custom Particles
This mod includes more than 40 default particles, which can be useful example files for understanding the format.
JSON Format
Each magic particle type needs a human friendly name and a list of particles it consists of
Root
{
"name": "Some name", // Human friendly name
"particles": [
// Particle definitions
]
}
Particle definition
There are currently 3 particle definition types (simple, image and bezier). All of these share a couple of common values in addition to their specialized ones.
Simple
{
"type": "simple",
"count": 1, // Amount of particles (optional)
"pos": [1.0, 2.0, 0.0], // Offset from origin (affected by rotation)
"delta": [0.1, 0.1, 0.1], // Particle area size (optional)
"speed": 0, // Particle speed parameter, used by some particle types (optional)
"particle_type": {
"type": "minecraft:angry_villager" // Particle type: https://minecraft.wiki/w/Particles_(Java_Edition)#Types_of_particles
// Some particles types have extra attributes, which need to be specified here
},
"anchor": "feet", // The particle origin ["feet"|"eyes"] (optional)
"origin": [0.0, 0.5, 0.0], // Offset from origin (optional)
"billboard": "fixed" // What rotation axis should affect "pos" ["fixed", "vertical", "horizontal", "center"] (optional)
}
Image
{
"type": "image",
"image": "drex.png", // Path to the image, the image needs to be in config/magic-particles/images/<image>
"size_x": 0.8, // The width of the particle image
"size_y": 0.8, // The height of the particle image
"pixel_size": 0.6, // The size of each individual particle
"pos": [1.0, 2.0, 0.0], // Offset from origin (affected by rotation)
"anchor": "feet", // The particle origin ["feet"|"eyes"] (optional)
"origin": [0.0, 0.5, 0.0], // Offset from origin (optional)
"billboard": "fixed" // What rotation axis should affect "pos" ["fixed", "vertical", "horizontal", "center"] (optional)
}
Bezier
(Can't really recommend to use this, creating an image of the desired shape and using the image type is easier)