Rituals & Crafting rituals

PoggersRituals — Description

Start dramatic, timer-based rituals with a swirling, animated particle ring and a global boss bar countdown. The item you’re holding is lifted into the air at the ritual center and glows for the duration. When the timer ends it drops for pickup; if the starter dies (optional), the ritual shatters and the item vanishes. Supports triggering rituals by crafting specific items (saved in crafts.yml). Only one ritual can run at a time, and the boss bar re-appears for players who rejoin.

Highlights

Swirling ring with configurable particle type (incl. DUST color) and vertical bobbing.

Global boss bar shows time, item, and coordinates; persists across rejoin.

Start via command or by crafting registered items (craft result is intercepted).

Optional “cancel on death” with custom break sound and broadcast.

Single-active-ritual lock to prevent overlaps.

/PoggersRituals reload reloads config.yml and crafts.yml.

Tested on: Paper/Spigot 1.21 (API 1.21).

Commands

/ritual Start a ritual with the item in your hand (removes it, hovers 3 blocks up). Permission: poggersrituals.admin

/ritualcrafts Register the held item so crafting it will start a ritual instead of giving the result (saved in crafts.yml). Permission: poggersrituals.admin

/deletecrafts Remove the held item from crafts.yml so crafting it is normal again. Permission: poggersrituals.admin

/PoggersRituals reload Reload config.yml and crafts.yml. Permission: poggersrituals.admin

Permissions

poggersrituals.admin — required for all commands above. (Default: OP)

Key Config (quick reference)

ritual-duration-seconds — total time (seconds) for a ritual.

particle.type — e.g. SONIC_BOOM, END_ROD, FLAME, DUST (colored).

particle.radius, particle.columns, particle.rpm — ring size & spin.

particle.vertical.amplitude, particle.vertical.rpm — up/down bobbing.

particle.dust.{r,g,b,size} — color/size when type: DUST.

cancel-on-death.enabled — end ritual if starter dies (item vanishes).

cancel-on-death.sound, broadcast, message — cancel SFX and message.