KillEffects

Version: 1.0 | Supported API: Paper 1.21.x | Author: GoldApic

Take your server's combat to the next level! KillEffects is a highly optimized, strictly cosmetic PaperMC plugin that rewards players with jaw-dropping, animated sequences whenever they secure a kill. Whether you are running a hardcore faction server, a minigame network, or a friendly SMP, these effects will make every victory unforgettable.

✨ Features

• 100% Safe & Cosmetic: None of the effect entities have AI that targets players, they cannot deal damage, and they cannot be killed for loot. All terrain modifications (like Emerald or Sculk blocks spawning) are perfectly calculated to only replace solid blocks and revert seamlessly after 5 seconds without destroying stairs, slabs, or custom builds.
• Interactive MiniMessage GUI: Gorgeous, gradient-colored menus where players can equip their owned effects or preview locked ones.
• Zero Memory Leaks: Built-in failsafes guarantee that all entities are instantly removed when an effect ends or if the server restarts.
• Highly Configurable: Every single effect’s duration and sound radius can be tweaked in the config. Don't want to use a permissions/economy system? Just toggle all-effects-default to true to give everyone access instantly!

---

🎇 Effects

Currently features 7 unique, high-quality animations:

1. Warden Curse: A Warden dramatically emerges from the ground enveloped in a soul-fire circle, roaring before fading back to the depths.
2. Ancient Curse: The death location is instantly corrupted by Sculk Catalysts and soul particles, accompanied by terrifying shrieker sounds.
3. Zombie Horde: A circle of 5 Golden-Sword-wielding Zombies surrounds the death point, staring inward before crumbling to dust.
4. Piglin Party: Two Piglins spawn and perform the official Minecraft "Hog Hunt" celebration dance while the Pigstep music disc blasts for nearby players!
5. Emerald: The ground transforms into deepslate emerald ore and solid emerald blocks while a shower of emerald items rains down with lightning strikes.
6. Cloud: The area freezes over into Snow and Powdered Snow blocks, releasing a massive burst of wind and white cloud particles.
7. Dragon Breath: An Ender Dragon fireball drops from the sky, exploding into a massive (but completely harmless) fuchsia Dragon Breath area effect cloud!

---

📜 Commands

Command	Description	Permission
/k gui	Opens the menu to equip owned Kill Effects.	Default
/k preview	Opens a menu to preview any effect before buying/unlocking.	Default
/k give <player> <effect>	Grants a player permanent access to a specific effect.	killeffects.admin
/k remove <player> <effect>	Removes a player's access to a specific effect.	killeffects.admin
/k reload	Hot-reloads the config.yml and player data safely.	killeffects.admin

(Note: You can also use /killeffects or /ke as command aliases!)

---

⚙️ Config

The plugin is incredibly easy to set up. Here is the default configuration file generated on first startup:

#   _  ___ _ _ ______  __  __          _       
#  | |/ (_) | |  ____|/ _|/ _|        | |      
#  | ' / _| | | |__  | |_| |_ ___  ___| |_ ___ 
#  |  < | | | |  __| |  _|  _/ _ \/ __| __/ __|
#  | . \| | | | |____| | | ||  __/ (__| |_\__ \
#  |_|\_\_|_|_|______|_| |_| \___|\___|\__|___|
#
# >>> KillEffects Configuration
# >>> Proudly developed by GoldApic

messages:
  prefix: "<gray>[<gradient:#ff0000:#aa0000>KillEffects</gradient>] </gray>"
  no_permission: "<red>You do not have permission to do this!</red>"
  equipped: "<green>Successfully equipped <effect>!</green>"
  not_owned: "<red>You don't own any kill effect! Buy them on our Discord or use /k preview</red>"

# Global settings
global:
  default-duration: 5
  default-sound-radius: 50.0
  # If true, all players will have access to all kill effects by default.
  all-effects-default: false

# Customize individual effects here
# Duration is in SECONDS. Sound radius is in BLOCKS.
effects:
  WARDEN_CURSE:
    duration: 5
    sound-radius: 50.0
  ANCIENT_CURSE:
    duration: 5
    sound-radius: 50.0
  ZOMBIE_HORDE:
    duration: 5
    sound-radius: 50.0
  PIGLIN_PARTY:
    duration: 5
    sound-radius: 50.0
  EMERALD:
    duration: 5
    sound-radius: 50.0
  CLOUD:
    duration: 5
    sound-radius: 50.0
  DRAGON_BREATH:
    duration: 5
    sound-radius: 50.0