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

1. Download the latest VitalVials.jar from the Files tab.
2. Place it into your server’s plugins/ folder.
3. Restart your server to generate config files.
4. Configure settings in config.yml, effects.yml, and activation.yml.
5. 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

⚙️ 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 🛠️