Newon GoogleMake CraftRank a preferred source in Google SearchAdd on Google ›
CraftRank SitesA free website and store for your server Make yours ›AshlarFree server software built on Paper, with DDoS and backdoor protection See Ashlar ›Security RadarA free check of your server's login, anti-bot and proxy settings, only with your OK See how it works ›CommunityAsk questions, share builds and find people to play with Join the forum ›
Resources / Plugins / Hanami

Hanami

Beautiful sakura-inspired particle cosmetics (trails, auras, wings and more), fully configurable and lightweight.

PluginsFree1.20 – 1.21
by jeary-dev · listed from Hangar
Download ›

Direct download from Hangar · 0 downloads

What it does

Hanami is a plugin for Paper / Spigot servers, made by jeary-dev. Beautiful sakura-inspired particle cosmetics (trails, auras, wings and more), fully configurable and lightweight.

It supports Minecraft 1.20 – 1.21. That puts it at #160 of the 160 cosmetic and display plugins listed here. The last update came out on Nov 17, 2026.

Supported versions

1.211.20

Release history

The newest is 1.0.0, released on Nov 17, 2026. It is made for Minecraft 1.20 – 1.21.11. It runs on Paper. The download is 3.0 MB.

VersionReleasedMinecraftType
1.0.0Nov 17, 20261.20 – 1.21.11Release

Commands

The commands named on the Hangar page of Hanami:

/hanami

Latest release on GitHub

Hanami is open source. Its newest release on GitHub is Hanami 1.0.0, published on Nov 17, 2026.

Release notes for v1.0.0

The first release of Hanami 🌸: elegant, data-driven particle cosmetics for Spigot and Paper.

Highlights

  • 15 cosmetics across five types: trails, auras, wings, projectile trails and emotes
  • Parametric shapes (helices, Lissajous orbits, bézier wings, kanji glyphs) defined entirely in YAML
  • In-game menus with previews, purchases (Vault) and per-player settings
  • Admin GUI with a cosmetic creator that saves straight to cosmetics.yml
  • Safe /hanami reload with errors that name the file, the path and the problem
  • Storage: JSON (default), SQLite or MySQL
  • Integrations: Vault, PlaceholderAPI, Essentials / SuperVanish / PremiumVanish
  • Performant: one shared scheduler, maths off the main thread, particle budgets

Requirements

Spigot or Paper 1.20.6 – 1.21.x, Java 21. Vault and PlaceholderAPI are optional.

Install

Drop Hanami-1.0.0.jar into plugins/ and restart. Kotlin and the database drivers are downloaded on first start.

Description from the author on Hangar

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.

Written by jeary-dev. Read it with pictures on Hangar.

How to install Hanami

  1. Make sure your server runs Paper and Spigot on Minecraft 1.20 – 1.21.

  2. Download the .jar file from Hangar and put it in the plugins folder of your server.

  3. Restart the server. Avoid /reload, many plugins do not handle it well.

  4. Type /plugins in the console: Hanami should be listed in green. Its config files are created in the plugins folder on the first start.

Full guide: How to install plugins on a Minecraft server

Compatibility

Minecraft versions
1.21, 1.20
Runs on
Paper, Spigot
Edition
Java
Needs
PlaceholderAPI, Essentials
License
MIT
Price
Free
Upkeep
Actively updated (Nov 17, 2026)

Hanami compared with similar ones Compare all alternatives

ResourceDownloadsRatingVersionsLast updatePrice
Hanamithe one you looked at0–1.20 – 1.212 hours agoFree
SuperTrailskvq143K4.71.8 – 1.13Dec 30, 2019Free
PlayerParticlesEsophose151K4.81.8 – 26.xSep 9, 2026Free
Ultra CosmeticsDatatags397K4.61.17 – 26.xJul 19, 2026Free

Questions

Does Hanami work on Minecraft 26.x?

Not yet. The newest version it supports is Minecraft 1.21.

Is Hanami free?

Yes. Hanami is free to download from Hangar.

Which server software does Hanami run on?

Hanami runs on Paper and Spigot servers.

Is Hanami server-side?

Yes. Hanami is a server plugin: it goes in the plugins folder of the server, not in the mods folder of a player's game.

Does Hanami need anything else?

Yes: PlaceholderAPI, Essentials. Install it before Hanami.

Is Hanami still updated?

Yes. The last update came out in the past day.

What are the best alternatives to Hanami?

The closest ones are SuperTrails, PlayerParticles and Ultra Cosmetics. Compare all alternatives

Alternatives to Hanami

Compare all alternatives ›

Reviews

–★★★★★
0 reviews
50
40
30
20
10

Log in to leave a review.