VitalVials

VitalVials is a unique Minecraft plugin for Spigot/Paper (1.21.x) that introduces a new gameplay mechanic where players can purchase and manage in-game effects using their health.

This creates a balanced risk–reward system: players must carefully decide whether the cost of powerful effects is worth sacrificing their vitality. Perfect for RPG, survival, and custom server experiences.

✨ Features

Health-Based Economy: Trade your max health or health points for powerful effects.
Fully Configurable: Customize effects, costs, cooldowns, refunds, and activations.
Dynamic Scoreboard: Real-time tracking of active effects and durations.
Player Customization: Each player can toggle or edit their scoreboard.
Cooldown System: Prevents effect spamming.
Refund System: Configurable refund percentages for purchased effects.

📥 Installation

Download the latest VitalVials.jar from the Files tab.
Place it into your server’s plugins/ folder.
Restart your server to generate config files.
Configure settings in config.yml, effects.yml, and activation.yml.
Use /vv reload to apply changes without restarting.

🔧 Commands

/vv — Main command
/vv reload — Reload configuration
/vv shop — Open the effect shop
/vv buyEffect <effect> — Buy an effect directly
/vv viewStatus — Show active effects
/vv scoreboard <on/off/editShort> — Toggle or customize scoreboard
/vv refundEffect <effect> — Refund an effect
/vv removeData <player/allPlayer> — Remove player data

🛡️ Permissions

Permission	Description	Default
`vv.admin`	Full access to all commands	op
`vv.reload`	Reload the plugin	op
`vv.shop`	Access the effect shop	op
`vv.buyEffect`	Buy effects	op
`vv.viewstatus`	View own effect status	op
`vv.scoreboard`	Scoreboard customization	op
`vv.refundEffect`	Refund purchased effects	op
`vv.removedata`	Remove player data	op

⚙️ Configuration

config.yml → General plugin settings.
effects.yml → Define all effects, costs, refunds, cooldowns, levels.
activation.yml → Control how and when effects are activated (e.g., right-click, combat triggers).

Highly customizable for any server type.

📌 Support

For bug reports or suggestions, open an Issue on GitHub.

📜 License

This project is licensed under the MIT License.

Crafted by b4n9z 🛠️