BladeFX is one jar plus a folder of effects files. There is nothing to configure in a config.yml — the effects files are the configuration.
Install
- Drop
GrimsBladeFX-1.0.1.jarintoplugins/. - Put each pack's effects file into
plugins/GrimsBladeFX/effects/. - Restart, then
/gbladefx reloadafter any later edit.
It loads only on Paper 26.3 (api-version: '26.3'). A 26.2 server needs 0.9.0, the last 26.2 build.
Packforge is required. BladeFX does not work with third-party pack-host plugins. Effects identify pack items using Packforge’s tags; launchers obtain their projectiles from Packforge. Floodgate, GrimsCrops and GrimsSuperSpawners are optional integrations.
A successful plugin load alone does not confirm that effects are available. If effects are silent, first check that Packforge is installed and the matching content pack is loaded.
Commands
| Command | What it does |
|---|---|
/gbladefx reload | Re-read every effects file |
/gbladefx validate | Check the files without applying them |
/gbladefx inspect [player] | What that player is holding and wearing, as BladeFX sees it |
/gbladefx status | What is loaded and which clocks are running |
One permission: gbladefx.admin, default op.
Effects files
| File | Pack |
|---|---|
egw_fantasy.yml | EGW Fantasy Pack |
egw_backyard.yml | Grims Backyard Toys |
egw_spacecadet.yml | Grims Space Cadet |
A file names its namespace, a set of presets, and the items and sets that use them. Edit a value and run /gbladefx reload; /gbladefx validate first if you want to be sure before it goes live.
Your edits are yours. Nothing clamps a number you write. If you set a cooldown to zero, it is zero.
What it costs to run
Everything is event-driven. The timers run only while they have work to do: the ambient puff clock while somebody holds a puff item, the snack clock while a thrown snack is in the air, the blower clock while a Leaf Blower's right-click is held. An idle server runs no BladeFX timers at all.
Where it stands
1.0.1 is built and bench-tested — 980 tests, a clean compile against Paper 26.3 build 194 and a headless boot with the Fantasy, Backyard Toys and Space Cadet drop-ins. It has not yet run in a game client on 26.3.