ChronoBan

🕒 ChronoBan — Cinematic Bans

ChronoBan redefines how bans look and feel on your Minecraft server. Instead of an instant kick, players experience a 6-second cinematic “time collapse” sequence — levitation, particle storms, sound effects, and a dramatic explosion that marks their ban in style.

This plugin is designed for 1.21+ and built with full customization, performance, and visual impact in mind.

---

⚡ Features

• 🎬 Cinematic Ban Sequence — levitates the target and surrounds them with energy before an explosive finale.
• 💥 Configurable Explosion Radius & Sounds — nearby players hear the blast.
• ✨ Particle Effects — customizable rings, beams, and explosions with multiple particle types.
• 🔊 Custom Sounds — every stage has its own sound configuration.
• ✨ Full Message Formatting — supports MiniMessage, legacy & colors, and hex codes like &#00C3FF.
• 💬 Broadcasts & Auras — global ban announcements, executor aura, and kick messages.
• ⚙️ Highly Configurable — all visuals, timings, and messages are editable from config.yml and messages.yml.
• 🧩 Lightweight and Paper-Optimized — clean async-safe code with minimal resource footprint.

---

🪄 Configuration Highlights

sequence:
  duration_ticks: 120
  levitation_amplifier: 1

sounds:
  start: ENTITY_ENDER_DRAGON_GROWL
  final_explosion:
    type: ENTITY_GENERIC_EXPLODE
    radius: 30.0
particles:
  ring_particle: ENCHANTMENT_TABLE
  beam_particle: SOUL_FIRE_FLAME
  final_explosion:
    - { type: BLOCK_CRUMBLE, count: 80, extra: 0.2 }

Every message supports:

{prefix}, {target}, {executor}, {reason}

and can be styled with MiniMessage tags, legacy & colors, and hex gradients.

---

🎥 Demonstration Video

Experience ChronoBan in action: ▶ Watch the showcase on YouTube

---

📦 Installation

1. Drop the ChronoBan-x.x.x.jar into your server’s plugins folder.
2. Start the server once to generate the config files.
3. Customize your config.yml and messages.yml for your desired theme.
4. Use /chronoban <player> [reason...] to test your cinematic ban!

---

🧠 Notes

• Works on Paper 1.21+ and forks (Purpur, Pufferfish, etc.).
• Requires no dependencies.
• Designed and developed by FeelSorrow.