zArmorEffect

zArmorEffect — Hidden Armor Effects & Custom Effect Books
Custom Armor Potion Effects System for Minecraft

Give armor special abilities without visible potion particles or effect icons.

Overview
zArmorEffect is a Minecraft plugin that allows server administrators to add hidden vanilla potion effects to armor pieces. Effects remain active while the armor is equipped and are automatically refreshed and removed when the relevant armor is no longer worn. The plugin supports custom effect levels from I to X, optional full-armor-set requirements, and special Effect Books that let players apply configured effects to armor through an in-game interaction. With customizable messages, hexadecimal color support, configurable update intervals, and persistent item metadata, zArmorEffect provides a straightforward way to create custom armor abilities for survival, PvP, and SMP servers.

Features

• Add vanilla potion effects to armor pieces
• Hidden effects with no potion particles or effect icons
• Effects activate while the armor is equipped
• Automatically remove plugin-managed effects when they no longer apply
• Custom effect levels from Roman numeral I to X
• Optional full-armor-set requirement
• Special Effect Books for applying effects to armor
• Apply Effect Books by holding armor in the main hand and the book in the off-hand, then right-clicking
• Supports helmets, chestplates, leggings, boots, and turtle helmets
• Store effect data directly in item metadata using PersistentDataContainer
• Multiple different effects can be attached to the same armor piece
• Prevent duplicate instances of the same effect type on one item
• Remove individual effects from armor
• List available vanilla potion effect types
• Configurable effect update interval
• Customizable plugin prefix and messages
• Supports legacy Minecraft color codes and hexadecimal colors
• Tab completion for subcommands, effect names, Roman numeral levels, and full-set options
• Configurable configuration reload command
• Permission-based access control
• Cleans up effects granted by the plugin when it shuts down
• Folia support declared in plugin metadata

Commands

Player Commands

Command | Description | Permission
/armoreffect list | Lists available Minecraft potion effects | zarmoreffect.use

Aliases

Command | Description
/ae | Alias for /armoreffect
/zae | Alias for /armoreffect
/zarmoreffect | Alias for /armoreffect

Admin Commands

Command | Description | Permission
/armoreffect add <effect> <level> [fullset] | Adds an effect to the armor or item in your main hand | zarmoreffect.admin
/armoreffect remove <effect> | Removes an effect from the item in your main hand | zarmoreffect.admin
/armoreffect givebook <effect> <level> [fullset] | Gives a special Effect Book | zarmoreffect.admin
/armoreffect reload | Reloads the plugin configuration | zarmoreffect.admin

Permissions

Permission | Description | Default
zarmoreffect.* | Grants access to all zArmorEffect features through its child permissions | OP
zarmoreffect.use | Allows listing available potion effects | true
zarmoreffect.admin | Allows adding and removing effects, creating Effect Books, and reloading the configuration | OP

Effect System

• Available Effects: Uses vanilla Minecraft potion effect types.
• Effect Levels: Supports Roman numerals I–X.
• Full Set Mode: Optionally requires a helmet, chestplate, leggings, and boots to be equipped before an effect activates.
• Hidden Effects: Effects are applied without particles or effect icons and are not displayed in the item's lore.
• Effect Books: Special enchanted books contain effect information in persistent item metadata.
• Duplicate Prevention: The same effect type cannot be added twice to a single item.
• Automatic Updates: Effects refresh according to the configured update interval, which defaults to 20 ticks (1 second).
• Automatic Removal: The plugin removes previously applied effects when they no longer qualify under its armor-effect tracking.

Author

Developer: TalhaPlaysOG
Discord: talhaplays.og