SoulBurstFX

✨ What is SoulBurstFX?

SoulburstFX turns every kill into a visual spectacle: When a player defeats another player or mob, stunning particle effects appear at the exact death location. These effects are fully customizable, unlockable, and stylishly animated — from flames and explosions to flowers and spirals.

🎮 Features

• ✅ Toggle kill effects on/off per player
• ✅ Wide selection of particle effects (flame, explosion, heart, angry villager, …)
• ✅ Style effects like "circle", "spiral", "flower", "helix" and more
• ✅ Unlock & lock system for effects and styles
• ✅ Effects appear precisely at the enemy's death point
• ✅ JSON-based storage: settings persist across server restarts
• ✅ Simple commands with tab-completion and permission control

🛠 Commands & permissions

1. /killeffect on - Enables kill effects (killeffect.use)
2. /killeffect off - Disables kill effects (killeffect.use)
3. /killeffect effect - Sets the particle effect (killeffect.use)
4. /killeffect list [page] - Lists all available effects (killeffect.use)
5. /killeffect style <name|on|off> - Configures style effects (killeffect.style.use)
6. /killeffect styles - Lists all available styles (killeffect.style.use)
7. /killeffect unlock <effect|style> <name|all> - Unlocks effects or styles (killeffect.unlock)
8. /killeffect unlock player <effect|style> <name|all> - Unlocks for another player (killeffect.unlock)
9. /killeffect lock <effect|style> <name|all> - Locks effects or styles (killeffect.lock)
10. /killeffect lock player <effect|style> <name|all> - Locks for another player (killeffect.lock)
11. /killeffect reload - Reloads kill effect data from JSON (killeffect.reload)
12. /killeffect help - Shows help menu (killeffect.use)

⚙️ Configuration & storage

Java (persistent – permanently stored)

All player settings are automatically stored in plugins/SoulburstFX/soulburstfx_playerdata.json. Format (JSON structure): { "player-uuid": { "enabled": true/false, "effectType": "effectname", "style": "style", "styleEnabled": true/false, "unlockedEffects": [ "effectnames/" ], "unlockedStyles": [ "styles/" ] } [...] }

The file is loaded at startup and saved when changed/stopped.

📸 Showcase

📂 Installation

1. Download SoulBurstFX--.jar.
2. Place it in your server's plugins folder.
3. Restart the server.

📜 Terms of Use – SoulBurstFX

✅ You may

• Use SoulBurstFX free of charge on private and public servers.
• Modify or extend the code as long as the credits remain intact.
• Include the plugin in server packs if "wolfwriter" is named as the author.

❌ You may not

• Sell SoulBurstFX or distribute it for money.
• Pretend to be the author of the plugin.
• Upload manipulated versions as "official."

⚠️ Disclaimer

• SoulBurstFX is provided without warranty.
• Use at your own risk.
• No liability for data loss or server problems.

ℹ️ License

License: GNU General Public License version 3 (GPLv3)

💬 Support & Contact

Do you have questions, feedback, or want to report bugs? Join my Discord and chat directly with the author: 👉 Join Discord server: https://discord.gg/TJgzq9aCxN