Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
MoParticles

MoParticles is a Paper plugin that reads MoLang particle definitions (the Bedrock particle language), bakes them into animations, generates a resource pack with the right textures, and plays the animations using client-side Item Display entities.
Supported servers
Paper and Purpur, Minecraft 1.21.5 through 26.3. All packets are encoded per player using PacketEvents 2.14.0, so any supported client can watch at the same time. Requires Java 21+.
How it renders
Effects render entirely with packets. No real entities are ever spawned on the server.
For each particle:
- Spawn Entity and Set Entity Data create the Item Display when the particle appears.
- Teleport Entity moves the particle every tick. The client interpolates the move over the display's position/rotation interpolation duration, so frames at 20 TPS look perfectly smooth.
- Set Entity Data only fires when a particle's scale or tint actually changes.
- Remove Entities (one batched packet) cleans up particles that disappear or viewers who leave.
All packets for one viewer are written to their channel and flushed once per tick using User#writePacket and User#flushPackets. Each viewer's PacketEvents user is resolved once and cached, so hundreds of particles cost a single network flush per player per tick.
The metadata indexes match the Minecraft wiki protocol documentation (Java Edition protocol/Entity metadata), which is identical from 1.21.5 through 26.3. The exact indexes are documented in DisplayEntityPackets.java.
Resource pack
The plugin generates one resource pack per supported server version. Every effect in the pack gets:
- An item definition (assets/<namespace>/items/particles/<name>.json)
- A plane model (assets/<namespace>/models/item/particles/<name>.json)
- A texture (assets/<namespace>/textures/item/particles/<name>.png)
The client resolves this chain from the item's minecraft:item_model component:
<ns>:particles/<name> (item_model component)
-> assets/<ns>/items/particles/<name>.json (item definition)
-> assets/<ns>/models/item/particles/<name>.json (plane model)
-> assets/<ns>/textures/item/particles/<name>.png
Colors travel through the minecraft:custom_model_data color list at index 0. The pack declares format 46 (introduced in 1.21.4) with support up to 999, so one pack works for every supported client.
Textures
Textures are looked up in this order:
- The effect's declared texture path exactly as written.
- textures/particle/<lastSegment>.png (for example, textures/particle/moparticles/circle resolves to textures/particle/circle.png).
- textures/particle/<effectName>.png.
The plugin checks plugins/MoParticles/ first, then the bundled jar. The bundled defaults (circle.png and cube.png) are crisp pixel art with no anti-aliasing and are refreshed on every startup so texture fixes propagate to existing installs. Each one is tinted at runtime by the effect color. If nothing is found, a crisp circle is generated in code as a final fallback.
The pack includes a pixel-art pack.png icon.
Build
Run:
./gradlew shadowJar
The output is build/libs/MoParticles-2.0.0-all.jar. PacketEvents and the command framework are shaded in, so no extra plugins are required.
Drop the jar into your server's plugins folder, then install the generated resource pack from plugins/MoParticles/generated/resourcepack.zip.
Commands
/moparticles list /moparticles play <effect> <location> [radius] /moparticles playhere <effect> [radius] /moparticles stop <id> /moparticles stopall /moparticles reload /moparticles info <effect>
Command descriptions
- list - shows all loaded effects
- play <effect> <location> [radius] - plays an effect at a location for players within radius blocks
- playhere <effect> [radius] - plays an effect at your position
- stop <id> - stops a running animation by its id
- stopall - stops every running animation
- reload - reloads effects and the resource pack from disk
- info <effect> - shows effect metadata
Example particles
The plugin bundles three effects from Snowstorm in src/main/resources/particles/:
- snowstorm:fire - custom snowstorm fire particle
- snowstorm:loading - Snowstorm's loading circle particle
- snowstorm:rainbow - Snowstorm's rainbow particle animation
Add your own by dropping .json files into plugins/MoParticles/particles/ and running /moparticles reload.
Using MoParticles in your plugin
1. Add the dependency
Gradle
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.Chest-Solutions:MoParticles:2.0.0'
}
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.Chest-Solutions</groupId>
<artifactId>MoParticles</artifactId>
<version>2.0.0</version>
<scope>provided</scope>
</dependency>
</dependencies>
2. Mark it as a hard dependency
In your plugin.yml:
name: MyPlugin
version: 1.0
main: com.example.plugin.MyPlugin
depend: [MoParticles]
3. Play an effect
MoParticleAPI api = MoParticleAPI.get();
String effectName = "fire";
Location targetLocation = player.getLocation();
if (api.hasEffect(effectName)) {
UUID animationId = api.play(effectName, targetLocation, 10.0);
api.stop(animationId);
}


