# VitalVials Plugin<\/p>\n
VitalVials is a unique Minecraft plugin that allows players to purchase and manage in-game effects using their health. With a fully customizable configuration, server owners can create a balanced between risk and reward, where players must carefully consider the cost of powerful effects against their own vitality.<\/p>\n
## Features<\/p>\n
– **Health-Based Economy**: Players trade their max health \/ health points for powerful effects
\n– **Fully Configurable**: Customize every aspect of effects, costs, and mechanics
\n– **Dynamic Scoreboard**: Real-time tracking of active effects and remaining duration
\n– **Player-Specific Settings**: Each player can customize their scoreboard
\n– **Cooldown System**: Prevent effect spamming with configurable cooldowns
\n– **Refund System**: Option to refund effects (configurable per effect)<\/p>\n
## Installation<\/p>\n
1. Download the latest version of VitalVials from the releases page
\n2. Place the `VitalVials.jar` file in your server’s `plugins\/` directory
\n3. Restart your server
\n4. Configure the plugin to your liking in `plugins\/VitalVials\/config.yml` and `plugins\/VitalVials\/effects.yml` and `plugins\/VitalVials\/activation.yml`
\n5. Use `\/vv reload` to apply changes without restarting<\/p>\n
## Commands<\/p>\n
### Main Command
\n– `\/vv` or `\/vitalvials` – Main command for VitalVials<\/p>\n
### Subcommands ## Permissions<\/p>\n | Permission | Description | Default | ## Configuration<\/p>\n VitalVials is highly configurable through the `config.yml`, `effects.yml` and `activation.yml` file. Here are the main sections:<\/p>\n ### Main Configuration<\/p>\n The configuration file (config.yml) allows you to customize several aspects of the plugin:<\/p>\n “`yaml ### Effect Configuration ### Activation Configuration ## Effect Customization<\/p>\n Effects are defined in the `effects.yml` of the plugin folder. Example:<\/p>\n The configuration file (effects.yml) allows you to customize all effects in the plugin:<\/p>\n “`yaml ## Activation Customization<\/p>\n You can customize activation of effects in the plugin by editing the `activation.yml` file.<\/p>\n The configuration file (activation.yml) allows you to customize activation of effects in the plugin:<\/p>\n “`yaml ## Scoreboard<\/p>\n The scoreboard can be toggled with `\/vv scoreboard` and customized with these options: ## Support<\/p>\n For support, please open an issue on GitHub.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License – see the LICENSE file for details.<\/p>\n —<\/p>\n Crafted by b4n9z<\/p>\n","protected":false},"excerpt":{"rendered":" A simple plugin that allows you to buy effect using your health.<\/p>\n","protected":false},"featured_media":167174,"template":"","meta":{"_minecraft_slug":"vitalvials","_minecraft_project_id":"TYvJp17D","_minecraft_author":"b4n9z","_minecraft_license":"MIT","_minecraft_downloads":33,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vitalvials.zip","_minecraft_size_bytes":107470,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:59:42.186927Z","_minecraft_date_created":"2025-10-01T03:55:40.678183Z","_minecraft_date_modified":"2025-09-30T12:14:53.013204Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vitalvials","_minecraft_icon_attachment_id":167174,"_minecraft_imported_at":"2026-06-09T18:48:45+00:00","_minecraft_import_hash":"d6caa77f8091d85783c369d4a7c95687","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,122,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,73,74,38,78,79,80],"class_list":["post-167173","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n
\n– `\/vv reload` – Reload the plugin configuration
\n– `\/vv shop` – Opens the effect shop
\n– `\/vv buyEffect
\n– `\/vv viewStatus` – View your current active effects
\n– `\/vv scoreboard
\n– `\/vv refundEffect
\n– `\/vv removeData
\n|——————-|————————————|———|
\n| `vv.admin` | Full access to all commands | op |
\n| `vv.reload` | Allows reloading the plugin | op |
\n| `vv.shop` | Access to the effect shop | op |
\n| `vv.buyEffect` | Allows buying effects | op |
\n| `vv.viewstatus` | View own effect status | op |
\n| `vv.scoreboard` | Access to scoreboard customization | op |
\n| `vv.refundEffect` | Refund purchased effects | op |
\n| `vv.removedata` | Remove player data | op |<\/p>\nClick to expand<\/summary>\n
\neffects: effects.yml # Path to the effects.yml file that contains the effects list
\nactivation: activation.yml # Activation settings
\nmaxHP: # max HP
\n enabled: true # Enable \/ Disable max HP, when enabled players can’t get more HP when trying to Refund Effect, so player can’t get more HP that you set
\n value: 20 # Max HP (Health Points)
\nminHP: 2 # Min HP (Health Points) to allow player not buying effect when HP is same or less than this
\nscoreboard: # scoreboard settings
\n defaultShowScoreboard: true # Show scoreboard on right side by default (per player can disable it on their own using command if you give them access)
\n periodUpdate: 10 # period to update scoreboard (in seconds)
\npermissionsAllPlayer:
\n reload: false # Allow reload command for all players
\n shop: true # Allow shop command for all players
\n buyEffect: true # Allow buyEffect command for all players
\n viewStatus: true # Allow viewStatus command for all players
\n scoreboard: true # Allow scoreboard command for all players
\n refundEffect: true # Allow refundEffect command for all players
\n removeData: false # Allow removeData command for all players
\n“`
\n<\/details>\n
\nEach effect can be configured with the following options:
\n– `enabled`: Enable\/disable the effect
\n– `name`: The name of the effect in shop
\n– `effect`: The name of the effect to give (default), don’t change if you don’t know what it is
\n– `lore`: The lore of the effect in shop
\n– `maxLevel`: The max level\/amplifier of the effect
\n– `particles`: Whether particles will be shown when getting the effect
\n– `saveEffectData`: Whether the effect data will be saved to the player data
\n– `priceType`: The type of price when buying the effect (MAX_HEALTH to buy using MAX HEALTH player or HEALTH to buy using HEALTH player)
\n– `refundPercentage`: The percentage of the HP refundable (calculate from level 1 effect) after buying the effect (-1 to disable refund)
\n– `autoActivate`: Whether the effect will be auto activated after buying, if false you need set it in activation config
\nArray section (`[
\n– `durationPerUpgrade`: Duration in seconds per upgrade, -1 for infinite (in seconds)
\n– `cooldownPerUpgrade`: Cooldown per upgrade (in seconds)
\n– `costPerUpgrade`: Health cost to activate per upgrade (Health Points)<\/p>\n
\nEach item can be configured with the following options:
\n– `rightClick`: Effects to activate to your own on right click with the item you configure
\n– `leftClick`: Effects to activate to your own on left click with the item you configure
\n– `YouAreHittingEnemy`: Effects to activate to your enemy when you are hitting an enemy with the item you configure
\n– `enemyHitYou`: Effects to activate to your enemy when an enemy hits you with the item you configure<\/p>\nClick to expand<\/summary>\n
\nspeed: #key of the effect section, you can change it to anything you want, you can also use same effect to another key with different activation config
\n enabled: true # enable\/disable the effect
\n name: “\u00a7bSpeed” # The name of the effect
\n effect: “SPEED” # Name of the effect to give (default), don’t change if you don’t know what it is
\n lore: “Get more speed” # lore of the effect (Informational only)
\n maxLevel: 2 # max amplifier\/level when upgrading the effect
\n particles: false # enable\/disable particles when getting effect
\n saveEffectData: true # save effect data to the player data (If \u201cfalse\u201d, the effect can only be activated when \u201cautoActivate\u201d is true and can only be used once and player can’t upgrade it)
\n priceType: MAX_HEALTH # the type of price when buying the effect (MAX_HEALTH to buy using MAX HEALTH player or HEALTH to buy using HEALTH player)
\n refundPercentage: 50 # the percentage of the HP refundable (calculate from level 1 effect) after buying the effect (-1 to disable refund)
\n autoActivate: true # auto activate the effect, if true effect will be auto activated after buying
\n # if false you need set it in activation config
\n #=====[array section]=====
\n # [
\n durationPerUpgrade: [-1, -1] # duration of the effect per upgrade, -1 for infinite (in seconds)
\n cooldownPerUpgrade: [0, 0] # cooldown when using the effect per upgrade (in seconds)
\n costPerUpgrade: [10, 18] # cost when buying the effect per upgrade (Health Points)
\n“`
\n<\/details>\nClick to expand<\/summary>\n
\nALL_ITEMS: # Effects to activate to your own with all items or no item
\n rightClick: [] # Effects to activate to your own on right click with all items or no item
\n leftClick: [] # Effects to activate to your own on left click with all items or no item
\n YouAreHittingEnemy: [] # Effects to activate when you are hitting an enemy with all items or no item
\n enemyHitYou: [poison, wither, darkness] # Effects to activate when an enemy hits you with all items or no item
\nSWORD: # Item name (all type of swords)
\n rightClick: [resistance] # Effects to activate to your own on right click with the item
\n leftClick: [] # Effects to activate to your own on left click with the item
\n YouAreHittingEnemy: [nausea, weakness, weaving, oozing, infested] # Effects to activate when you are hitting an enemy with the item
\n enemyHitYou: [slowness, mining_fatigue] # Effects to activate when an enemy hits you with the item
\n“`
\n<\/details>\n
\n– Toggle visibility
\n– Change display order of effects<\/p>\n