![ProxyParticle banner](https://cdn.modrinth.com/data/hf8VKcPz/images/0d790063c86eff07cab45e8e0ef69bf65dc6b825.png) **Build particle systems in-game. Share them as JSON.** Spigot, Paper and Purpur · Minecraft 1.21.0 to 26.x · Java 21 · optional PlaceholderAPI support ## What is ProxyParticle? ProxyParticle is a particle-effect creator for your server. You 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 with one command. ![The in-game editor](https://cdn.modrinth.com/data/hf8VKcPz/images/e803a00aec59bf3676831a127e3b842348c3f91c.png) ## Features - **In-game GUI editor** with a live preview. Left/right click changes a value, Q types an exact value, Ctrl+Q resets it. - **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, and 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, and 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 or gist link. - **Forward-compatible files:** missing settings use defaults and unknown ones are skipped, so files keep working across plugin and Minecraft versions. - **PlaceholderAPI** expansion built in. - **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:** flame ring, rainbow helix, heart halo, magic vortex, firework burst, snow cloud, atom, star crown and laser beam. ![Shapes](https://cdn.modrinth.com/data/hf8VKcPz/images/33f27cd4591497881b38e0cdf0ac79331c8300b1.png) ![Physics](https://cdn.modrinth.com/data/hf8VKcPz/images/1b362b32acdb6578ed1fed51bb8fd6114466b0ca.png) ## Sharing effects 1. Run `/pp export `. The file is written to `plugins/ProxyParticle/exports/`. 2. Send the file, or post it on pastebin or GitHub. 3. On the other server, put it in `plugins/ProxyParticle/imports/` and run `/pp import all`, or run `/pp import `. ![Sharing effects as JSON](https://cdn.modrinth.com/data/hf8VKcPz/images/b9183e5ab981aeef3c3908ad920eb75af946cc90.png) ## Commands The main command is `/pp` (aliases `/proxyparticle`, `/pparticle`). Everything tab-completes. | Command | What it does | |---|---| | `/pp` or `/pp editor [effect]` | Open the editor | | `/pp list`, `/pp info ` | Browse effects | | `/pp play [player\|here] [loop]` | Play an effect | | `/pp stop [player\|all]` | Stop effects | | `/pp create ` | Create an effect | | `/pp clone ` | Copy an effect | | `/pp rename ` | Rename an effect | | `/pp delete ` | Delete an effect (a backup is kept) | | `/pp layer add\|remove \|list` | Manage layers | | `/pp set ` | Change any setting | | `/pp get [layer#]` | Show all settings | | `/pp keys`, `/pp particles` | List setting keys and particles | | `/pp export ` | Write JSON to exports/ | | `/pp import [name]` | Import JSON | | `/pp place [id]` | Place a permanent effect | | `/pp unplace [id]` | Remove a placed effect | | `/pp placed [name]` | Clickable list of placed effects, nearest first | | `/pp movehere [id]` | Move a placed effect to you | | `/pp moveto [id]` | Move a placed effect to a player | | `/pp adjust <+0.25\|-0.25> [id]` | Nudge a placed effect | | `/pp select [id\|nearest]` | Choose which placed effect to edit | | `/pp setid ` | Give a placed effect your own id | | `/pp tp ` | Teleport to a placed effect | | `/pp reload`, `/pp stats` | Admin | ## Permissions All permissions default to OP. | Permission | Allows | |---|---| | `proxyparticle.use` | List effects, play them on yourself, stop your own | | `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 and reload | ## Placeholders Requires PlaceholderAPI 2.11 or newer. The expansion registers itself. | Placeholder | Value | |---|---| | `%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` or `false` | | `%proxyparticle_is_active_%` | Whether that effect is playing on the player | | `%proxyparticle_previewing%` | Effect the player is previewing in the editor | | `%proxyparticle_selected%` | The player's selected placed effect | | `%proxyparticle_selected_effect%` | Which effect the selected placed effect plays | | `%proxyparticle_effect__%` | `name`, `name_plain`, `author`, `description`, `layers`, `duration` or `exists` | | `%proxyparticle_placed__%` | `effect`, `world`, `x`, `y`, `z` or `exists` | ![Compatibility](https://cdn.modrinth.com/data/hf8VKcPz/images/0f72dd7dbf729dbea81debb59e839c0b1fe17825.png) ## Requirements - Spigot, Paper or Purpur, Minecraft 1.21.0 or newer (including 26.x) - Java 21 - Optional: PlaceholderAPI 2.11 or newer - Folia is not supported ## Installation 1. Put `ProxyParticle.jar` in your `plugins` folder and restart the server. 2. Run `/pp` to open the editor. The 9 sample effects are ready to play. 3. Right-click an effect to play it on yourself, left-click to edit it. ## Support SUPPORT_LINE

ProxyParticles

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details

shapes

banner

editor

compact

motion

sharing