Rituals & Crafting rituals

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： bukkit paper purpur spigot

标签： adventure equipment game-mechanics

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.