Denizen Script Mechanisms


Mechanisms are found in object properties, the 'adjust' command, and similar. These are used to change the state of an object.
Learn about how mechanisms work in The Beginner's Guide.


Showing 1 out of 625 mechanisms...
Namepotion_effects
ObjectItemTag
InputListTag
Related Tags<ItemTag.effects_data> Returns a list of all potion effects on this item, in the same format as the MapTag input to the mechanism. (...)
<server.potion_types> Returns a list of all potion types known to the server. (...)
<server.potion_effect_types> Returns a list of all potion effects known to the server. (...)
DescriptionSets the item's potion effect(s).
This applies to Potion items, Tipped Arrow items, and Suspicious Stews.

For potions or tipped arrows (not suspicious stew), the first item in the list must be a MapTag with keys:
"base_type" - from 🔗https://minecraft.wiki/w/Potion#Item_data

For example: [base_type=strong_swiftness]
This example produces an item labeled as "Potion of Swiftness - Speed II (1:30)"

Each following item in the list are potion effects, which must be a MapTag with keys:
"type" - from 🔗https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
"amplifier" - number to increase the level by (0 for default level 1) (optional, default 0)
"duration" - DurationTag, how long it lasts (optional, default 0s)
"ambient", "particles", "icon" - booleans (optional, default true, true, false)

For example: [type=SPEED;amplifier=2;duration=10s;ambient=false;particles=true;icon=true]
This example would be a level 3 swiftness potion that lasts 10 seconds.

A very short full default potion item would be: potion[potion_effects=[base_type=regeneration]
A (relatively) short full potion item would be: potion[potion_effects=<list[[base_type=regeneration]|[type=speed;duration=10s]]>]
(Note the list constructor to force data format interpretation, as potion formats can be given multiple ways and the system will get confused without a constructor)
Sourcehttps://github.com/DenizenScript/Denizen/blob/dev/plugin/src/main/java/com/denizenscript/denizen/objects/properties/item/ItemPotion.java#L232