{"id":119557,"date":"2026-06-07T03:48:35","date_gmt":"2026-06-07T00:48:35","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/"},"modified":"2026-06-07T03:48:35","modified_gmt":"2026-06-07T00:48:35","slug":"particlefx","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/","title":{"rendered":"ParticleFX"},"content":{"rendered":"

# ParticleFX<\/p>\n

ParticleFX is a Paper 1.21 plugin that adds customizable particle effects for many player actions.<\/p>\n

Players can create their own presets, edit animation parameters, add or remove particle layers, preview effects, and bind presets to supported actions without editing the server config manually.<\/p>\n

## Features<\/p>\n

– Multiple built-in animation types, including `RING_WAVE`, `DOUBLE_HELIX`, `PHOENIX_BURST`, `TORNADO`, `CELESTIAL_SPHERE`, `ORBITAL`, `STARBURST`, and `PILLAR_PULSE`
\n– Many supported triggers: jump, death, respawn, join, quit, move, sprint start\/stop, sneak start\/stop, attack, hit, consume, teleport, block break, block place, bow shot, and level up
\n– Global presets and default bindings through `config.yml`
\n– Per-player presets and per-player bindings saved automatically in `plugins\/ParticleFX\/playerdata\/`
\n– In-game preset editing with commands
\n– In-game preview system for testing custom effects<\/p>\n

## Commands<\/p>\n

| Command | Description |
\n| — | — |
\n| `\/particlefx help` | Show command help |
\n| `\/particlefx reload` | Reload the plugin configuration |
\n| `\/particlefx actions` | List supported action triggers |
\n| `\/particlefx animations` | List available animation types |
\n| `\/particlefx presets` | Show personal and global presets |
\n| `\/particlefx preview ` | Preview a preset at your location |
\n| `\/particlefx preset create ` | Create a personal preset |
\n| `\/particlefx preset clone` | Clone a preset into your personal profile |
\n| `\/particlefx preset rename ` | Rename a personal preset |
\n| `\/particlefx preset delete ` | Delete a personal preset |
\n| `\/particlefx preset info ` | Show preset details |
\n| `\/particlefx preset set ` | Edit preset settings |
\n| `\/particlefx preset particle add ` | Add a particle layer |
\n| `\/particlefx preset particle remove ` | Remove a particle layer |
\n| `\/particlefx preset particle set ` | Edit a particle layer |
\n| `\/particlefx preset particle list ` | List particle layers in a preset |
\n| `\/particlefx preset particle clear ` | Remove all particle layers |
\n| `\/particlefx bind list` | Show current effective bindings |
\n| `\/particlefx bind add ` | Bind a preset to an action |
\n| `\/particlefx bind remove ` | Remove a preset from an action |
\n| `\/particlefx bind clear ` | Disable an action in your personal profile |
\n| `\/particlefx bind reset ` | Reset an action back to global defaults |<\/p>\n

## Permissions<\/p>\n

| Permission | Description | Default |
\n| — | — | — |
\n| `particlefx.reload` | Reload the plugin config | `op` |
\n| `particlefx.customize` | Manage personal presets and bindings | `true` |
\n| `particlefx.effect.jump` | Use the default jump preset | `true` |
\n| `particlefx.effect.death` | Use the default death preset | `true` |
\n| `particlefx.effect.respawn` | Use the default respawn preset | `true` |<\/p>\n

## Configuration<\/p>\n

The default configuration file is located at:<\/p>\n

`src\/main\/resources\/config.yml`<\/p>\n

It contains:<\/p>\n

– global presets
\n– default trigger bindings
\n– default permissions
\n– message settings
\n– disabled worlds list<\/p>\n

Example workflow for a player:<\/p>\n

“`text
\n\/particlefx preset create myflare
\n\/particlefx preset set myflare animation TORNADO
\n\/particlefx preset particle add myflare DUST
\n\/particlefx preset particle set myflare 1 color 255,80,180
\n\/particlefx bind add sprint-start myflare
\n\/particlefx preview myflare
\n“`<\/p>\n

## Installation<\/p>\n

1. Build the plugin or download the compiled jar.
\n2. Put the jar into the server `plugins\/` folder.
\n3. Start the server.
\n4. Edit `plugins\/ParticleFX\/config.yml` if you want to change global presets or default bindings.
\n5. Use `\/particlefx reload` after config changes.<\/p>\n

## Build<\/p>\n

This project uses Gradle.<\/p>\n

“`powershell
\n.gradlew.bat build
\n“`<\/p>\n

The compiled jar will be generated in:<\/p>\n

`build\/libs\/ParticleFX-1.0-SNAPSHOT.jar`<\/p>\n

## Notes<\/p>\n

– The plugin targets Paper `1.21`
\n– Player-created data is stored automatically per UUID
\n– Some `Sound` lookups use Paper’s deprecated compatibility API, but the plugin builds and works correctly on the current target version<\/p>\n","protected":false},"excerpt":{"rendered":"

ParticleFX is a Paper 1.21 plugin that adds customizable particle effects for many player actions.<\/p>\n","protected":false},"featured_media":119558,"template":"","meta":{"_minecraft_slug":"particlefx","_minecraft_project_id":"ztG2JU2K","_minecraft_author":"MrYArg1cH","_minecraft_license":"MIT","_minecraft_downloads":42,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"particlefx.zip","_minecraft_size_bytes":66325,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:31:34.279920Z","_minecraft_date_created":"2026-03-17T00:26:49.314176Z","_minecraft_date_modified":"2026-03-15T05:46:35.425728Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/particlefx","_minecraft_icon_attachment_id":119558,"_minecraft_imported_at":"2026-06-07T00:48:36+00:00","_minecraft_import_hash":"d362fda5dca435d3e09447d86ad5a072","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,89,122,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-119557","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nParticleFX - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ParticleFX - Minecraft\" \/>\n<meta property=\"og:description\" content=\"ParticleFX is a Paper 1.21 plugin that adds customizable particle effects for many player actions.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/\",\"name\":\"ParticleFX - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp\",\"datePublished\":\"2026-06-07T00:48:35+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/particlefx\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ParticleFX\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ParticleFX - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/","og_locale":"en_US","og_type":"article","og_title":"ParticleFX - Minecraft","og_description":"ParticleFX is a Paper 1.21 plugin that adds customizable particle effects for many player actions.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/","name":"ParticleFX - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp","datePublished":"2026-06-07T00:48:35+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/particlefx-icon-44b099591695fd3c0d65bce8c5351b3478c7e9aa_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/particlefx\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ParticleFX"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/119557","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/119558"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=119557"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=119557"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=119557"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=119557"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}