---

🌟 Why TKillFX?

Most kill effect plugins are bloated with outdated code, heavy dependencies, or risk damaging the world. TKillFX is engineered from scratch for modern Minecraft (1.21+):

• 🛡️ 100% Cosmetic & World-Safe:
  • Uses strikeLightningEffect — visual-only lightning that never deals damage, starts fires, or destroys blocks.
  • Particle explosions only — no TNT entities, no griefing, no knockback.
  • Zero persistent entities and zero chunk loading.
• 📦 Ultralight (~6 KB Jar): Contains no bloated libraries, no shaded dependencies, and no NMS hacks.
• 💎 Built for Ranks & Monetization: Easily grant free effects to all players and reserve premium effects for VIP ranks using LuckPerms.
• ⚡ Anti-Lag Engine: Features a global effects-per-second rate limiter, per-player cooldowns, and hard-capped particle budgets to protect server TPS.

---

💥 8 Handcrafted Effects

Effect ID	Tier	Default Access	Visual Details	Sound FX
spark	FREE	Everyone	Electric sparks, enchanted hits, and end-rod glints	lightning_bolt.impact
blossom	FREE	Everyone	Cherry blossom petals, hearts, and soft sparkles	cherry_leaves.break
soul	FREE	Everyone	Rising soul flames and escaping soul particles	soul_escape
lightning	RANK	VIP / OP	Dramatic visual lightning bolt + spark burst (No fire/damage)	lightning_bolt.thunder
explosion	RANK	VIP / OP	High-velocity particle explosion and smoke puff (No TNT)	generic.explode
firework	RANK	VIP / OP	Multi-particle rocket burst and star glitter	firework_rocket.blast
sonic	RANK	VIP / OP	Expanding Warden sonic boom shockwave and sculk flairs	warden.sonic_boom
void	RANK	VIP / OP	Dimensional end portal collapse and vortex particles	enderman.teleport

---

🖥️ Intuitive 27-Slot GUI

Players simply run /killfx to view and equip effects in a sleek inventory interface:

• Equipped Indicator: Shows ▶ Selected on currently active effect.
• Permission Gated: Shows Locked with the required permission node if gui.show-locked is enabled.
• One-Click Disable: Quick barrier slot to turn off effects at any time.

---

🎮 Commands & Aliases

Aliases: /tkillfx, /kfx

Command	Permission	Default	Description
/killfx	tkillfx.use	Everyone	Opens the personal effect selection GUI
/killfx list	tkillfx.use	Everyone	Lists all effects and your permission status
/killfx set <effect>	tkillfx.use	Everyone	Selects a specific kill effect
/killfx off	tkillfx.use	Everyone	Disables your active kill effect
/killfx preview <effect>	tkillfx.admin	OP	Plays an effect locally for testing (no broadcast)
/killfx set <player> <effect>	tkillfx.admin	OP	Sets another online player's effect
/killfx reload	tkillfx.admin	OP	Hot-reloads configuration and messages

---

🔑 Permissions

Permission Node	Default	Description
tkillfx.use	Everyone	Allows opening GUI and selecting accessible effects
tkillfx.effect.spark	Everyone	Access to Spark effect (Free)
tkillfx.effect.blossom	Everyone	Access to Blossom effect (Free)
tkillfx.effect.soul	Everyone	Access to Soul effect (Free)
tkillfx.effect.lightning	OP	Access to Lightning effect (VIP)
tkillfx.effect.explosion	OP	Access to Explosion effect (VIP)
tkillfx.effect.firework	OP	Access to Firework effect (VIP)
tkillfx.effect.sonic	OP	Access to Sonic effect (VIP)
tkillfx.effect.void	OP	Access to Void effect (VIP)
tkillfx.bypass.cooldown	OP	Bypasses the kill effect cooldown timer
tkillfx.bypass.effects	OP	Suppresses effects & broadcasts when this player dies
tkillfx.admin	OP	Full access to reload, preview, and set others

---

⚙️ Configuration (config.yml)

Fully customizable death triggers, anti-lag limits, world filters, and broadcast formatting:

# Fallback when selected effect is disabled or permission revoked
default-effect: spark

trigger:
  mode: KILLER        # Options: KILLER, VICTIM, or BOTH
  pvp-only: true      # Only trigger on player vs player kills
  ignore-✨: true
  ignore-npcs: true   # Skip Citizens / NPC deaths

worlds:
  mode: BLACKLIST     # Options: BLACKLIST or WHITELIST
  list: []

cooldown:
  seconds: 5          # Per-player cooldown (0 to disable)

performance:
  max-effects-per-second: 15
  max-particles-per-effect: 120

broadcast:
  enabled: true
  radius: -1          # -1 for server-wide; or block radius around death
  format: "&8[&c⚡&8] &e{killer} &7destroyed &c{victim} &7with &6{effect}&7!"