Item Flex Item Flex is a plugin that gives players the ability to showcase their held item with a modern holographic display. With over 60 configuration options, you're able to tailor the plugin to your server's needs!
Showcase
Features
/itemflex command to display your held item
Animated hologram made with display entities for zero lag
PlaceholderAPI & Hex Color Support
Works with items from plugins like Nexo and ItemsAdder
Fully customizable with over 60+ configuration options
Internal placeholders like %item_lore% and %item_enchants% for displaying complex item data
Built-in cooldown system for limiting spam
Default Configuration
Code (YAML):
Settings: # Configuration for plugin permissions and cooldowns. Permissions: # If true, permission nodes will be enforced across the plugin. # If false, only server operators (OPs) can use /itemflex reload, # and all players will be subject to cooldowns. Enabled: true
# Permission node required to use the /itemflex command. Use: "itemflex.use"
# Permission node that allows a player to bypass the usage cooldown. Bypass-Cooldown: "itemflex.cooldownbypass"
# Permission node required to execute /itemflex reload. Reload: "itemflex.reload"
# Cooldown duration between uses of the /itemflex command. # Supports flexible time formats, e.g.: # "1m" = 1 minute # "2h 30m" = 2 hours and 30 minutes Use-Cooldown: "1m"
# Maximum number of lore lines shown from the %item_lore% placeholder. # If the item has more lore lines than this value, the rest will be skipped. # Set to 0 to disable lore entirely. Lore-Line-Limit: 3
# Whether to skip empty lines when displaying %item_lore%. # A line is considered empty if it contains no visible characters, # including lines that only contain color codes or formatting. Ignore-Empty-Lore-Lines: true
# Vertical spacing between each hologram line. # This controls how far apart the lines appear above the item. Line-Spacing: 0.17
# Text lines displayed above the item hologram. # Supports PlaceholderAPI placeholders, and internal such as # %item_name% — The display name of the held item. # %item_lore% — Each line of the item's lore (one hologram line per lore line). # # ⚠️ NOTE: %item_lore% can produce many lines if the item has a long lore. # You can limit this by adjusting the Lore-Line-Limit setting. Lines: -
"&6&lFLEXING" -
"%item_name%"
# The format of each enchantment line when %item_enchants% is used. Enchant-Format: "&6%enchantment_name% &f%enchantment_level%" Spawn-Location: # Distance from the player's **eye location** where the hologram spawns. Distance: 1.5
# Offset added to the base spawn location. # Useful for raising or shifting the hologram position. Offset:
X: 0
Y: 1.5
Z: 0
# Offset specifically for the item inside the hologram. # Should usually match the above offset for best alignment. Item-Offset:
X: 0
Y: -0.17
Z: 0
# How the item is displayed (e.g. NONE, FIXED, GUI). # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/ItemDisplay.ItemDisplayTransform.html Display-Transform: GUI
# Scale of displayed items (if the item is NOT a block). Item-Display-Scale: 0.75
# Scale of displayed items (if the item IS a block). Block-Display-Scale: 0.5
# How the hologram text faces the viewer. # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Display.Billboard.html Billboard-Type: "VERTICAL"
# Background color and opacity of the hologram text. # All values are 0–255. Use Opacity: 0 for no background. Background-Color:
Opacity: 0
Red: 0
Green: 0
Blue: 0
# Brightness of the text lines in the hologram. # 0–15, where 15 is the brightest. Brightness:
Block: 15
Sky: 15
# If true, text lines will render with a shadow for better readability and visual depth. Text-Shadow: true
# Particle effect played when the animation starts. Spawn-Particle: # Type of particle. # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html Particle: "GLOW" Count: 20
Offset:
X: 0.1
Y: 0.2
Z: 0.1
Speed: 0.01
# Sound played when the animation starts. Spawn-Sound: # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html Sound: "ENTITY_EVOKER_CAST_SPELL" Volume: 1.2
Pitch: 1.5
# Controls the scale animation (in and out). Scale-Settings: # Initial scale of the item. Starting-Scale: 0.01
# Amount the item scales up/down per tick. Scale-Increment: 0.06
# Speed of item rotation (in degrees per tick). Rotate-Speed: 7
# Duration of the animation, in ticks (20 ticks = 1 second). Animation-Duration: 80
# Particle effect played when the animation ends. Disappear-Particle:
Particle: "FIREWORK" Count: 15
Offset:
X: 0.2
Y: 0.2
Z: 0.2
Speed: 0.05
# Sound played when the animation ends. Disappear-Sound:
Sound: "BLOCK_AMETHYST_BLOCK_BREAK" Volume: 0.8
Pitch: 1.7
# Ambient particles shown during the animation. Ambient-Particle: # How often (in ticks) to spawn particles. Frequency: 10
Particle: "ENCHANT" Count: 3
Offset:
X: 0.1
Y: 0.1
Z: 0.1
Speed: 0
# Ambient sound played during the animation. Ambient-Sound: # How often (in ticks) to play this sound. Frequency: 20
Sound: "BLOCK_BEACON_AMBIENT" Volume: 0.3
Pitch: 1.2
# All plugin messages can be customized below. # Supports PlaceholderAPI placeholders and Minecraft hex colors (e.g. #A020F0). Messages: # Shown when a player lacks the required permission. No-Permission: "#FF5555You do not have permission to use this."
# Shown when the player runs /itemflex without holding an item. Must-Hold-Item: "#FFA500You must be holding an item to flex it!"
# Shown when the player runs /itemflex while already flexing an item. Flex-Active: "#FFA500You already have an item flex active!"
# Shown when the player tries to flex while on cooldown. # Placeholders: # %time% — Displays the remaining cooldown duration. Cooldown-Active: "#FFD700You're still on cooldown! Please wait #FF5555%time%#FFD700 before flexing again."
# Shown when a non-player (e.g. console) tries to execute a player-only command. Player-Only: "#FF4444This command can only be used by players."
# Shown when the plugin configuration is successfully reloaded. Config-Reloaded: "#55FF55✔ Configuration reloaded successfully."