AetherPotions - Lightweight Custom Potions icon

AetherPotions - Lightweight Custom Potions -----

Lightweight, easy to use custom potion plugin.




hey small update yay. No new features really, even some removals.
  • Added a small API. You can use PotionManager class to quickly give someone a potion, or listen to players who drinks/got splashed with custom potion with custom events.
    • Not finished documenting, but i will do the guide in AetherPotions gitbook wiki.
  • Removed original effects. Come on, i literally give you so much power with commands, you can just do /effect give. Besides, you are going to change the name and lore, so 0 use in cosmetic side. Configuration is becoming unnecessarily complex with it is another good reason.
  • Small technical optimizations.
I am aware that /aetherpotions info gives too much info and validation method is so outdated. Will try to update potion validation first, then the info thing should come with GUI update.
----------, Aug 25, 2024

fastest in the west

BETA BUILD
Beta version can contain some issues/bugs within the system. So if you do not need this/wait for stable update, do not update. And for old users, PLEASE BACKUP. Now onto the update:
  • Added delay option into commands. You can get more information about that in our gitbook wiki.
----------, Aug 4, 2024

hey long time no see

BETA BUILD
This build has so much structural change that it can contain some issues/bugs within the system. So if you do not need this/wait for stable update, do not update & use migrate command, it will literally break :D And for old users, PLEASE BACKUP. Now onto the update:

AetherPotions 4.0
  • Advanced Command System
    • Ordered Commands
    • Executors
    • Chance System
    • Weight System
  • Tab Completion
  • Wiki
  • Instant Drinking
  • Migration Command from 3.2 to 4.0+
Advanced Command System
How you use commands in AetherPotions is completely changed. Now, you can do order the commands, set the executor and even do chance and weight based commands!

Tab Completion
Yeah pretty obvious. I should have done this sooner but hey, better late than never.

Wiki
I have created a gitbook wiki (probably replace later with self hosted ones) for you to understand everything. look bro it was not that complicated before but even i am getting confused with the features what have i done

Instant Drinking Feature
Now you can use drinkable potions in an instant, without waiting to consume the potion. You can change that in configuration

Migration Feature
This version completely breaks all AetherPotions configurations. That is why i have added a special migrate command in plugin.
/aetherpotions migrate <potionid/all>
----------, Jul 31, 2024

Hi there. Now you can use custom model data and player placeholders with PlaceholderAPI.
Example config with usage of new features.
Code (YAML):
  # Drinkable potion example
  # potion id. Needs to be unique.
  drink
:
    # You can use placeholders in display name and lore.
    displayName
: "&cDrink - %player_name%"
    lore
:
     - "&5Drink potion attempt"
    # Will potion be splash or drinkable?
    isSplash
: false
    # If it is drinkable, will it delete the bottle?
    deleteBottle
: true
    # Cooldown in seconds.
    cooldown
: 10
    data
:
      # Custom model data. You can use this for custom textures.
      customModelData
: 1
      # Potion type. Things like Speed, Strength etc...
      # Do not put prefixes like STRONG, LONG etc. Just put the plain old potion type and configure level/time below.
      # List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionType.html
      potionType
: "STRENGTH"
      # This option is needed if you need to apply original potion effect.
      # For example if potion type is strength, strength effect will be applied with the commands.
      originalEffect
: false
      # If you want to extend the potion time same as brewing, you can use this option.
      extended
: false
      # If you want to upgrade the potion same as brewing (Level 2), you can use this option.
      upgraded
: false
    particle
:
      # Particle system.
      # List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
      enabled
: false
      type
: ""
      # Time in seconds.
      time
: 200
      # Particle amount per second. You have to try and test this setting.
      amount
: 20
    commands
:
      # If it is splash, you can remove this line.
      drinkingCommands
:
       - "msg %player% ae"
      # If it is drinkable, you can remove this line.
      splashCommands
:
       - ""
      afterEffect
:
        # After Effect feature.
        enabled
: true
        # Time in seconds.
        time
: 5
        commands
:
         - "give %player% diamond 5"
----------, Jul 12, 2024

Hello again! I do not know how no one really tried to use cooldowns for a year. I had the implementation, but there was no way to actually set the cooldown with the configs. I do not know which side should I be surprised, you or me LMAO

PlaceholderAPI Implementation
Now you can get the remaining cooldown of an potion for the person. I do not know if you need more than this, but if you do need, please let me know.
%aetherseeds_cooldown_potionid%: Gets the cooldown in seconds for specific potion on for whoever player that executes the placeholder.

Cooldowns
Still a mystery to me how i forgot this. Anyways, newer versions should add a new line the messages.yml file once you start the server with updated version.
messages.yml:
Code (YAML):
StillInCooldown : "You are still in cooldown! Remaining seconds: %time%"
You can add cooldown by directly adding cooldown line below deleteBottle.
Example:
Code (YAML):
potions :
  # Drinkable potion example
  # potion id. Needs to be unique.
  drink
:
    displayName
: "&cDrink"
    lore
:
     - "&5Drink potion attempt"
    # Will potion be splash or drinkable?
    isSplash
: false
    # If it is drinkable, will it delete the bottle?
    deleteBottle
: true
    # Cooldown in seconds.
    cooldown
