MagicParticles

The MagicParticles mod is a server-side Fabric addon that provides administrators with the ability to create unique visual effects using simple JSON files.

Available Commands

• /mp - displays a list of all available magic particles (requires permission magic-particles.root)
• /mp set <id> - sets the current magic particle (requires permission magic-particles.particle)
• /mp disable - disables the current magic particle (requires permission magic-particles.disable)
• /mp reload - reloads magic particles and messages (requires permission magic-particles.reload)

Custom Particles

The mod includes over 40 default particles that serve as excellent examples for understanding the configuration format.

JSON Format

Each magic particle type requires a user-friendly name and a list of its component particles.

Main Structure

{
  "name": "Effect Name", // User-friendly name
  "particles": [
    // Particle definitions
  ]
}

Particle Definition

Currently, there are three types of particle definitions (simple, image, and bezier). All of them share common parameters in addition to specialized ones.

Simple Type

{
  "type": "simple",
  "count": 1, // Number 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
    // Some particle types have additional attributes that need to be specified here
  },
  "anchor": "feet", // Particle origin ["feet"|"eyes"] (optional)
  "origin": [0.0, 0.5, 0.0], // Offset from origin (optional)
  "billboard": "fixed" // Which rotation axis should affect "pos" ["fixed", "vertical", "horizontal", "center"] (optional)
}

Image Type

{
  "type": "image",
  "image": "drex.png", // Path to the image, the image must be in config/magic-particles/images/<image>
  "size_x": 0.8, // Width of the particle image
  "size_y": 0.8, // Height of the particle image
  "pixel_size": 0.6, // Size of each individual particle
  "pos": [1.0, 2.0, 0.0], // Offset from origin (affected by rotation)
  "anchor": "feet", // Particle origin ["feet"|"eyes"] (optional)
  "origin": [0.0, 0.5, 0.0], // Offset from origin (optional)
  "billboard": "fixed" // Which rotation axis should affect "pos" ["fixed", "vertical", "horizontal", "center"] (optional)
}

Bezier Curve

(Not recommended for use, creating an image of the desired shape and using the image type is easier)