TKillFX ⚡ Cosmetic Kill Effects [Action Bar • Sounds • GUI]

✨ What is TKillFX?
TKillFX is an ultra-lightweight cosmetic kill effects plugin built natively for Spigot, Paper, and Purpur ( 1.21+). When a player eliminates an opponent in PvP, TKillFX plays an eye-catching, visual-only death effect at the victim's location accompanied by 3D directional audio and optional server broadcasts.

Grant effects per rank via LuckPerms to monetize your server without game-breaking pay-to-win advantages!

Key Highlights

• Action Bar Feedback with Mini Font: No chat clutter! Selecting an effect displays an action bar notification formatted in clean Unicode small caps.
• Premium Obsidian GUI: Sleek 27-slot menu with dark glass borders, atmospheric descriptions, rarity badges, and tactile audio feedback on clicks.
• Ultra-Lightweight (~86 KB): Clean, modular code with zero external libraries and zero bloat.
• 100% Safe & Visual-Only: Uses harmless lightning effects. Never creates fire, never damages entities, and never alters blocks.
• Built for High TPS: Strict particle clamping (≤120 particles), bounded animations (≤3s), and global sliding-window rate limiting.
• Atomic & Async Storage: Debounced asynchronous saving with atomic file replacement to eliminate server hitches.

[HR][/HR]

8 Handcrafted Effects

FREE TIER (Available to all players by default)

• ⚡ Spark — Fiery shower of blazing sparks with copper impact chime.
  Permission: tkillfx.effect.spark
• Blossom — Pastel cherry blossom petals with gentle floral break sounds.
  Permission: tkillfx.effect.blossom
• Soul — Ascending wailing spirits and ethereal soul fire.
  Permission: tkillfx.effect.soul

RANK TIER (Perfect for VIPs, Ranks & Donators)

• ️ Lightning — Harmless cosmetic lightning bolt with deep roaring thunder.
  Permission: tkillfx.effect.lightning
• Explosion — Dramatic fiery shockwave burst and smoke (zero block damage).
  Permission: tkillfx.effect.explosion
• Firework — Festive burst of colorful firework stars & crackle sounds.
  Permission: tkillfx.effect.firework
• Sonic — Deafening Warden sonic boom wave and shrieking resonance.
  Permission: tkillfx.effect.sonic
• Void — Ominous swirling ender portal vortex with teleport audio.
  Permission: tkillfx.effect.void

[HR][/HR]

Commands & Permissions
Aliases: /tkillfx, /kfx

• /killfx — Open the interactive cosmetic GUI. (tkillfx.use)
• /killfx list — List all effects and unlock status in chat. (tkillfx.use)
• /killfx set <effect> — Equip a cosmetic effect. (tkillfx.effect.<id>)
• /killfx off — Turn off your active kill effect. (tkillfx.use)
• /killfx preview <effect> — Preview an effect at your feet. (tkillfx.admin)
• /killfx set <player> <effect> — Set another player's effect. (tkillfx.admin)
• /killfx reload — Hot-reload config & messages. (tkillfx.admin)

Special Bypass Permissions:

• tkillfx.bypass.cooldown — Skip per-player effect cooldowns.
• tkillfx.bypass.effects — Suppress kill effects on death (great for staff).
• tkillfx.admin — Full administrative management access.

Installation

1. Download TKillFX-1.0.0.jar.
2. Drop it into your server's plugins/ folder.
3. Restart your server.
4. Customize plugins/TKillFX/config.yml and grant permissions with LuckPerms!