: 10
    data
:
      # Potion type. Things like Speed, Strength etc...
      # Do not put prefixes like STRONG, LONG etc. Just put the plain old potion type and configure level/time below.
      # List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionType.html
      potionType
: "STRENGTH"
      # This option is needed if you need to apply original potion effect.
      # For example if potion type is strength, strength effect will be applied with the commands.
      originalEffect
: false
      # If you want to extend the potion time same as brewing, you can use this option.
      extended
: false
      # If you want to upgrade the potion same as brewing (Level 2), you can use this option.
      upgraded
: false
    particle
:
      # Particle system.
      # List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
      enabled
: false
      type
: ""
      # Time in seconds.
      time
: 200
      # Particle amount per second. You have to try and test this setting.
      amount
: 20
    commands
:
      # If it is splash, you can remove this line.
      drinkingCommands
:
       - "msg %player% ae"
      # If it is drinkable, you can remove this line.
      splashCommands
:
       - ""
      afterEffect
:
        # After Effect feature.
        enabled
: true
        # Time in seconds.
        time
: 5
        commands
:
         - "give %player% diamond 5"
The version is still unknown if it supports 1.21 fully (i could not test), so use it carefully if you use it on 1.21. Thank you.
----------, Jun 16, 2024

Hello there, its been idk how many years .d
Some little changes in the code base, can be seen in the repo.
  • Added Persistent Data Container from 1.20 and upwards. 1.19 and downwards will still use the old implementation.
  • Due to some requests, I started the foundation of protection hooks, only worldguard for now. Later, we will probably implement more protection hooks to prevent them from throwing etc..
Thats all, it took a year to do this but i didn't have enough idea for improving the plugin. So if you have any idea please share lol.
----------, Jun 4, 2024

Hello, long time no update lol. Now you can use hex values and give players original effect of the potion they used.

Hex Values
  • You can use hex values in configuration like this:
    Code (YAML):
    Prefix : "&#55FFFFAetherPotions > &7"

Original Potion Effects
  • This ones hard to quite confusing but let me give example. You are making a custom exp command potion using speed potion as color. Now you can give player the speed effect without extra commands along with custom ones.
Example configuration:
Code (YAML):
data :
      # Potion type. Things like Speed, Strength etc...
      # Do not put prefixes like STRONG, LONG etc. Just put the plain old potion type and configure level/time below.
      # List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionType.html
      potionType
: "STRENGTH"
      # This option is needed if you need to apply original potion effect.
      # For example if potion type is strength, strength effect will be applied with the commands.
      originalEffect
: true
      # If you want to extend the potion time same as brewing, you can use this option.
      extended
: true
      # If you want to upgrade the potion same as brewing (Level 2), you can use this option.
      upgraded
: true
----------, Nov 25, 2023

Long awaited update is here. AetherPotions plugin has been completely overwritten and open sourced. The config is completely overhauled and easy to understand.
Key Features​
  • Splash potions! You can now use splash potions in "potion-throw" flag enabled areas!
  • Separate cooldowns! Now you can different specify a cooldown per potion.
  • Potion Troubleshooting! You can use /ap info <potionid> [detailed(true/false)] command to quickly troubleshoot what went wrong/missing with the configuration. You can use /ap list to determine which potions are broken(red color) or valid(green color).
New plugin is tested on small environments and probably not %100 bug free. So if you encounter any issues, please contact here with this link. Thank you all.
----------, Jun 28, 2023

Heyy, its me again. Long waited (for a few months lmfao) player executed command update is finally arrived!
  • To take advantage of player-executed, add [PLAYER] prefix to command. Example: "[PLAYER] me I used powerup potion!".
----------, Mar 29, 2021

Hi, me again. AetherPotions now supports commands after effect!
Unfortunately, you have to copy paste the section. If you don't need it, you don't have to. -it won't be enabled.-

Complete example:
Code (YAML):
Potions:
  powerup
:
    name
: '&7Power Up Potion'
    lore
:
     - '&7Drinking this gives &b50 EXP and Haste&7.'
    type
: SPEED
    delete-bottle-after-drink
: true
    particle
:
      enabled
: true
      # 1.8: https://helpch.at/docs/1.8/org/bukkit/Effect.html
      # 1.9+: https://helpch.at/docs/1.12.2/org/bukkit/Particle.html
      type
: END_ROD
      time
: 10
      amount
: 10
    commands-on-drink
: #When drank
      - 'msg %player% You feel extremely powerful.'
      - 'msg %player% Gained 50 EXP.'
      - 'effect %player% minecraft:haste 20 0'
    after-effect
: #Make commands for after effect.
      enabled
: true
      #Type = second.
      time
: 20
      commands
:
       - 'msg %player% Effect has been removed.'
----------, Jan 27, 2021

Hi, me again yay. I've completely recoded the entire thing. Now we are open to suggestions. And, we can update more frequently now.

Warning: You have to delete/replace the old files because new files are completely different. You can then replace one by one.
----------, Dec 10, 2020

Resource Information
Author:
----------
Total Downloads: 1,742
First Release: Aug 18, 2020
Last Update: Aug 25, 2024
Category: ---------------
All-Time Rating:
9 ratings
Find more info at kardasland.gitbook.io...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings