VitalVials icon

VitalVials -----

A simple plugin that allows you to buy effect using your health.



✦VitalVials Plugin✦

A unique health-based economy plugin that lets players trade their own vitality for powerful effects!
1.21 - 1.21.7


◆ Features
  • Health-Based Economy: Trade max health or HP for powerful effects.
  • Fully Configurable: Customize every aspect of effects, costs, and mechanics.
  • Dynamic Scoreboard: Real-time tracking of active effects and remaining duration.
  • Player-Specific Settings: Each player can customize their scoreboard.
  • Cooldown System: Prevent effect spamming with configurable cooldowns.
  • Refund System: Refund effects with adjustable percentages.


◆ Installation
  1. Download the latest version from the Releases Page.
  2. Place VitalVials.jar into your server’s plugins/ folder.
  3. Restart your server.
  4. Configure the plugin in config.yml, effects.yml, and activation.yml.
  5. Use /vv reload to apply changes without restarting.


◆ Commands
  • /vv or /vitalvials – Main command
  • /vv reload – Reload the plugin configuration
  • /vv shop – Opens the effect shop
  • /vv buyEffect <effect> – Buy an effect directly
  • /vv viewStatus – View your current active effects
  • /vv scoreboard <on/off/editShort> – Toggle or customize your 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 Allows reloading the plugin op
vv.shop Access to the effect shop op
vv.buyEffect Allows buying effects op
vv.viewstatus View own effect status op
vv.scoreboard Access to scoreboard customization op
vv.refundEffect Refund purchased effects op
vv.removedata Remove player data op



◆ Configuration
VitalVials is highly configurable through config.yml, effects.yml, and activation.yml.

Code (YAML):
effects : effects.yml # Path to the effects.yml file that contains the effects list
activation
: activation.yml # Activation settings
maxHP
: # max HP
  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
  value
: 20 # Max HP (Health Points)
minHP
: 2 # Min HP (Health Points) to allow player not buying effect when HP is same or less than this
scoreboard
: # scoreboard settings
  defaultShowScoreboard
: true # Show scoreboard on right side by default (per player can disable it on their own using command if you give them access)
  periodUpdate
: 10 # period to update scoreboard (in seconds)
permissionsAllPlayer
:
  reload
: false # Allow reload command for all players
  shop
: true # Allow shop command for all players
  buyEffect
: true # Allow buyEffect command for all players
  viewStatus
: true # Allow viewStatus command for all players
  scoreboard
: true # Allow scoreboard command for all players
  refundEffect
: true # Allow refundEffect command for all players
  removeData
: false # Allow removeData command for all players

Code (YAML):
speed : #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
  enabled
: true # enable/disable the effect
  name
: "§bSpeed" # The name of the effect
  effect
: "SPEED" # Name of the effect to give (default), don't change if you don't know what it is
  lore
: "Get more speed" # lore of the effect (Informational only)
  maxLevel
: 2 # max amplifier/level when upgrading the effect
  particles
: false # enable/disable particles when getting effect
  saveEffectData
: true # save effect data to the player data (If “false”, the effect can only be activated when “autoActivate” is true and can only be used once and player can't upgrade it)
  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)
  refundPercentage
: 50 # the percentage of the HP refundable (calculate from level 1 effect) after buying the effect (-1 to disable refund)
  autoActivate
: true # auto activate the effect, if true effect will be auto activated after buying
  # if false you need set it in activation config
  #=====[array section]=====
  # [<first upgrade level>, <second upgrade level>, ...]
  durationPerUpgrade
: [-1, -1 ] # duration of the effect per upgrade, -1 for infinite (in seconds)
  cooldownPerUpgrade
: [0, 0 ] # cooldown when using the effect per upgrade (in seconds)
  costPerUpgrade
: [10, 18 ] # cost when buying the effect per upgrade (Health Points)

Code (YAML):
ALL_ITEMS : # Effects to activate to your own with all items or no item
  rightClick
: [ ] # Effects to activate to your own on right click with all items or no item
  leftClick
: [ ] # Effects to activate to your own on left click with all items or no item
  YouAreHittingEnemy
: [ ] # Effects to activate when you are hitting an enemy with all items or no item
  enemyHitYou
: [poison, wither, darkness ] # Effects to activate when an enemy hits you with all items or no item
SWORD
: # Item name (all type of swords)
  rightClick
: [resistance ] # Effects to activate to your own on right click with the item
  leftClick
: [ ] # Effects to activate to your own on left click with the item
  YouAreHittingEnemy
: [nausea, weakness, weaving, oozing, infested ] # Effects to activate when you are hitting an enemy with the item
  enemyHitYou
: [slowness, mining_fatigue ] # Effects to activate when an enemy hits you with the item


◆ Scoreboard
  • Toggle visibility
  • Change effect order
  • Update in real time


◆ Support
For support, please use GitHub Issues.


◆ License
This project is licensed under the MIT License.

Crafted by b4n9z
Resource Information
Author:
----------
Total Downloads: 17
First Release: Sep 30, 2025
Last Update: Sep 30, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings