VitalVials

I am excited to announce the first public release of VitalVials, a unique Minecraft plugin for Spigot/Paper servers (1.21.x).

VitalVials introduces a new gameplay mechanic where players can trade their health for powerful effects, creating a balanced risk–reward system. With full customization options, server owners can fine-tune costs, mechanics, and player experiences to fit their server’s style.

✨ Features

• Health-Based Economy: Players exchange their max health or health points for powerful effects.
• Fully Configurable: Customize every aspect of effects, costs, cooldowns, and mechanics via config.yml, effects.yml, and activation.yml.
• Dynamic Scoreboard: Real-time tracking of active effects and durations, customizable per player.
• Player-Specific Settings: Players can toggle and personalize their scoreboard.
• Cooldown System: Prevents effect spamming with per-effect cooldowns.
• Refund System: Refund effects with configurable percentages for added balance.

🛠 Installation

1. Download the VitalVials.jar from this release.
2. Place it into your server’s plugins/ folder.
3. Restart the server to generate configuration files.
4. Adjust settings in config.yml, effects.yml, and activation.yml.
5. Use /vv reload to apply changes without restarting.

📜 Commands

• /vv → Main command.
• /vv reload → Reloads configurations.
• /vv shop → Opens the effect shop.
• /vv buyEffect <effect> → Buy an effect directly.
• /vv viewStatus → Shows active effects.
• /vv scoreboard <on/off/editShort> → Toggle or customize the scoreboard.
• /vv refundEffect <effect> → Refund an effect.
• /vv removeData <player/allPlayer> → Clear player data.

🔑 Permissions

• vv.admin → Full access.
• vv.reload, vv.shop, vv.buyEffect, vv.viewstatus, vv.scoreboard, vv.refundEffect, vv.removedata.

📌 Notes

• Tested with Minecraft 1.21.x on Bukkit/Spigot/Paper.
• Highly configurable — see README and configs for details.
• Licensed under the MIT License.

This is the first official release of VitalVials — feedback, issues, and contributions are welcome! 🚀