Potion Perks | 1.8-1.14 [Inactive]
1.2.2Buy and upgrade all 30 potion effects! Includes permissions, durations and cooldowns!
READ BEFORE DOWNLOADING
The latest version of this plugin (1.2.2) is only required for Spigot 1.14 and has NOT been tested on any other versions! If you experience issues using 1.2.2 on anything other than Spigot 1.14, downgrade to 1.2.1!
Potion Perks allows players to buy and upgrade up to 30 different potion effects or 'perks'. Once bought, the effects can be enabled and disabled at any time.
Potion Perks also comes with a lot of customisation options, so you'll be able to configure the following:
- Which effects are available to buy
- How many times each effect can be upgraded
- How much each upgrade costs
- The colour and name of each effect
- Permissions to buy each effect
- The duration each effect will last after being enabled
- The cooldown until the effect can be used again after being disabled
- The look of the GUI

Effects and Colors
Potion Perks supports several versions of Minecraft, meaning that some effects and colours will only work on newer versions of Minecraft. In the spoilers are lists showing which options are available for which versions of Minecraft.
* = Available in Potion Perks 1.2+
Effects
All Supported Versions
- Absorption
- Blindness
- Nausea
- Resistance
- Haste
- Fire Resistance
- Health Boost
- Hunger
- Strength
- Invisibility
- Jump Boost
- Night Vision
- Poison
- Regeneration
- Saturation
- Slowness
- Mining Fatigue
- Speed
- Water Breathing
- Weakness
- Wither
1.9+
- Glowing
- Levitation
- Luck
- Bad Luck
1.13+
- Conduit Power
- Dolphin's Grace
- Slow Falling
1.14
- Bad Omen
- Hero of the Village
Colors
All Supported Versions
- aqua
- black
- fuchsia
- gray
- green
- maroon
- navy
- orange
- silver
- teal
- default *
1.11+
- blue
- lime
- olive
- purple
- red
- white
- yellow
- RGB *
Commands
- /potionperks or /perks - Open your GUI
- /tokens - See how many tokens you have ( Potion Perks 1.2+ )
- /givetokens - Give an online player tokens ( Potion Perks 1.2+ )
- /potionperksreload - Reload files, not recommended if a lot of people are online
Permissions
- potionperks.admin - Access to /potionperksreload
Dependencies
As of Potion Perks 1.2, these plugins are not required and only allow you to buy effects and upgrades using an economy plugin
- Vault
- Vault compatible economy plugin
Installation
1) Download PotionPerks.jar
2) Place the download in your server's plugins folder
3) Reload or restart the server
Configuration
perks.yml
ABSORPTION:
enabled: true
name: Absorption
color: aqua
levels:
- '100'
- '200'
permission: potionsperks.absorption
duration: 60
cooldown: 15Above is an example configuration for the Absorption effect. Every effect will generate something similar by default.
The name in capital letters at the top is the effect's ID, which the files use to find the effect. Do not change this.
Required
'enabled' sets whether or not players will be able to buy this effect. By default effects are only enabled if they are positive and available in 1.8.
'name' sets the display name of the effect. By default they are set to their in game names but they can be changed. You can also add colours using '&' but if you do you'll need to add ' at the start and end of the name.
'color' sets the color of the potion that will appear in the GUI for this effect. To use an RGB color, use 3 integers separated by spaces (e.g. 0 0 0). Do not use RGB colors if you don't know what they are.
'levels' sets how much each upgrade costs. The first will be to buy level 1, the second will be to buy level 2 etc. Make sure you put ' either side of the each number. Each effect has a maximum of 4 levels and any extra levels will be ignored.
Optional
'permission' will be the permission required to buy the effect.
'duration' will be the time, in seconds, a player will have the effect after enabling it.
'cooldown' will be the time, in seconds, a player will have to wait to enable an effect again after disabling it.
config.yml
version: 1.2
options:
allow-potions: false
allow-milk: false
gui:
title: '&bPotion Perks'
upgrade: '&7Left click to upgrade for &e$%cost%&7!'
maximum: '&7This perk is at max level!'
not-purchased: '&7You don''t have this perk.'
enabled: '&7This perk is &aenabled&7, right click to &cdisable&7.'
disabled: '&7This perk is &cdisabled&7, right click to &aenable&7.'
not-permitted: '&cYou are not permitted to buy this perk.'
chat:
expired: '&c%perk% has expired.'
ready: '&a%perk% is now available.'
cooldown: '&cThis perk will be ready in %time% seconds.'
color:
fallback: aqua
symbol:
money: $
token: TAbove is the default configuration. Make sure to keep the ' at the start and end of each line and you can use colour codes using '&' (excluding color and symbol section).
Version
This will be used to update the config automatically should it change. Do not change this manually.
Options
'allow-potions' will toggle whether or not players are able to drink potions.
'allow-milk' will toggle whether or not players are able to drink milk. Drinking milk removes all potion effects.
GUI
'title' will be the title of the GUI.
'upgrade' will be displayed on an effect when there is an upgrade available. '%cost%' will be replaced in this option with the cost of the next upgrade.
'maximum' will be displayed on an effect when there are no more upgrades available.
'not-purchased' will be displayed on an effect when a player hasn't purchased the effect.
'enabled' will be displayed when a player has purchased an effect and it is enabled.
'disabled' will be displayed when a player has purchased an effect and it is disabled.
'not-permitted' will be displayed when a player doesn't have permission to buy a perk but it is enabled.
Chat
'expired' will show in chat when an effect's duration ends.
'ready' will show in chat when an effect's cooldown ends.
'cooldown' will show in chat when a player tries to enable an effect that is on cooldown. '%time%' will be replaced by the time, in seconds, until the cooldown ends.
Color
'fallback' will be the color used if an effect's color is default but there is no default color.
Symbol
'money' will be used if a player buys an effect or upgrade using an economy plugin.
'token' will be used if a player buygs an effect of upgrade using tokens, the plugin's built in currency.
Reporting Issues
If you're having issues with the plugin please either message me here or using discord, andy#9667. Please do NOT use the reviews section as a space to report issues.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta