Ember Plugins
Ember Surge¶
Timed boosts that apply to everyone online, bought and activated by players.
That "everyone" is the whole point. A surge the buyer activates benefits the entire server, so nobody gains an advantage over anybody else — which is what makes it a reward you can sell without turning your server pay-to-win.
What a surge is¶
One YAML file in surges/, whose file name is its id. Ten ship with the plugin:
| Surge | Duration | Channel | What it does |
|---|---|---|---|
ore_surge |
30m | drops | Double ore drops |
lumber_surge |
30m | drops | Double log drops |
harvest_surge |
45m | drops | Better crop yields |
smelter_surge |
30m | drops | Smelting bonuses |
fortune_surge |
45m | buffs | Luck across the board |
haste_surge |
20m | buffs | Faster mining |
swift_surge |
20m | buffs | Movement speed |
guardian_surge |
15m | buffs | Damage resistance |
xp_surge |
1h | xp | Multiplied experience |
bounty_surge |
1h | economy | Higher payouts |
Each carries a duration, a channel (so two surges of the same kind cannot stack by accident), an optional boss bar, world restrictions, and the effects it runs while active.
Built on Ember Fx Core¶
The effects are written in the shared effects language, so a surge can express anything the engine can — 176 effects, 74 triggers, 95 conditions:
name: "&bOre Surge"
duration: 30m
channel: "drops"
stacks-with: "ore_double"
while-active:
- id: multiply_drops
triggers:
- mine_ore
args:
multiplier: 2
Ember Surge therefore requires Ember Fx Core, which is free.
Built in game¶
/surge editor builds and edits surges without opening a file. Players use
/surge for the menu and /surge activate to start one they own.
Commands¶
| Command | What it does | Permission |
|---|---|---|
/surge |
Open the surge menu | embersurge.use |
/surge activate <id> |
Activate a surge you own | embersurge.activate |
/surge active |
What is running now | embersurge.use |
/surge list |
Every configured surge | embersurge.use |
/surge history |
Recently run surges | embersurge.use |
/surge editor |
Build and edit in game | embersurge.admin |
/surge give <player> <id> |
Grant a surge | embersurge.admin |
/surge cancel <id> |
Stop a running surge | embersurge.admin |
/surge reload |
Re-read the files | embersurge.admin |
Aliases: /surges, /boosters, /embersurge.
What it needs¶
| Server | Paper 1.21.1 – 26.2, and Folia |
| Java | 21 or newer |
| Required | Ember Fx Core |
| Optional | PlaceholderAPI |
One jar covers the whole range: it is compiled against the oldest API in it and emitted as Java 21 bytecode, which every server from 1.21.1 up can load.
In pictures¶
