Dynamic Item Modifiers π
Dynamic item modifiers are powerful item editing functions that are able to edit an item's properties based on a player's own stats. They're used everywhere in the plugin and are responsible for making item scale with a player's skill and adding custom properties to items. Dynamic item modifiers may also be executed in a specific order, and can also be used to apply specific item conditions to recipes to limit which items may be used during crafting.
Other plugins may register their own Dynamic Item Modifiers, so some may be present that aren't in this list
Modifiers may be applied on individual held items using /val modify <modifier> <args> <player>
Modifiers
ID | Description | GUI Icon | GUI Category |
---|---|---|---|
| Sets the Mining Power of the item. For reference:
| Diamond Pickaxe |
|
| Sets the Mining Power of the item towards specific blocks | Wooden Pickaxe |
|
| Makes the item mine one type of block as if it was made out of another type of block | Golden Pickaxe |
|
| Adds a loot table to the item. - If the item is a container, the loot table will populate the container when placed and opened. - If the item is a block, the loot table will drop when the block is placed and broken. - If the item is just a regular item, it will be rewarded to the player when right-clicked. In this case an additional property may be added in which the player may choose which loot drops they want | Chest |
|
| Marks the item as a dummy helmet. When placed on an armor stand, it will be turned into a DPS testing dummy | Hay Bale |
|
| Makes the recipe in which it is used require and consume an amount of money to craft. Requires Vault installed | Golden Nugget |
|
| Makes the recipe in which it is used require and consume an amount of experience orbs to craft | Bottle 'o' Experience |
|
| Compares the | Clock |
|
| Compares the | Clock |
|
| Compares the | Clock |
|
| Increases or decreases the | Clock |
|
| Sets the | Clock |
|
| Adds the given smithing tags to the item. Smithing tags may be used for condition checks or to add lore flavor text to the item. Tags can have a level assigned, and if an item already has one of the given tags, its level is added to the given level | Paper |
|
| Requires the item to have all or some of the given tags, otherwise the recipe is cancelled | Paper |
|
| Requires the item to not have all or any of the given tags, otherwise the recipe is cancelled | Paper |
|
| Removes the given smithing tags from the item | Paper |
|
| Removes all smithing tags from the item | Paper |
|
| Randomly enchants an item given a level | Enchantment Table |
|
| Clears all enchantments from the item | Grindstone |
|
| Enchants an item with the given enchantment with a given level, potentially scaling with the player's Enchanting skill | Depends per enchantment |
|
| Increases or decreases the item's amount | Stick |
|
| Randomizes the item's amount | Stick |
|
| Scales the item's amount with the player's Smithing skill | Iron Ingot |
|
| Sets the item's amount | Stick |
|
| Sets the color of the item according to a decimal value. Only works on colorable items like leather armor or potions | Potion |
|
| Sets the color of the item according to RGB values. Only works on colorable items like leather armor or potions | Potion |
|
| Sets the item's custom model data | Painting |
|
| Sets a custom | Name Tag |
|
| Renames an item. Within the GUI this can only be configured by using another renamed item to copy its name over | Name Tag |
|
| Nullifies all sweeping damage the item can do. Does not remove the sweeping effects, though, I don't think I can do that | Diamond Sword |
|
| Randomly damages the item's durability | Wooden Pickaxe |
|
| Repairs the item by a set amount | Anvil |
|
| Repairs the item by a given fraction | Nether Star |
|
| Scales the item's max durability with one of the player's skills | Diamond |
|
| Sets the item's default max durability | Diamond |
|
| Sets the item's tagged equipment type, which overrides their hardcoded default value | Iron Pickaxe |
|
| Adds the given item flag to the item, see Flags. <flag> should be the flag IN LOWER CASE <<not like this | See Flags for icon |
|
| Replaces the item with another | Emerald |
|
| Replaces the item with another, but keeps the amount of the previous item | Lapis Lazuli |
|
| Changes the item's base type only | Slime Ball |
|
| Makes the item unbreakable | Diamond |
|
| Changes the weight class of the item, overriding its hardcoded default value. Affects the light/heavy weapons/armor skills | Anvil |
|
| Replaces the item with one of the registered items in | Enderchest |
|
| Adds the player's signature to the item's lore | Written Book |
|
| Sets the item's neutral smithing quality. See Smithing for more details | Nether Star |
|
| Adds smithing quality to the item, or combines it with previous quality values if present | Nether Star |
|
| Multiplies the existing smithing quality value of the item | Nether Star |
|
| Randomizes the existing smithing quality value to a given range off the existing value | Stick |
|
| Applies a smithing quality value to the item scaling with the player's smithing skill | Nether Star |
|
| Sets the item's smithing quality | Nether Star |
|
| Sets the item's tool ID, which can be used to have recipes require the presence or usage of that tool to craft | Iron Hoe |
|
| Changes the item's material to be that of netherite, and resets its default stats accordingly | Netherite Chestplate |
|
| Changes the item's material to be that of diamond, and resets its default stats accordingly | Diamond Chestplate |
|
| Changes the item's material to be that of iron, and resets its default stats accordingly | Iron Chestplate |
|
| Changes the item's material to be that of gold, and resets its default stats accordingly | Golden Chestplate |
|
| Changes the item's material to be that of chainmail, and resets its default stats accordingly | Chainmail Chestplate |
|
| Changes the item's material to be that of leather, and resets its default stats accordingly | Leather Tunic |
|
| Adds a skill level requirement to the item. If the level requirement is not met, the item's stats will be greatly diminished |
| |
| When applied on arrows, makes them antigravity | Feather |
|
| When applied on arrows, turns them into a dragon fireball when shot | Dragon's Breath |
|
| When applied on arrows, makes them explode on hit | TNT |
|
| When applied on arrows, makes them explode several times on hit | TNT Minecart |
|
| When applied on arrows, makes them remove immunity frames on hit | Wither Skeleton Skull |
|
| When applied on arrows, makes them light an area on fire on hit | Flint and Steel |
|
| When applied on arrows, turns them into a large fireball when shot | Fire Charge |
|
| When applied on arrows, makes them spawn lightning on hit | Ice |
|
| When applied on arrows, turns them into a small fireball when shot | Fire Charge |
|
| When applied on arrows, makes them teleport the shooter to the hit location | Ender Pearl |
|
| Adds the given alchemy tags to the item. Alchemy tags may be used for condition checks or to add lore flavor text to the item | Paper |
|
| Requires the item to have all or some of the given tags, otherwise the recipe is cancelled | Paper |
|
| Requires the item to not have all or any of the given tags, otherwise the recipe is cancelled | Paper |
|
| Removes the given alchemy tags from the item | Paper |
|
| Removes all alchemy tags from the item | Paper |
|
| Forbids a specific potion type from being used. Valid types are | Potion |
|
| Requires a specific potion type to be used. Valid types are | Potion |
|
| Sets the potion type of the potion | ||
| Converts the potion to Draught of Midas (See Alchemy) | Gold Block |
|
| Scales the amplifier(s) of the potion's potion effects according to player skill | Glowstone Dust |
|
| Scales the duration(s) of the potion's potion effects according to player skill | Redstone Dust |
|
| Converts the given potion effects found on the item into another potion effect | Fermented Spider Eye |
|
| Adds alchemy quality to the item, or combines it with previous quality values if present | Nether Star |
|
| Multiplies the existing alchemy quality value of the item | Nether Star |
|
| Randomizes the existing alchemy quality value to a given range off the existing value | Stick |
|
| Applies a alchemy quality value to the item scaling with the player's alchemy skill | Nether Star |
|
| Sets the item's alchemy quality | Nether Star |
|
| Converts milk to chocolate milk | Cocoa Beans |
|
| Rewards the player with an item | Chest |
|
| Rewards the player with an amount of money | Gold Nugget |
|
| Rewards the player with an amount of experience orbs | Bottle 'o' Experience |
|
| Rewards the player with an amount of skill experience. <skill> should be the name of the skill IN LOWER CASE <<not like this |
| |
| When applied to food, nullifies any potion effect it would normally give (e.g. Golden Apples, Rotten Flesh) | Milk Bucket |
|
| Changes the food class of the item, overriding its hardcoded value. See Foods | Paper |
|
| Changes how many hunger points eating this food will restore | Steak |
|
| Changes how many saturation points eating this food will restore | Golden Carrot |
|
| Adds a | Fishing Rod |
|
| Sets an | Diamond Chestplate |
|
| Sets the custom max durability of the item (I don't think this needs to exist because a duplicate exists but here we are lol) | Diamond |
|
| Removes any custom durability from the item | Coal |
|
Attributes
Each attribute adds the following modifiers. See Attributes for a list <attribute> should be the attribute IN LOWER CASE <<not like this
Each attribute also has its own icon associated, also listed on that link.
ID | Description |
---|---|
| Adds the given attribute as default stat to the item. |
| Removes the given attribute from the item |
| Scales the given attribute according to one of the player's skills. Default value remains unchanged, only the actualized stat changes |
Potion Effects
Each potion effect adds the following modifiers. See Potion Effects for a list <effect> should be the potion effect IN LOWER CASE <<not like this
Each potion effect also has its own icon associated, also listed on that link.
ID | Description |
---|---|
| Adds the given potion effect as default effect to the item |
| Permanent potion effects are effects that are repeatedly applied on the player, making them virtually permanent as long as the player possesses the item. Only registered for vanilla potion effects, as most custom potion effects have an attribute stat doing the same thing |