Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Beautiful sakura-inspired particle cosmetics (trails, auras, wings and more), fully configurable and lightweight.
Hanami
Hanami (花見, "flower viewing") is a cosmetics plugin for Spigot and Paper with a quiet, Japanese-inspired look. Every effect is drawn from parametric maths (circles, helices, Lissajous orbits, bézier wings, even kanji turned into particles) and defined entirely in YAML, so server admins can design new cosmetics without touching code.
It's also built to be cheap. One scheduler drives every cosmetic on the server, the maths runs off the main thread, and per-player and global particle budgets keep output bounded however many players gather in one spot.
✿ Features
- Five cosmetic types, each a separate module behind one interface:
- Trails: petals, ink wisps, lantern embers, koi ripples that spread across the water
- Auras: an orbiting petal storm, a slowly turning ring of kanji (花 風 月), a firefly cloud
- Wings: sakura, crane and fox-fire wings that flap on an animation curve and follow your body yaw, not your head
- Projectile trails: helices wrapped around an arrow's flight path, ink brushstrokes
- Emotes and kill effects: a petal whirlwind, a torii gate drawn stroke by stroke, an ink splash with an ensō circle
- Parametric shapes: circle, spiral, helix, Lissajous, sphere, line, polyline, bézier, glyph (text → particles), plus mirror, union, transform and radial combinators. Shapes are sampled once, evenly by arc length, cached, and rotated per tick with 3×3 matrices.
- Everything is data: particles (including colour transitions and palettes that cycle), shapes, animation curves, keyframes, emission modes, prices, permissions, icons and lore.
- Safe /hanami reload: every file is validated, and errors name the file, the path and the problem: cosmetics.yml → cosmetics.koi_ripple.shape.radius: expected a number between 0.01 and 32, got "big"
- If any file is broken, nothing changes. A single broken cosmetic is skipped and the rest still load.
- A data-driven GUI: paginated category menus drawn as character grids in menus.yml. They show whether each cosmetic is worn, unlocked, for sale or locked, and right-click previews any of them for 5 seconds, visible only to you.
- Player settings: hide other players' cosmetics, and choose a personal particle density (low / medium / high) for weaker PCs.
- Storage: one JSON file per player (default, zero setup), SQLite, or MySQL through HikariCP with versioned migrations. Saves are atomic, and everything is async and cached while the player is online.
- Admin GUI (/hanami admin): give, revoke, equip and remove cosmetics for online players, and a cosmetic creator to design new cosmetics with buttons, preview them on yourself, and save them straight into cosmetics.yml.
- Unlocks: by permission, by purchase with any Vault economy (with a confirmation menu), or by admin grant, which also works for offline players.
- Integrations (all optional): Vault, PlaceholderAPI, and Essentials / SuperVanish / PremiumVanish. Public API with cancellable events for other plugins.
Information
Category
Miscellaneous
Published
November 17, 2026
License
MIT
0Downloads
0Stars
Pinned Versions
- R1.20–1.21.11
Pages
Members
1Owner