ModsJava
ProxyParticles
Java mod listed for Minecraft 1.20–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotProxyParticle
Build particle systems in-game. Share them as JSON.
Spigot • Paper • Purpur | Minecraft 1.21.0 → 26.x | Java 21 | PlaceholderAPI support
What is ProxyParticle?
ProxyParticle is a complete particle-effect creator for your server. Design effects in a chest-GUI editor while a live preview plays in front of you, so every click shows up instantly. No YAML, no code, no restarts.
Every effect is saved as a small JSON file. Export it, send it to a friend or post it online, and any server running ProxyParticle can import it in one command. Build a library of effects once and reuse it everywhere.
Features
- In-game GUI editor with a live preview. Left/right click to change values, Q to type an exact value, Ctrl+Q to reset.
- Layered effects: stack as many emitters as you like into one effect, each with its own particle, shape, timing and motion.
- 19 shapes: point, line, circle, disc, sphere, ball, torus, cube, box, cylinder, cone, helix, spiral, vortex, polygon, star, heart, wave and grid.
- Every vanilla particle on your server version, including dust, colored effects, block and item particles.
- Colors: color lists with static, random, gradient-over-life, gradient-along-shape and rainbow modes. Dust can grow or shrink over its life.
- Animation: tilt, spin on any axis, pulse, follow the player's facing, and "sequential" drawing that traces a shape point by point.
- Physics: speed, gravity, drag, turbulence, orbit, attraction, and world-space trails that stay where they were emitted.
- Timing: emission rate, bursts, delays, per-layer durations, looping or one-shot effects, plus optional sounds.
- Permanent placed effects that survive restarts. Move them, nudge them by 0.25 blocks, give them your own ids, and find them with Tab or a clickable list.
- JSON sharing: export, import from a folder, or import straight from a pastebin / GitHub / gist link.
- Safe file format: missing settings use defaults and unknown ones are skipped, so files keep working across plugin and Minecraft versions.
- PlaceholderAPI expansion built in (optional).
- Developer API to play effects from your own plugins.
- Lag-safe: render distance, a server-wide particle cap and an effect cap, all in config.yml.
- 9 sample effects included: flame ring, rainbow helix, heart halo, magic vortex, firework burst, snow cloud, atom, star crown and laser beam.
Sharing effects
- Run /pp export <effect>. The file is written to plugins/ProxyParticle/exports/.
- Send the file, or post it on pastebin or GitHub.
- On the other server, drop it in plugins/ProxyParticle/imports/ and run /pp import all, or run /pp import <link>.
Commands
Main command: /pp (aliases: /proxyparticle, /pparticle). Everything tab-completes.
Code (Text):
/pp Open the editor
/pp editor [effect] Open the editor (on an effect)
/pp list | info <effect> Browse effects
/pp play <effect> [player|here] [loop] Play an effect
/pp stop [player|all] Stop effects
/pp create <name> New effect
/pp clone <from> <to> Copy an effect
/pp rename <old> <new> Rename an effect
/pp delete <name> Delete (a backup is kept)
/pp layer <effect> add|remove <n>|list Manage layers
/pp set <effect> <layer#|effect> <key> <value> Change any setting
/pp get <effect> [layer#] Show all settings
/pp keys | particles List setting keys / particles
/pp export <effect|all> Write JSON to exports/
/pp import <file|all|link> [name] Import JSON
/pp place <effect> [id] Place a permanent effect
/pp unplace [id] Remove one
/pp placed [name] Clickable list, nearest first
/pp movehere [id] Move a placed effect to you
/pp moveto <player> [id] Move it to a player
/pp adjust <x|y|z|yaw> <+0.25|-0.25> [id] Nudge it
/pp select [id|nearest] Choose which one to edit
/pp setid <placed> <id|none> Give it your own id
/pp tp <id> Teleport to it
/pp reload | stats Admin
Code (Text):
proxyparticle.use List, play on yourself, stop your own effects
proxyparticle.play.others Play and stop effects on other players
proxyparticle.edit Editor, create, edit, clone, rename, export
proxyparticle.import Import from files and links
proxyparticle.admin Everything above, plus delete, place, stop all, reload
Placeholders (PlaceholderAPI)
Code (Text):
%proxyparticle_effects_total% Effects on the server
%proxyparticle_placed_total% Placed effects
%proxyparticle_running_total% Effects playing right now
%proxyparticle_particles_live% Simulated particles alive
%proxyparticle_active% Effects playing on the player
%proxyparticle_active_ids% Their ids ("none" if empty)
%proxyparticle_active_names% Their display names
%proxyparticle_is_active% true / false
%proxyparticle_is_active_<effect>% Is that effect playing on the player
%proxyparticle_previewing% Effect the player is previewing
%proxyparticle_selected% Player's selected placed effect
%proxyparticle_selected_effect% ...and which effect it is
%proxyparticle_effect_<effect>_<field>% name, name_plain, author, description, layers, duration, exists
%proxyparticle_placed_<id>_<field>% effect, world, x, y, z, exists
Requirements
- Spigot, Paper or Purpur, Minecraft 1.21.0 or newer (including 26.x)
- Java 21
- Optional: PlaceholderAPI 2.11+
- Folia is not supported
Installation
- Put ProxyParticle.jar in your plugins folder and restart.
- Run /pp to open the editor. The 9 sample effects are ready to play.
- Right-click an effect to play it on yourself, left-click to edit it.
Support
SUPPORT_LINE
Please don't leave a bug report in the reviews. Contact me first and I'll fix it.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ProxyParticles is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 13 times (via Spigot). Download it and open it directly in the game.